2 Copyright (C) 2003 Paul Davis
4 This program is free software; you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation; either version 2 of the License, or
7 (at your option) any later version.
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License
15 along with this program; if not, write to the Free Software
16 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
21 #ifndef __gtk_ardour_time_axis_view_item_h__
22 #define __gtk_ardour_time_axis_view_item_h__
24 #include <sigc++/signal.h>
25 #include <libgnomecanvas/libgnomecanvas.h>
26 #include <jack/jack.h>
29 #include "selectable.h"
34 * A base class for 'items' that may appear upon a TimeAxisView
37 class TimeAxisViewItem : public sigc::trackable, public Selectable
40 virtual ~TimeAxisViewItem() ;
43 * Set the position of this item upon the timeline to the specified value
45 * @param pos the new position
46 * @param src the identity of the object that initiated the change
47 * @return true if the position change was a success, false otherwise
49 virtual bool set_position(jack_nframes_t pos, void* src, double* delta = 0) ;
52 * Return the position of this item upon the timeline
54 * @return the position of this item
56 jack_nframes_t get_position() const ;
59 * Sets the duration of this item
61 * @param dur the new duration of this item
62 * @param src the identity of the object that initiated the change
63 * @return true if the duration change was succesful, false otherwise
65 virtual bool set_duration(jack_nframes_t dur, void* src) ;
68 * Returns the duration of this item
71 jack_nframes_t get_duration() const ;
74 * Sets the maximum duration that this item make have.
76 * @param dur the new maximum duration
77 * @param src the identity of the object that initiated the change
79 virtual void set_max_duration(jack_nframes_t dur, void* src) ;
82 * Returns the maxmimum duration that this item may be set to
84 * @return the maximum duration that this item may be set to
86 jack_nframes_t get_max_duration() const ;
89 * Sets the minimu duration that this item may be set to
91 * @param the minimum duration that this item may be set to
92 * @param src the identity of the object that initiated the change
94 virtual void set_min_duration(jack_nframes_t dur, void* src) ;
97 * Returns the minimum duration that this item mey be set to
99 * @return the nimum duration that this item mey be set to
101 jack_nframes_t get_min_duration() const ;
104 * Sets whether the position of this Item is locked to its current position
105 * Locked items cannot be moved until the item is unlocked again.
107 * @param yn set to true to lock this item to its current position
108 * @param src the identity of the object that initiated the change
110 virtual void set_position_locked(bool yn, void* src) ;
113 * Returns whether this item is locked to its current position
115 * @return true if this item is locked to its current posotion
118 bool get_position_locked() const ;
121 * Sets whether the Maximum Duration constraint is active and should be enforced
123 * @param active set true to enforce the max duration constraint
124 * @param src the identity of the object that initiated the change
126 void set_max_duration_active(bool active, void* src) ;
129 * Returns whether the Maximum Duration constraint is active and should be enforced
131 * @return true if the maximum duration constraint is active, false otherwise
133 bool get_max_duration_active() const ;
136 * Sets whether the Minimum Duration constraint is active and should be enforced
138 * @param active set true to enforce the min duration constraint
139 * @param src the identity of the object that initiated the change
141 void set_min_duration_active(bool active, void* src) ;
144 * Returns whether the Maximum Duration constraint is active and should be enforced
146 * @return true if the maximum duration constraint is active, false otherwise
148 bool get_min_duration_active() const ;
151 * Set the name/Id of this item.
153 * @param new_name the new name of this item
154 * @param src the identity of the object that initiated the change
156 void set_item_name(std::string new_name, void* src) ;
159 * Returns the name/id of this item
161 * @return the name/id of this item
163 virtual std::string get_item_name() const ;
166 * Set to true to indicate that this item is currently selected
168 * @param yn true if this item is currently selected
169 * @param src the identity of the object that initiated the change
171 virtual void set_selected(bool yn, void* src) ;
174 * Set to true to indicate that this item should show its selection status
176 * @param yn true if this item should show its selected status
178 virtual void set_should_show_selection (bool yn) ;
181 * Returns whether this item is currently selected.
183 * @return true if this item is currently selected, false otherwise
185 bool get_selected() const ;
187 //---------------------------------------------------------------------------------------//
188 // Parent Component Methods
191 * Returns the TimeAxisView that this item is upon
193 * @return the timeAxisView that this item is placed upon
195 TimeAxisView& get_time_axis_view() ;
197 //---------------------------------------------------------------------------------------//
201 * Sets the displayed item text
202 * This item is the visual text name displayed on the canvas item, this can be different to the name of the item
204 * @param new_name the new name text to display
206 void set_name_text(std::string new_name) ;
209 * Set the height of this item
211 * @param h the new height
213 virtual void set_height(double h) ;
218 void set_color(GdkColor& color) ;
223 GnomeCanvasItem* get_canvas_frame() ;
228 GnomeCanvasItem* get_canvas_group();
233 GnomeCanvasItem* get_name_highlight();
238 GnomeCanvasItem* get_name_text();
241 * Sets the samples per unit of this item.
242 * this item is used to determine the relative visual size and position of this item
243 * based upon its duration and start value.
245 * @param spu the new samples per unit value
247 virtual void set_samples_per_unit(double spu) ;
250 * Returns the current samples per unit of this item
252 * @return the samples per unit of this item
254 double get_samples_per_unit() ;
256 virtual void raise () { return; }
257 virtual void raise_to_top () { return; }
258 virtual void lower () { return; }
259 virtual void lower_to_bottom () { return; }
262 * returns true if the name area should respond to events.
264 bool name_active() const { return name_connected; }
266 // Default sizes, font and spacing
267 static std::string NAME_FONT ;
268 static const double NAME_X_OFFSET ;
269 static const double NAME_Y_OFFSET ;
270 static const double NAME_HIGHLIGHT_SIZE ;
271 static const double NAME_HIGHLIGHT_THRESH ;
272 static const double GRAB_HANDLE_LENGTH ;
275 * Handles the Removal of this time axis item
276 * This _needs_ to be called to alert others of the removal properly, ie where the source
277 * of the removal came from.
279 * XXX Although im not too happy about this method of doing things, I cant think of a cleaner method
280 * just now to capture the source of the removal
282 * @param src the identity of the object that initiated the change
284 virtual void remove_this_item(void* src) ;
287 * Emitted when this Group has been removed
288 * This is different to the GoingAway signal in that this signal
289 * is emitted during the deletion of this Time Axis, and not during
290 * the destructor, this allows us to capture the source of the deletion
293 sigc::signal<void,std::string,void*> ItemRemoved ;
295 /** Emitted when the name/Id of this item is changed */
296 sigc::signal<void,std::string,std::string,void*> NameChanged ;
298 /** Emiited when the position of this item changes */
299 sigc::signal<void,jack_nframes_t,void*> PositionChanged ;
301 /** Emitted when the position lock of this item is changed */
302 sigc::signal<void,bool,void*> PositionLockChanged ;
304 /** Emitted when the duration of this item changes */
305 sigc::signal<void,jack_nframes_t,void*> DurationChanged ;
307 /** Emitted when the maximum item duration is changed */
308 sigc::signal<void,jack_nframes_t,void*> MaxDurationChanged ;
310 /** Emitted when the mionimum item duration is changed */
311 sigc::signal<void,jack_nframes_t,void*> MinDurationChanged ;
313 /** Emitted when the selected status of this item changes */
314 sigc::signal<void, bool> Selected ;
321 ShowNameHighlight = 0x2,
327 * Constructs a new TimeAxisViewItem.
329 * @param it_name the unique name/Id of this item
330 * @param parent the parent canvas group
331 * @param tv the TimeAxisView we are going to be added to
332 * @param spu samples per unit
334 * @param start the start point of this item
335 * @param duration the duration of this item
337 TimeAxisViewItem(std::string it_name, GnomeCanvasGroup* parent, TimeAxisView& tv, double spu, GdkColor& base_color,
338 jack_nframes_t start, jack_nframes_t duration, Visibility v = Visibility (0));
341 * Calculates some contrasting color for displaying various parts of this item, based upon the base color
343 * @param color the base color of the item
345 virtual void compute_colors(GdkColor& color) ;
348 * convenience method to set the various canvas item colors
350 virtual void set_colors() ;
353 * Sets the frame color depending on whether this item is selected
355 void set_frame_color() ;
358 * Sets the colors of the start and end trim handle depending on object state
361 void set_trim_handle_colors() ;
363 virtual void reset_width_dependent_items (double pixel_width);
364 void reset_name_width (double pixel_width);
367 * Callback used to remove this item during the gtk idle loop
368 * This is used to avoid deleting the obejct while inside the remove_this_group
371 * @param item the time axis item to remove
372 * @param src the identity of the object that initiated the change
374 static gint idle_remove_this_item(TimeAxisViewItem* item, void* src) ;
376 /** The time axis that this item is upon */
377 TimeAxisView& trackview ;
379 /** indicates whether this item is locked to its current position */
380 bool position_locked ;
382 /** The posotion of this item on the timeline */
383 jack_nframes_t frame_position ;
385 /** the duration of this item upon the timeline */
386 jack_nframes_t item_duration ;
388 /** the maximum duration that we allow this item to take */
389 jack_nframes_t max_item_duration ;
391 /** the minimu duration that we allow this item to take */
392 jack_nframes_t min_item_duration ;
394 /** indicates whether this Max Duration constraint is active */
395 bool max_duration_active ;
397 /** indicates whether this Min Duration constraint is active */
398 bool min_duration_active ;
400 /** the curretn samples per canvas unit */
401 double samples_per_unit ;
403 /** indicates if this item is currently selected */
406 /** should the item show its selected status */
407 bool should_show_selection;
410 * The unique item name of this Item
411 * Each item upon a time axis must have a unique id
413 std::string item_name ;
416 * true if the name should respond to events
421 * true if a small vestigial rect should be shown when the item gets very narrow
426 uint32_t fill_opacity;
427 uint32_t fill_color ;
428 uint32_t frame_color_r ;
429 uint32_t frame_color_g ;
430 uint32_t frame_color_b ;
431 uint32_t selected_frame_color_r ;
432 uint32_t selected_frame_color_g ;
433 uint32_t selected_frame_color_b ;
434 uint32_t label_color ;
436 uint32_t handle_color_r ;
437 uint32_t handle_color_g ;
438 uint32_t handle_color_b ;
439 uint32_t lock_handle_color_r ;
440 uint32_t lock_handle_color_g ;
441 uint32_t lock_handle_color_b ;
443 GnomeCanvasItem* group ; /* the group */
444 GnomeCanvasItem* vestigial_frame ; /* simplerect */
445 GnomeCanvasItem* frame ; /* simplerect */
446 GnomeCanvasItem* name_text ; /* text */
447 GnomeCanvasItem* name_highlight ; /* simplerect */
448 GnomeCanvasItem* frame_handle_start ; /* simplerect */
449 GnomeCanvasItem* frame_handle_end ; /* simplerect */
451 }; /* class TimeAxisViewItem */
453 #endif /* __gtk_ardour_time_axis_view_item_h__ */