1 /* === S Y N F I G ========================================================= */
3 ** \brief Template Header
8 ** Copyright (c) 2002-2005 Robert B. Quattlebaum Jr., Adrian Bentley
9 ** Copyright (c) 2007 Chris Moore
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_GTKMM_CANVASVIEW_H
27 #define __SYNFIG_STUDIO_GTKMM_CANVASVIEW_H
29 /* === H E A D E R S ======================================================= */
31 #include <gtkmm/window.h>
32 #include <gtkmm/image.h>
33 #include <gtkmm/tooltips.h>
34 #include <gtkmm/table.h>
35 #include <gtkmm/statusbar.h>
36 #include <gtkmm/progressbar.h>
37 #include <gtkmm/button.h>
38 #include <gtkmm/menu.h>
39 #include <gtkmm/treeview.h>
40 #include <gtkmm/treestore.h>
41 #include <gtkmm/scrolledwindow.h>
42 #include <gtkmm/notebook.h>
43 #include <gdkmm/device.h>
45 #include <synfigapp/canvasinterface.h>
46 #include <synfigapp/selectionmanager.h>
48 #include <synfig/canvas.h>
49 #include <synfig/string.h>
50 #include <synfig/time.h>
53 #include "canvasproperties.h"
54 #include "canvasoptions.h"
56 #include "cellrenderer_timetrack.h"
59 #include "layertreestore.h"
60 #include "layertree.h"
61 #include "childrentreestore.h"
62 #include "childrentree.h"
63 #include "keyframetreestore.h"
64 #include "keyframetree.h"
66 #include "dialog_waypoint.h"
67 #include "dialog_keyframe.h"
69 #include "duckmatic.h"
70 #include <gtkmm/scale.h>
72 #include <gtkmm/uimanager.h>
79 #include <gtkmm/toggleaction.h>
80 #include <gtkmm/radioaction.h>
81 #include <synfig/rect.h>
83 #include "adjust_window.h"
85 #include <synfig/transform.h>
87 /* === M A C R O S ========================================================= */
89 #ifndef DEBUGPOINT_CLASS
91 #define DEBUGPOINT_CLASS(x) struct debugpointclass_ ## x { debugpointclass_ ## x () { DEBUGPOINT(); } ~debugpointclass_ ## x () { DEBUGPOINT(); } } badfthguae_ ## x ;
93 #define DEBUGPOINT_CLASS(x)
97 /* === T Y P E D E F S ===================================================== */
99 /* === C L A S S E S & S T R U C T S ======================================= */
103 class CanvasViewUIInterface;
104 class CanvasViewSelectionManager;
106 class CellRenderer_TimeTrack;
107 class CellRenderer_ValueBase;
108 class UniversalScrubber;
115 class AudioContainer;
118 class Widget_Timeslider;
121 class Dialog_SoundSelect;
122 class Dialog_Preview;
124 class synfig::TransformStack;
127 class Dock_Keyframes;
129 class CanvasView : public Gtk::Window, public etl::shared_object
131 friend class UniversalScrubber;
132 friend class Dock_Layers;
133 friend class Dock_Children;
134 friend class Dock_Keyframes;
136 friend class CanvasViewUIInterface;
137 friend class CanvasViewSelectionManager;
139 friend class Duckmatic;
142 -- ** -- P U B L I C T Y P E S ---------------------------------------------
147 typedef etl::handle<CanvasView> Handle;
149 typedef etl::handle<const CanvasView> ConstHandle;
151 typedef etl::loose_handle<CanvasView> LooseHandle;
153 typedef LayerTreeStore::Model LayerTreeModel;
155 typedef ChildrenTreeStore::Model ChildrenTreeModel;
157 //! Create an instance of this class whenever doing a longer task.
158 /*! Make sure that you check the bool value of this class occasionaly
159 ** to make sure the action has not been canceled. */
162 CanvasView &canvas_view_;
165 IsWorking(CanvasView &canvas_view_);
167 operator bool()const;
169 friend class IsWorking;
171 typedef synfigapp::CanvasInterface::Mode Mode;
174 -- ** -- P R I V A T E D A T A ---------------------------------------------
178 std::auto_ptr<WorkArea> work_area;
180 WorkArea* get_work_area() { return work_area.get(); }
183 synfig::TransformStack curr_transform_stack;
184 bool curr_transform_stack_set;
195 etl::loose_handle<Instance> instance_;
196 etl::handle<synfigapp::CanvasInterface> canvas_interface_;
200 //! Sound and information to play it
201 etl::handle<AudioContainer> audio;
202 studio::Widget_Sound *disp_audio; //should this be put into thing too?
204 SigC::Connection playcon;
205 SigC::Connection stopcon;
207 std::auto_ptr<UniversalScrubber> universal_scrubber;
209 //! Tooltip controler
210 Gtk::Tooltips tooltips;
214 //! TreeModel for the layers
215 LayerTreeModel layer_tree_model;
217 //! TreeModel for the the children
218 ChildrenTreeModel children_tree_model;
220 //Glib::RefPtr<LayerTreeStore> layer_tree_store_;
222 //Glib::RefPtr<ChildrenTreeStore> children_tree_store_;
224 //Glib::RefPtr<KeyframeTreeStore> keyframe_tree_store_;
228 //std::map<synfig::String,Glib::RefPtr<Gtk::TreeModel> > tree_model_book_;
229 std::map<synfig::String,Glib::RefPtr<Glib::ObjectBase> > ref_obj_book_;
230 std::map<synfig::String,Gtk::Widget*> ext_widget_book_;
233 //! The time adjustment's scope is defined by the time_window adjustment
234 Gtk::Adjustment time_adjustment_;
236 //! The time_window adjustment governs the position of the time window on the whole time line
237 //Gtk::Adjustment time_window_adjustment_;
238 studio::Adjust_Window time_window_adjustment_;
241 LayerTree *layer_tree;
243 ChildrenTree *children_tree;
245 KeyframeTree *keyframe_tree;
247 Gtk::Widget *keyframe_tab_child;
249 Gtk::ProgressBar *progressbar;
250 Gtk::Statusbar *statusbar;
252 Gtk::TreeRow children_canvas_row;
253 Gtk::TreeRow children_valuenode_row;
255 Gtk::Button *stopbutton;
256 Gtk::Button *refreshbutton;
257 Gtk::Button *treetogglebutton;
258 Gtk::Notebook *notebook;
259 Gtk::Widget *timebar;
261 Widget_Time *current_time_widget;
262 void on_current_time_widget_changed();
264 std::auto_ptr<Widget_Timeslider> timeslider;
266 std::list<sigc::connection> duck_changed_connections;
270 Gtk::Button *animatebutton;
271 Gtk::Button *keyframebutton;
273 /* DEBUGPOINT_CLASS(8);
275 Gtk::Menu duckmaskmenu;
276 DEBUGPOINT_CLASS(77);
277 Gtk::Menu qualitymenu;
281 DEBUGPOINT_CLASS(777);
283 DEBUGPOINT_CLASS(71);
284 Gtk::Menu canvasmenu;
285 DEBUGPOINT_CLASS(73);
289 DEBUGPOINT_CLASS(74);
290 Gtk::Menu newlayermenu;
291 DEBUGPOINT_CLASS(76);
294 DEBUGPOINT_CLASS(99);
295 Gtk::Menu keyframemenu;
302 Gtk::CheckMenuItem* duck_mask_position;
303 Gtk::CheckMenuItem* duck_mask_vertex;
304 Gtk::CheckMenuItem* duck_mask_tangent;
305 Gtk::CheckMenuItem* duck_mask_radius;
306 Gtk::CheckMenuItem* duck_mask_width;
307 Gtk::CheckMenuItem* duck_mask_angle;
312 Glib::RefPtr<Gtk::ToggleAction> duck_mask_position;
313 Glib::RefPtr<Gtk::ToggleAction> duck_mask_vertex;
314 Glib::RefPtr<Gtk::ToggleAction> duck_mask_tangent;
315 Glib::RefPtr<Gtk::ToggleAction> duck_mask_radius;
316 Glib::RefPtr<Gtk::ToggleAction> duck_mask_width;
317 Glib::RefPtr<Gtk::ToggleAction> duck_mask_angle;
319 Gtk::RadioButtonGroup quality_group;
321 Glib::RefPtr<Gtk::ActionGroup> action_group;
324 etl::handle<synfigapp::UIInterface> ui_interface_;
325 etl::handle<synfigapp::SelectionManager> selection_manager_;
329 sigc::signal<void> signal_deleted_;
331 bool rebuild_ducks_queued;
332 sigc::connection queue_rebuild_ducks_connection;
335 -- ** -- P U B L I C D A T A -----------------------------------------------
339 void queue_rebuild_ducks();
340 sigc::signal<void>& signal_deleted() { return signal_deleted_; }
344 bool duck_refresh_flag;
345 bool duck_refresh_needed;
347 //! This is for the IsWorking class.
354 -- ** -- D I A L O G S -------------------------------------------------------
359 CanvasProperties canvas_properties;
360 CanvasOptions canvas_options;
361 RenderSettings render_settings;
362 Dialog_Waypoint waypoint_dialog;
363 Dialog_Keyframe keyframe_dialog;
365 std::auto_ptr<Dialog_Preview> preview_dialog;
366 //std::auto_ptr<Dialog_PreviewOptions> previewoption_dialog;
367 std::auto_ptr<Dialog_SoundSelect> sound_dialog;
370 -- ** -- P R I V A T E M E T H O D S ---------------------------------------
375 // Constructor is private to force the use of the "create()" constructor
376 CanvasView(etl::loose_handle<Instance> instance,etl::handle<synfigapp::CanvasInterface> canvas_interface);
378 //! Constructor Helper
379 Gtk::Widget* create_layer_tree();
381 //! Constructor Helper
382 Gtk::Widget* create_children_tree();
384 //! Constructor Helper
385 Gtk::Widget* create_keyframe_tree();
387 //! Constructor Helper
388 Gtk::Widget* create_status_bar();
390 //! Constructor Helper - Initializes all of the menus
393 bool duck_change_param(const synfig::Point &value,synfig::Layer::Handle layer, synfig::String param_name);
395 void refresh_time_window();
397 void time_was_changed();
399 void refresh_rend_desc();
401 void toggle_duck_mask(Duckmatic::Type type);
403 Gtk::Widget *create_work_area();
405 Gtk::Widget *create_time_bar();
409 void popup_param_menu_bezier(float location, synfigapp::ValueDesc value_desc)
410 { popup_param_menu(value_desc,location); }
412 void popup_param_menu(synfigapp::ValueDesc value_desc, float location=0);
415 void workarea_layer_selected(synfig::Layer::Handle layer);
417 void selected_layer_color_set(synfig::Color color);
421 void register_layer_type(synfig::Layer::Book::value_type &lyr,std::map<synfig::String,Gtk::Menu*>*);
423 //! Rebuilds the "new layer" menu
424 void build_new_layer_menu(Gtk::Menu &menu);
426 void rebuild_ducks_layer_(synfig::TransformStack& transform_stack, synfig::Canvas::Handle canvas, std::set<synfig::Layer::Handle>& selected_list);
429 -- ** -- P U B L I C M E T H O D S -----------------------------------------
433 const synfig::TransformStack& get_curr_transform_stack()const { return curr_transform_stack; }
435 const synfig::Rect& get_bbox()const { return bbox; }
437 Glib::RefPtr<Glib::ObjectBase> get_ref_obj(const synfig::String& x);
438 Glib::RefPtr<const Glib::ObjectBase> get_ref_obj(const synfig::String& x)const;
439 void set_ref_obj(const synfig::String& x, Glib::RefPtr<Glib::ObjectBase> y);
441 Glib::RefPtr<Gtk::TreeModel> get_tree_model(const synfig::String& x);
442 Glib::RefPtr<const Gtk::TreeModel> get_tree_model(const synfig::String& x)const;
443 void set_tree_model(const synfig::String& x, Glib::RefPtr<Gtk::TreeModel> y);
445 Gtk::Widget* get_ext_widget(const synfig::String& x);
446 void set_ext_widget(const synfig::String& x, Gtk::Widget* y);
448 //std::map<synfig::String,Gtk::Widget*>& tree_view_book() { return tree_view_book_; }
449 //std::map<synfig::String,Gtk::Widget*>& ext_widget_book() { return tree_view_book_; }
451 void popup_main_menu();
453 Smach& get_smach() { return smach_; }
455 const Smach& get_smach()const { return smach_; }
457 Smach::event_result process_event_key(EventKey x);
459 void popup_layer_menu(synfig::Layer::Handle layer);
461 virtual ~CanvasView();
463 void set_mode(Mode x) { canvas_interface()->set_mode(x); }
465 Mode get_mode()const { return canvas_interface()->get_mode(); }
467 Gtk::Adjustment &time_adjustment() { return time_adjustment_; }
469 const Gtk::Adjustment &time_adjustment()const { return time_adjustment_; }
471 studio::Adjust_Window &time_window_adjustment() { return time_window_adjustment_; }
473 const studio::Adjust_Window &time_window_adjustment()const { return time_window_adjustment_; }
475 etl::handle<synfigapp::UIInterface> get_ui_interface() { return ui_interface_;}
477 etl::handle<synfigapp::SelectionManager> get_selection_manager() { return selection_manager_; }
479 Glib::RefPtr<Gtk::TreeModel> layer_tree_store() { return get_tree_model("layers"); }
481 Glib::RefPtr<const Gtk::TreeModel> layer_tree_store()const { return get_tree_model("layers"); }
483 Glib::RefPtr<Gtk::TreeModel> children_tree_store() { return get_tree_model("children"); }
485 Glib::RefPtr<const Gtk::TreeModel> children_tree_store()const { return get_tree_model("children"); }
487 Glib::RefPtr<Gtk::TreeModel> keyframe_tree_store() { return get_tree_model("keyframes"); }
489 Glib::RefPtr<const Gtk::TreeModel> keyframe_tree_store()const { return get_tree_model("keyframes"); }
491 void set_time(synfig::Time t) { canvas_interface_->set_time(t); }
493 synfig::Time get_time() { return canvas_interface_->get_time(); }
495 etl::handle<synfig::Canvas> get_canvas()const { return canvas_interface_->get_canvas(); }
497 etl::handle<Instance> get_instance()const { return instance_; }
499 etl::handle<synfigapp::CanvasInterface> canvas_interface() { return canvas_interface_; }
501 etl::handle<const synfigapp::CanvasInterface> canvas_interface()const { return canvas_interface_; }
503 void add_actions_to_menu(Gtk::Menu *menu, const synfigapp::Action::ParamList ¶m_list, synfigapp::Action::Category category=synfigapp::Action::CATEGORY_ALL)const;
505 //! Updates the title of the window
508 //! Closes this canvas view
511 //! Stops the currently executing action
512 /*! \see get_cancel_status(), reset_cancel_status(), IsWorking */
513 void stop() { cancel=true; }
515 //! Returns the cancel status
516 /*! \see stop(), reset_cancel_status(), IsWorking */
517 bool get_cancel_status()const { return cancel; }
519 //! Resets the cancel status
520 /*! \see stop(), get_cancel_status(), IsWorking */
521 void reset_cancel_status() { cancel=false; }
523 void new_child_canvas();
525 //! Rebuilds layer_tree_store_ from the Canvas. Maintains selected items.
526 void rebuild_tables();
528 //! Builds layer_tree_store_ from the Canvas. Does not maintain selected items.
531 //! Refreshes the data for the tables
532 void refresh_tables();
534 //void rebuild_layer_table();
535 //void build_layer_table();
536 //void refresh_layer_table();
538 // void rebuild_canvas_table();
539 // void build_canvas_table();
540 // void refresh_canvas_table();
542 // void rebuild_valuenode_table();
543 // void build_valuenode_table();
544 // void refresh_valuenode_table();
547 void rebuild_ducks();
549 //bool add_to_ducks(synfigapp::ValueDesc value_desc, synfig::ParamDesc *param_desc=NULL);
551 //! Starts "playing" the animation in real-time
554 //! Shows the tables (Layer/Children)
557 //! Hides the tables (Layer/Children)
560 //! Toggles the tables
561 void toggle_tables();
563 //! Gets the table status
564 bool tables_are_visible();
566 //! Shows the time bar
569 //! Hides the time bar
572 //t Enables or disables interaction with the timebar
573 void set_sensitive_timebar(bool sensitive);
576 void time_zoom_out();
578 void add_layer(synfig::String x);
580 void show_keyframe_dialog();
582 void play_audio(float t);
587 void on_waypoint_clicked(synfigapp::ValueDesc,synfig::Waypoint, int button);
589 void preview_option() {on_preview_option();}
593 bool is_playing() { return is_playing_; }
596 -- ** -- S I G N A L T E R M I N A L S -------------------------------------
601 void on_unselect_layers();
603 void on_input_device_changed(GdkDevice*);
605 virtual void on_hide();
607 virtual bool on_focus_in_event(GdkEventFocus*);
608 virtual bool on_focus_out_event(GdkEventFocus*);
610 //bool on_children_tree_event(GdkEvent *event);
612 bool on_keyframe_tree_event(GdkEvent *event);
614 //void on_children_edited_value(const Glib::ustring&path_string,synfig::ValueBase value);
616 void on_dirty_preview();
618 bool on_children_user_click(int, Gtk::TreeRow, ChildrenTree::ColumnID);
620 bool on_layer_user_click(int, Gtk::TreeRow, LayerTree::ColumnID);
622 // void on_layer_toggle(const Glib::ustring& path_string, Gtk::TreeModelColumn<bool> column);
624 void on_mode_changed(synfigapp::CanvasInterface::Mode mode);
626 // void on_layer_waypoint_clicked(const Glib::ustring &, synfig::ValueNode_Animated::WaypointList::iterator);
628 //void on_children_waypoint_clicked(const Glib::ustring &, synfig::ValueNode_Animated::WaypointList::iterator);
630 void on_waypoint_changed();
632 void on_waypoint_delete();
634 void on_refresh_pressed();
636 void on_id_changed();
638 void on_time_changed();
641 void on_layer_raise_pressed();
642 void on_layer_lower_pressed();
643 void on_layer_duplicate_pressed();
644 void on_layer_delete_pressed();
647 void on_keyframe_add_pressed();
649 void on_keyframe_duplicate_pressed();
651 void on_keyframe_remove_pressed();
653 void on_animate_button_pressed();
655 void on_keyframe_button_pressed();
657 void on_preview_option();
658 void on_preview_create(const PreviewInfo &);
660 void on_audio_option();
661 void on_audio_file_change(const std::string &f);
662 void on_audio_offset_change(const synfig::Time &t);
664 void on_audio_file_notify();
665 void on_audio_offset_notify();
667 bool on_duck_changed(const synfig::Point &value,const synfigapp::ValueDesc& value_desc);
669 void on_layer_toggle(synfig::Layer::Handle);
671 void on_edited_value(synfigapp::ValueDesc,synfig::ValueBase);
673 //void on_waypoint_clicked(synfigapp::ValueDesc,synfig::ValueNode_Animated::WaypointList::iterator, int button);
675 void on_drop_drag_data_received(const Glib::RefPtr<Gdk::DragContext>& context, int x, int y, const Gtk::SelectionData& selection_data, guint info, guint time);
677 //void on_audio_play();
678 bool on_audio_scrub();
681 bool close_instance_when_safe();
682 bool on_delete_event(GdkEventAny* event);
685 -- ** -- S T A T I C P U B L I C M E T H O D S ---------------------------
690 static etl::handle<studio::CanvasView> create(etl::loose_handle<Instance> instance,etl::handle<synfig::Canvas> canvas);
691 }; // END of class CanvasView
693 }; // END of namespace studio
695 /* === E N D =============================================================== */