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 <jack/jack.h>
27 #include <libgnomecanvasmm/text.h>
29 #include "selectable.h"
30 #include "simplerect.h"
36 * A base class for 'items' that may appear upon a TimeAxisView
39 class TimeAxisViewItem : public Selectable
42 virtual ~TimeAxisViewItem() ;
45 * Set the position of this item upon the timeline to the specified value
47 * @param pos the new position
48 * @param src the identity of the object that initiated the change
49 * @return true if the position change was a success, false otherwise
51 virtual bool set_position(nframes_t pos, void* src, double* delta = 0) ;
54 * Return the position of this item upon the timeline
56 * @return the position of this item
58 nframes_t get_position() const ;
61 * Sets the duration of this item
63 * @param dur the new duration of this item
64 * @param src the identity of the object that initiated the change
65 * @return true if the duration change was succesful, false otherwise
67 virtual bool set_duration(nframes_t dur, void* src) ;
70 * Returns the duration of this item
73 nframes_t get_duration() const ;
76 * Sets the maximum duration that this item make have.
78 * @param dur the new maximum duration
79 * @param src the identity of the object that initiated the change
81 virtual void set_max_duration(nframes_t dur, void* src) ;
84 * Returns the maxmimum duration that this item may be set to
86 * @return the maximum duration that this item may be set to
88 nframes_t get_max_duration() const ;
91 * Sets the minimu duration that this item may be set to
93 * @param the minimum duration that this item may be set to
94 * @param src the identity of the object that initiated the change
96 virtual void set_min_duration(nframes_t dur, void* src) ;
99 * Returns the minimum duration that this item mey be set to
101 * @return the nimum duration that this item mey be set to
103 nframes_t get_min_duration() const ;
106 * Sets whether the position of this Item is locked to its current position
107 * Locked items cannot be moved until the item is unlocked again.
109 * @param yn set to true to lock this item to its current position
110 * @param src the identity of the object that initiated the change
112 virtual void set_position_locked(bool yn, void* src) ;
115 * Returns whether this item is locked to its current position
117 * @return true if this item is locked to its current posotion
120 bool get_position_locked() const ;
123 * Sets whether the Maximum Duration constraint is active and should be enforced
125 * @param active set true to enforce the max duration constraint
126 * @param src the identity of the object that initiated the change
128 void set_max_duration_active(bool active, void* src) ;
131 * Returns whether the Maximum Duration constraint is active and should be enforced
133 * @return true if the maximum duration constraint is active, false otherwise
135 bool get_max_duration_active() const ;
138 * Sets whether the Minimum Duration constraint is active and should be enforced
140 * @param active set true to enforce the min duration constraint
141 * @param src the identity of the object that initiated the change
143 void set_min_duration_active(bool active, void* src) ;
146 * Returns whether the Maximum Duration constraint is active and should be enforced
148 * @return true if the maximum duration constraint is active, false otherwise
150 bool get_min_duration_active() const ;
153 * Set the name/Id of this item.
155 * @param new_name the new name of this item
156 * @param src the identity of the object that initiated the change
158 void set_item_name(std::string new_name, void* src) ;
161 * Returns the name/id of this item
163 * @return the name/id of this item
165 virtual std::string get_item_name() const ;
168 * Set to true to indicate that this item is currently selected
170 * @param yn true if this item is currently selected
172 virtual void set_selected(bool yn) ;
175 * Set to true to indicate that this item should show its selection status
177 * @param yn true if this item should show its selected status
179 virtual void set_should_show_selection (bool yn) ;
181 //---------------------------------------------------------------------------------------//
182 // Parent Component Methods
185 * Returns the TimeAxisView that this item is upon
187 * @return the timeAxisView that this item is placed upon
189 TimeAxisView& get_time_axis_view() ;
191 //---------------------------------------------------------------------------------------//
195 * Sets the displayed item text
196 * This item is the visual text name displayed on the canvas item, this can be different to the name of the item
198 * @param new_name the new name text to display
200 void set_name_text(std::string new_name) ;
203 * Set the height of this item
205 * @param h the new height
207 virtual void set_height(double h) ;
212 void set_color(Gdk::Color& color) ;
217 ArdourCanvas::Item* get_canvas_frame() ;
222 ArdourCanvas::Item* get_canvas_group();
227 ArdourCanvas::Item* get_name_highlight();
232 ArdourCanvas::Text* get_name_text();
236 * Sets the samples per unit of this item.
237 * this item is used to determine the relative visual size and position of this item
238 * based upon its duration and start value.
240 * @param spu the new samples per unit value
242 virtual void set_samples_per_unit(double spu) ;
245 * Returns the current samples per unit of this item
247 * @return the samples per unit of this item
249 double get_samples_per_unit() ;
251 virtual void raise () { return; }
252 virtual void raise_to_top () { return; }
253 virtual void lower () { return; }
254 virtual void lower_to_bottom () { return; }
257 * returns true if the name area should respond to events.
259 bool name_active() const { return name_connected; }
261 // Default sizes, font and spacing
262 static Pango::FontDescription NAME_FONT ;
263 static bool have_name_font;
264 static const double NAME_X_OFFSET ;
265 static const double GRAB_HANDLE_LENGTH ;
266 /* these are not constant, but vary with the pixel size
267 of the font used to display the item name.
269 static double NAME_Y_OFFSET ;
270 static double NAME_HIGHLIGHT_SIZE ;
271 static double NAME_HIGHLIGHT_THRESH ;
274 * Handles the Removal of this time axis item
275 * This _needs_ to be called to alert others of the removal properly, ie where the source
276 * of the removal came from.
278 * XXX Although im not too happy about this method of doing things, I cant think of a cleaner method
279 * just now to capture the source of the removal
281 * @param src the identity of the object that initiated the change
283 virtual void remove_this_item(void* src) ;
286 * Emitted when this Group has been removed
287 * This is different to the GoingAway signal in that this signal
288 * is emitted during the deletion of this Time Axis, and not during
289 * the destructor, this allows us to capture the source of the deletion
292 sigc::signal<void,std::string,void*> ItemRemoved ;
294 /** Emitted when the name/Id of this item is changed */
295 sigc::signal<void,std::string,std::string,void*> NameChanged ;
297 /** Emiited when the position of this item changes */
298 sigc::signal<void,nframes_t,void*> PositionChanged ;
300 /** Emitted when the position lock of this item is changed */
301 sigc::signal<void,bool,void*> PositionLockChanged ;
303 /** Emitted when the duration of this item changes */
304 sigc::signal<void,nframes_t,void*> DurationChanged ;
306 /** Emitted when the maximum item duration is changed */
307 sigc::signal<void,nframes_t,void*> MaxDurationChanged ;
309 /** Emitted when the mionimum item duration is changed */
310 sigc::signal<void,nframes_t,void*> MinDurationChanged ;
316 ShowNameHighlight = 0x2,
319 HideFrameLeft = 0x10,
320 HideFrameRight = 0x20,
322 FullWidthNameHighlight = 0x80
326 * Constructs a new TimeAxisViewItem.
328 * @param it_name the unique name/Id of this item
329 * @param parent the parent canvas group
330 * @param tv the TimeAxisView we are going to be added to
331 * @param spu samples per unit
333 * @param start the start point of this item
334 * @param duration the duration of this item
336 TimeAxisViewItem(const std::string & it_name, ArdourCanvas::Group& parent, TimeAxisView& tv, double spu, Gdk::Color& base_color,
337 nframes_t start, nframes_t duration, Visibility v = Visibility (0));
340 * Calculates some contrasting color for displaying various parts of this item, based upon the base color
342 * @param color the base color of the item
344 virtual void compute_colors(Gdk::Color& color) ;
347 * convenience method to set the various canvas item colors
349 virtual void set_colors() ;
352 * Sets the frame color depending on whether this item is selected
354 void set_frame_color() ;
357 * Sets the colors of the start and end trim handle depending on object state
360 void set_trim_handle_colors() ;
362 virtual void reset_width_dependent_items (double pixel_width);
363 void reset_name_width (double pixel_width);
366 * Callback used to remove this item during the gtk idle loop
367 * This is used to avoid deleting the obejct while inside the remove_this_group
370 * @param item the time axis item to remove
371 * @param src the identity of the object that initiated the change
373 static gint idle_remove_this_item(TimeAxisViewItem* item, void* src) ;
375 /** The time axis that this item is upon */
376 TimeAxisView& trackview ;
378 /** indicates whether this item is locked to its current position */
379 bool position_locked ;
381 /** The posotion of this item on the timeline */
382 nframes_t frame_position ;
384 /** the duration of this item upon the timeline */
385 nframes_t item_duration ;
387 /** the maximum duration that we allow this item to take */
388 nframes_t max_item_duration ;
390 /** the minimu duration that we allow this item to take */
391 nframes_t min_item_duration ;
393 /** indicates whether this Max Duration constraint is active */
394 bool max_duration_active ;
396 /** indicates whether this Min Duration constraint is active */
397 bool min_duration_active ;
399 /** the curretn samples per canvas unit */
400 double samples_per_unit ;
402 /** indicates if this item is currently selected */
405 /** should the item show its selected status */
406 bool should_show_selection;
409 * The unique item name of this Item
410 * Each item upon a time axis must have a unique id
412 std::string item_name ;
415 * true if the name should respond to events
420 * true if a small vestigial rect should be shown when the item gets very narrow
425 uint32_t fill_opacity;
426 uint32_t fill_color ;
427 uint32_t frame_color_r ;
428 uint32_t frame_color_g ;
429 uint32_t frame_color_b ;
430 uint32_t selected_frame_color_r ;
431 uint32_t selected_frame_color_g ;
432 uint32_t selected_frame_color_b ;
433 uint32_t label_color ;
435 uint32_t handle_color_r ;
436 uint32_t handle_color_g ;
437 uint32_t handle_color_b ;
438 uint32_t lock_handle_color_r ;
439 uint32_t lock_handle_color_g ;
440 uint32_t lock_handle_color_b ;
442 ArdourCanvas::Group* group;
443 ArdourCanvas::SimpleRect* vestigial_frame;
444 ArdourCanvas::SimpleRect* frame;
445 ArdourCanvas::Text* name_text;
446 ArdourCanvas::SimpleRect* name_highlight;
447 ArdourCanvas::SimpleRect* frame_handle_start;
448 ArdourCanvas::SimpleRect* frame_handle_end;
450 Visibility visibility;
452 }; /* class TimeAxisViewItem */
454 #endif /* __gtk_ardour_time_axis_view_item_h__ */