1 /* === S Y N F I G ========================================================= */
2 /*! \file widget_keyframe_list.h
3 ** \brief A custom widget to manage keyframes in the timeline.
8 ** Copyright (c) 2002-2005 Robert B. Quattlebaum Jr., Adrian Bentley
9 ** Copyright (c) 2009 Carlos López
11 ** This package is free software; you can redistribute it and/or
12 ** modify it under the terms of the GNU General Public License as
13 ** published by the Free Software Foundation; either version 2 of
14 ** the License, or (at your option) any later version.
16 ** This package is distributed in the hope that it will be useful,
17 ** but WITHOUT ANY WARRANTY; without even the implied warranty of
18 ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
19 ** General Public License for more details.
22 /* ========================================================================= */
24 /* === S T A R T =========================================================== */
26 #ifndef __SYNFIG_STUDIO_WIDGET_KEYFRAME_LIST_H
27 #define __SYNFIG_STUDIO_WIDGET_KEYFRAME_LIST_H
29 /* === H E A D E R S ======================================================= */
31 #include <gtkmm/drawingarea.h>
32 #include <gtkmm/adjustment.h>
33 #include <synfig/keyframe.h>
34 #include <sigc++/connection.h>
37 /* === M A C R O S ========================================================= */
39 /* === T Y P E D E F S ===================================================== */
41 /* === C L A S S E S & S T R U C T S ======================================= */
45 class Widget_Keyframe_List : public Gtk::DrawingArea
47 //! Time adjustment window
48 Gtk::Adjustment adj_default;
49 Gtk::Adjustment *adj_timescale;
51 //!The list of keyframes to be drawn on the widget and moved with mouse
52 synfig::KeyframeList default_kf_list_;
53 mutable synfig::KeyframeList* kf_list_;
55 //! The frames per second of the canvas
58 //!True if it is editable. Keyframes can be moved.
61 //!True if a keyframe is being dragged.
64 //!True if a keyframe has been moved
67 //!Holds the selected keyframe of the keyframe list
68 synfig::Keyframe selected_kf;
70 //!The time of the selected keyframe
71 synfig::Time selected_kf_time;
73 //!The time of the selected keyframe during draging
74 synfig::Time dragging_kf_time;
76 //!Connectors for handling the signals of the time adjustment
77 sigc::connection time_value_change;
78 sigc::connection time_other_change;
82 //!Default constructor
83 Widget_Keyframe_List();
86 ~Widget_Keyframe_List();
88 //!Loads a new keyframe list on the widget.
89 void set_kf_list(synfig::KeyframeList* x);
91 //!Member for private data.
92 synfig::KeyframeList* get_kf_list()const { return kf_list_; }
94 //!Member for private data
95 void set_editable(bool x=true) { editable_=x; }
97 //!Member for private data
98 bool get_editable()const { return editable_; }
101 //!Store the selected keyframe value
102 void set_selected_keyframe(const synfig::Keyframe &x);
104 //!Returns the selected keyframe
105 const synfig::Keyframe& get_selected_keyframe() { return selected_kf; }
107 //! Set the time adjustment and proper connects its change signals
108 void set_time_adjustment(Gtk::Adjustment *x);
111 void set_fps(float x);
113 //! Performs the keyframe movement. Returns true if it was sucessful
114 bool perform_move_kf();
118 /* ======================= EVENTS HANDLERS ===========================*/
119 //!Redraw event. Should draw all the keyframes + the selected + the dragged
120 bool redraw(GdkEventExpose*bleh=NULL);
122 //!Mouse event handler.
123 bool on_event(GdkEvent *event);
124 }; // END of class Keyframe_List
126 }; // END of namespace studio
128 /* === E N D =============================================================== */