Add render quality spin button. WIP
[synfig.git] / synfig-studio / trunk / src / gtkmm / canvasview.h
1 /* === S Y N F I G ========================================================= */
2 /*!     \file canvasview.h
3 **      \brief Template Header
4 **
5 **      $Id$
6 **
7 **      \legal
8 **      Copyright (c) 2002-2005 Robert B. Quattlebaum Jr., Adrian Bentley
9 **      Copyright (c) 2007, 2008 Chris Moore
10 **
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.
15 **
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.
20 **      \endlegal
21 */
22 /* ========================================================================= */
23
24 /* === S T A R T =========================================================== */
25
26 #ifndef __SYNFIG_STUDIO_GTKMM_CANVASVIEW_H
27 #define __SYNFIG_STUDIO_GTKMM_CANVASVIEW_H
28
29 /* === H E A D E R S ======================================================= */
30
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>
44 #include <gtkmm/spinbutton.h>
45
46 #include <synfigapp/canvasinterface.h>
47 #include <synfigapp/selectionmanager.h>
48
49 #include <synfig/canvas.h>
50 #include <synfig/string.h>
51 #include <synfig/time.h>
52
53 #include "instance.h"
54 #include "canvasproperties.h"
55 #include "canvasoptions.h"
56 #include "render.h"
57 #include "cellrenderer_timetrack.h"
58 #include "app.h"
59
60 #include "layertreestore.h"
61 #include "layertree.h"
62 #include "childrentreestore.h"
63 #include "childrentree.h"
64 #include "keyframetreestore.h"
65 #include "keyframetree.h"
66
67 #include "dialog_waypoint.h"
68 #include "dialog_keyframe.h"
69 #include "framedial.h"
70 #include "toggleducksdial.h"
71 #include "resolutiondial.h"
72
73 #include "duckmatic.h"
74 #include <gtkmm/scale.h>
75
76 #include <gtkmm/uimanager.h>
77
78 #include "smach.h"
79
80 #include <memory>
81 #include <set>
82 #include <map>
83 #include <gtkmm/toggleaction.h>
84 #include <gtkmm/radioaction.h>
85 #include <synfig/rect.h>
86
87 #include "adjust_window.h"
88
89 #include <synfig/transform.h>
90
91 /* === M A C R O S ========================================================= */
92
93 #ifndef DEBUGPOINT_CLASS
94 #if     _DEBUG
95 #define DEBUGPOINT_CLASS(x)             struct debugpointclass_ ## x { debugpointclass_ ## x () { DEBUGPOINT(); } ~debugpointclass_ ## x () { DEBUGPOINT(); } } badfthguae_ ## x ;
96 #else
97 #define DEBUGPOINT_CLASS(x)
98 #endif
99 #endif
100
101 /* === T Y P E D E F S ===================================================== */
102
103 /* === C L A S S E S & S T R U C T S ======================================= */
104
105 namespace synfig {
106         class TransformStack;
107 }
108
109 namespace studio {
110
111 class CanvasViewUIInterface;
112 class CanvasViewSelectionManager;
113
114 class CellRenderer_TimeTrack;
115 class CellRenderer_ValueBase;
116 class UniversalScrubber;
117 class WorkArea;
118
119 class Duckmatic;
120
121 class Preview;
122 struct PreviewInfo;
123 class AudioContainer;
124
125 class Widget_Sound;
126 class Widget_Timeslider;
127 class Widget_Time;
128
129 class Dialog_SoundSelect;
130 class Dialog_Preview;
131
132 class Dock_Layers;
133 class Dock_Children;
134 class Dock_Keyframes;
135
136 class CanvasView : public Gtk::Window, public etl::shared_object
137 {
138         friend class UniversalScrubber;
139         friend class Dock_Layers;
140         friend class Dock_Children;
141         friend class Dock_Keyframes;
142
143         friend class CanvasViewUIInterface;
144         friend class CanvasViewSelectionManager;
145
146         friend class Duckmatic;
147
148         /*
149  -- ** -- P U B L I C   T Y P E S ---------------------------------------------
150         */
151
152 public:
153
154         typedef etl::handle<CanvasView> Handle;
155
156         typedef etl::handle<const CanvasView> ConstHandle;
157
158         typedef etl::loose_handle<CanvasView> LooseHandle;
159
160         typedef LayerTreeStore::Model LayerTreeModel;
161
162         typedef ChildrenTreeStore::Model ChildrenTreeModel;
163
164         //! Create an instance of this class whenever doing a longer task.
165         /*! Make sure that you check the bool value of this class occasionally
166         **      to make sure the action has not been canceled. */
167         class IsWorking
168         {
169                 CanvasView &canvas_view_;
170
171         public:
172                 IsWorking(CanvasView &canvas_view_);
173                 ~IsWorking();
174                 operator bool()const;
175         };
176         friend class IsWorking;
177
178         typedef synfigapp::CanvasInterface::Mode Mode;
179
180         void set_grid_snap_toggle(bool flag) { grid_snap_toggle->set_active(flag); }
181         void set_grid_show_toggle(bool flag) { grid_show_toggle->set_active(flag); }
182
183         /*
184  -- ** -- P R I V A T E   D A T A ---------------------------------------------
185         */
186
187 public:
188         std::auto_ptr<WorkArea> work_area;
189
190         WorkArea* get_work_area() { return work_area.get(); }
191 private:
192
193         synfig::TransformStack curr_transform_stack;
194         bool curr_transform_stack_set;
195
196         synfig::Rect bbox;
197
198         // DEBUGPOINT_CLASS(1);
199
200         //! State Machine
201         Smach smach_;
202
203         // DEBUGPOINT_CLASS(2);
204
205         etl::loose_handle<Instance> instance_;
206         etl::handle<synfigapp::CanvasInterface> canvas_interface_;
207
208         // DEBUGPOINT_CLASS(3);
209
210         //! Sound and information to play it
211         etl::handle<AudioContainer>             audio;
212         studio::Widget_Sound                    *disp_audio; //should this be put into thing too?
213
214         sigc::connection                                playcon;
215         sigc::connection                                stopcon;
216
217         std::auto_ptr<UniversalScrubber> universal_scrubber;
218
219         //! Tooltip controller
220         Gtk::Tooltips tooltips;
221
222         // DEBUGPOINT_CLASS(4);
223
224         //! TreeModel for the layers
225         LayerTreeModel layer_tree_model;
226
227         //! TreeModel for the the children
228         ChildrenTreeModel children_tree_model;
229
230         //Glib::RefPtr<LayerTreeStore> layer_tree_store_;
231
232         //Glib::RefPtr<ChildrenTreeStore> children_tree_store_;
233
234         //Glib::RefPtr<KeyframeTreeStore> keyframe_tree_store_;
235
236         // DEBUGPOINT_CLASS(5);
237
238         //std::map<synfig::String,Glib::RefPtr<Gtk::TreeModel> > tree_model_book_;
239         std::map<synfig::String,Glib::RefPtr<Glib::ObjectBase> > ref_obj_book_;
240         std::map<synfig::String,Gtk::Widget*> ext_widget_book_;
241
242         //! The time adjustment's scope is defined by the time_window adjustment
243         Gtk::Adjustment time_adjustment_;
244
245         //! The time_window adjustment governs the position of the time window on the whole time line
246         //Gtk::Adjustment time_window_adjustment_;
247         studio::Adjust_Window time_window_adjustment_;
248
249         LayerTree *layer_tree;
250
251         ChildrenTree *children_tree;
252
253         KeyframeTree *keyframe_tree;
254
255         Gtk::Widget *keyframe_tab_child;
256
257         Gtk::ProgressBar *progressbar;
258         Gtk::Statusbar *statusbar;
259
260         Gtk::TreeRow children_canvas_row;
261         Gtk::TreeRow children_valuenode_row;
262
263         Gtk::Button *stopbutton;
264         Gtk::Button *refreshbutton;
265         Gtk::Button *treetogglebutton;  // not used
266         Gtk::Notebook *notebook; // not used
267         Gtk::Table *timebar;
268         Gtk::Table *displaybar;
269         Gtk::Button *animatebutton;
270         Gtk::Button *keyframebutton;
271         FrameDial *framedial;
272         ToggleDucksDial *toggleducksdial;
273         bool toggling_ducks_;
274         ResolutionDial *resolutiondial;
275         bool changing_resolution_;
276         Gtk::Adjustment quality_adjustment_;
277         Gtk::SpinButton *quality_spin;
278         bool updating_quality_;
279         //! Shows current time and allows edition
280         Widget_Time *current_time_widget;
281         void on_current_time_widget_changed();
282
283         //! Time slider class. Same than the Time track panel
284         std::auto_ptr<Widget_Timeslider> timeslider;
285
286         std::list<sigc::connection> duck_changed_connections;
287
288 /*      DEBUGPOINT_CLASS(8);
289
290         Gtk::Menu duckmaskmenu;
291         DEBUGPOINT_CLASS(77);
292         Gtk::Menu qualitymenu;
293         DEBUGPOINT_CLASS(6);
294
295         Gtk::Menu filemenu;
296         DEBUGPOINT_CLASS(777);
297         Gtk::Menu editmenu;
298         DEBUGPOINT_CLASS(71);
299         Gtk::Menu canvasmenu;
300         DEBUGPOINT_CLASS(73);
301 public:
302         Gtk::Menu layermenu;
303 private:
304         DEBUGPOINT_CLASS(74);
305         Gtk::Menu newlayermenu;
306         DEBUGPOINT_CLASS(76);
307         Gtk::Menu viewmenu;
308
309         DEBUGPOINT_CLASS(99);
310         Gtk::Menu keyframemenu;
311
312         Gtk::Menu parammenu;
313         DEBUGPOINT_CLASS(9);
314         Gtk::Menu trackmenu;
315         DEBUGPOINT_CLASS(7);
316
317         Gtk::CheckMenuItem* duck_mask_position;
318         Gtk::CheckMenuItem* duck_mask_vertex;
319         Gtk::CheckMenuItem* duck_mask_tangent;
320         Gtk::CheckMenuItem* duck_mask_radius;
321         Gtk::CheckMenuItem* duck_mask_width;
322         Gtk::CheckMenuItem* duck_mask_angle;
323 */
324         //! Menu members
325         Gtk::Menu parammenu;
326
327         Glib::RefPtr<Gtk::ToggleAction> grid_snap_toggle;
328         Glib::RefPtr<Gtk::ToggleAction> grid_show_toggle;
329
330         Gtk::RadioButtonGroup quality_group;
331         Gtk::RadioButtonGroup low_res_pixel_size_group;
332
333         Glib::RefPtr<Gtk::ActionGroup> action_group;
334
335         etl::handle<synfigapp::UIInterface> ui_interface_;
336         etl::handle<synfigapp::SelectionManager> selection_manager_;
337
338         bool is_playing_;
339
340         sigc::signal<void> signal_deleted_;
341
342         bool rebuild_ducks_queued;
343         sigc::connection queue_rebuild_ducks_connection;
344
345         /*
346  -- ** -- P U B L I C   D A T A -----------------------------------------------
347         */
348
349 public:
350         void queue_rebuild_ducks();
351         sigc::signal<void>& signal_deleted() { return signal_deleted_; }
352
353         Gtk::Menu mainmenu;
354
355         bool duck_refresh_flag;
356         bool duck_refresh_needed;
357
358         //! This is for the IsWorking class.
359         int working_depth;
360
361         bool cancel;
362
363         /*
364  -- ** -- D I A L O G S -------------------------------------------------------
365         */
366
367 public:
368
369         CanvasProperties canvas_properties;
370         CanvasOptions canvas_options;
371         RenderSettings render_settings;
372         Dialog_Waypoint waypoint_dialog;
373         Dialog_Keyframe keyframe_dialog;
374
375         std::auto_ptr<Dialog_Preview>                   preview_dialog;
376         //std::auto_ptr<Dialog_PreviewOptions>  previewoption_dialog;
377         std::auto_ptr<Dialog_SoundSelect>               sound_dialog;
378
379         /*
380  -- ** -- P R I V A T E   M E T H O D S ---------------------------------------
381         */
382
383 private:
384
385         // Constructor is private to force the use of the "create()" constructor
386         CanvasView(etl::loose_handle<Instance> instance,etl::handle<synfigapp::CanvasInterface> canvas_interface);
387
388         //! Constructor Helper
389         // Gtk::Widget* create_layer_tree();
390
391         //! Constructor Helper
392         // Gtk::Widget* create_children_tree();
393
394         //! Constructor Helper
395         // Gtk::Widget* create_keyframe_tree();
396
397         //! Constructor Helper
398         Gtk::Widget* create_status_bar();
399
400         //! Constructor Helper - Initializes all of the menus
401         void init_menus();
402
403         bool duck_change_param(const synfig::Point &value,synfig::Layer::Handle layer, synfig::String param_name);
404
405         void refresh_time_window();
406
407         void time_was_changed();
408
409         void refresh_rend_desc();
410
411         void toggle_duck_mask(Duckmatic::Type type);
412
413         Gtk::Widget *create_work_area();
414
415         Gtk::Widget *create_time_bar();
416
417         Gtk::Widget *create_display_bar();
418
419         //! Pop up menu for the bezier (bline, draw) tool (?)
420         void popup_param_menu_bezier(float location, synfigapp::ValueDesc value_desc)
421         { popup_param_menu(value_desc,location,true); }
422
423         //! Pop up menu for the tools but not the bezier ones.
424         void popup_param_menu(synfigapp::ValueDesc value_desc, float location=0, bool bezier=false);
425
426         void workarea_layer_selected(synfig::Layer::Handle layer);
427
428         void selected_layer_color_set(synfig::Color color);
429
430         void register_layer_type(synfig::Layer::Book::value_type &lyr,std::map<synfig::String,Gtk::Menu*>*);
431
432         //! Rebuilds the "new layer" menu
433         void build_new_layer_menu(Gtk::Menu &menu);
434
435         void rebuild_ducks_layer_(synfig::TransformStack& transform_stack, synfig::Canvas::Handle canvas, std::set<synfig::Layer::Handle>& selected_list);
436
437         void decrease_low_res_pixel_size();
438         void increase_low_res_pixel_size();
439         void toggle_low_res_pixel_flag();
440
441         /*
442  -- ** -- P U B L I C   M E T H O D S -----------------------------------------
443         */
444
445 public:
446         const synfig::TransformStack& get_curr_transform_stack()const { return curr_transform_stack; }
447
448         const synfig::Rect& get_bbox()const { return bbox; }
449
450         Glib::RefPtr<Glib::ObjectBase> get_ref_obj(const synfig::String& x);
451         Glib::RefPtr<const Glib::ObjectBase> get_ref_obj(const synfig::String& x)const;
452         void set_ref_obj(const synfig::String& x, Glib::RefPtr<Glib::ObjectBase> y);
453
454         Glib::RefPtr<Gtk::TreeModel> get_tree_model(const synfig::String& x);
455         Glib::RefPtr<const Gtk::TreeModel> get_tree_model(const synfig::String& x)const;
456         void set_tree_model(const synfig::String& x, Glib::RefPtr<Gtk::TreeModel> y);
457
458         Gtk::Widget* get_ext_widget(const synfig::String& x);
459         void set_ext_widget(const synfig::String& x, Gtk::Widget* y);
460
461         //std::map<synfig::String,Gtk::Widget*>& tree_view_book() { return tree_view_book_; }
462         //std::map<synfig::String,Gtk::Widget*>& ext_widget_book() { return tree_view_book_; }
463
464         void popup_main_menu();
465
466         Smach& get_smach() { return smach_; }
467
468         const Smach& get_smach()const { return smach_; }
469
470         Smach::event_result process_event_key(EventKey x);
471
472         void popup_layer_menu(synfig::Layer::Handle layer);
473
474         virtual ~CanvasView();
475
476         void set_mode(Mode x) { canvas_interface()->set_mode(x); }
477
478         Mode get_mode()const { return canvas_interface()->get_mode(); }
479
480         Gtk::Adjustment &time_adjustment() { return time_adjustment_; }
481
482         const Gtk::Adjustment &time_adjustment()const { return time_adjustment_; }
483
484         studio::Adjust_Window &time_window_adjustment() { return time_window_adjustment_; }
485
486         const studio::Adjust_Window &time_window_adjustment()const { return time_window_adjustment_; }
487
488         etl::handle<synfigapp::UIInterface> get_ui_interface() { return ui_interface_;}
489
490         etl::handle<synfigapp::SelectionManager> get_selection_manager() { return selection_manager_; }
491
492         Glib::RefPtr<Gtk::TreeModel> layer_tree_store() { return get_tree_model("layers"); }
493
494         Glib::RefPtr<const Gtk::TreeModel> layer_tree_store()const { return get_tree_model("layers"); }
495
496         Glib::RefPtr<Gtk::TreeModel> children_tree_store() { return get_tree_model("children"); }
497
498         Glib::RefPtr<const Gtk::TreeModel> children_tree_store()const { return get_tree_model("children"); }
499
500         Glib::RefPtr<Gtk::TreeModel> keyframe_tree_store() { return get_tree_model("keyframes"); }
501
502         Glib::RefPtr<const Gtk::TreeModel> keyframe_tree_store()const { return get_tree_model("keyframes"); }
503
504         void set_time(synfig::Time t) { canvas_interface_->set_time(t); }
505
506         synfig::Time get_time() { return canvas_interface_->get_time(); }
507
508         etl::handle<synfig::Canvas> get_canvas()const { return canvas_interface_->get_canvas(); }
509
510         etl::handle<Instance> get_instance()const { return instance_; }
511
512         etl::handle<synfigapp::CanvasInterface> canvas_interface() { return canvas_interface_; }
513
514         etl::handle<const synfigapp::CanvasInterface> canvas_interface()const { return canvas_interface_; }
515
516         void add_actions_to_menu(Gtk::Menu *menu,   const synfigapp::Action::ParamList &param_list, synfigapp::Action::Category category=synfigapp::Action::CATEGORY_ALL)const;
517
518         //! Updates the title of the window
519         void update_title();
520
521         //! Closes this document
522         bool close_instance();
523
524         //! Closes this canvas view
525         bool close_view();
526
527         //!     Stops the currently executing action
528         /*! \see get_cancel_status(), reset_cancel_status(), IsWorking */
529         void stop() { cancel=true; }
530
531         //! Returns the cancel status
532         /*! \see stop(), reset_cancel_status(), IsWorking */
533         bool get_cancel_status()const { return cancel; }
534
535         //! Resets the cancel status
536         /*! \see stop(), get_cancel_status(), IsWorking */
537         void reset_cancel_status() { cancel=false; }
538
539         void new_child_canvas();
540
541         //! Rebuilds layer_tree_store_ from the Canvas. Maintains selected items.
542         void rebuild_tables();
543
544         //! Builds layer_tree_store_ from the Canvas. Does not maintain selected items.
545         void build_tables();
546
547         //! Refreshes the data for the tables
548         void refresh_tables();
549
550         //void rebuild_layer_table();
551         //void build_layer_table();
552         //void refresh_layer_table();
553
554 //      void rebuild_canvas_table();
555 //      void build_canvas_table();
556 //      void refresh_canvas_table();
557
558 //      void rebuild_valuenode_table();
559 //      void build_valuenode_table();
560 //      void refresh_valuenode_table();
561
562         //! \writeme
563         void rebuild_ducks();
564
565         //bool add_to_ducks(synfigapp::ValueDesc value_desc, synfig::ParamDesc *param_desc=NULL);
566
567         //! Starts "playing" the animation in real-time
568         void play();
569
570         //! Shows the tables (Layer/Children)
571         void show_tables();
572
573         //! Hides the tables (Layer/Children)
574         void hide_tables();
575
576         //! Toggles the tables
577         void toggle_tables();
578
579         //! Gets the table status
580         bool tables_are_visible();
581
582         //! Shows the time bar
583         void show_timebar();
584
585         //! Hides the time bar
586         void hide_timebar();
587
588         //t Enables or disables interaction with the timebar
589         void set_sensitive_timebar(bool sensitive);
590
591         void time_zoom_in();
592         void time_zoom_out();
593
594         void add_layer(synfig::String x);
595
596         void show_keyframe_dialog();
597
598         void play_audio(float t);
599         void stop_audio();
600
601         void image_import();
602
603         void on_waypoint_clicked_canvasview(synfigapp::ValueDesc,std::set<synfig::Waypoint,std::less<synfig::UniqueID> >, int button);
604
605         void preview_option() {on_preview_option();}
606
607         void present();
608
609         bool is_playing() { return is_playing_; }
610
611         void update_quality();
612
613         /*
614  -- ** -- S I G N A L   T E R M I N A L S -------------------------------------
615         */
616
617 private:
618
619         void on_select_layers();
620         void on_unselect_layers();
621
622         void on_input_device_changed(GdkDevice*);
623
624         virtual void on_hide();
625
626         virtual bool on_focus_in_event(GdkEventFocus*);
627         virtual bool on_focus_out_event(GdkEventFocus*);
628
629         //bool on_children_tree_event(GdkEvent *event);
630
631         bool on_keyframe_tree_event(GdkEvent *event);
632
633         //void on_children_edited_value(const Glib::ustring&path_string,synfig::ValueBase value);
634
635         void on_dirty_preview();
636
637         bool on_children_user_click(int, Gtk::TreeRow, ChildrenTree::ColumnID);
638
639         bool on_layer_user_click(int, Gtk::TreeRow, LayerTree::ColumnID);
640
641 //      void on_layer_toggle(const Glib::ustring& path_string, Gtk::TreeModelColumn<bool> column);
642
643         void on_mode_changed(synfigapp::CanvasInterface::Mode mode);
644
645 //      void on_layer_waypoint_clicked(const Glib::ustring &, synfig::ValueNode_Animated::WaypointList::iterator);
646
647         //void on_children_waypoint_clicked(const Glib::ustring &, synfig::ValueNode_Animated::WaypointList::iterator);
648
649         void on_waypoint_changed();
650
651         void on_waypoint_delete();
652
653         void on_refresh_pressed();
654
655         void on_id_changed();
656
657         void on_time_changed();
658
659         /*
660         void on_layer_raise_pressed();
661         void on_layer_lower_pressed();
662         void on_layer_duplicate_pressed();
663         void on_layer_delete_pressed();
664         */
665
666         void on_keyframe_add_pressed();
667
668         void on_keyframe_duplicate_pressed();
669
670         void on_keyframe_remove_pressed();
671
672         void on_animate_button_pressed();
673
674         void on_keyframe_button_pressed();
675
676         void on_preview_option();
677         void on_preview_create(const PreviewInfo &);
678
679         void on_audio_option();
680         void on_audio_file_change(const std::string &f);
681         void on_audio_offset_change(const synfig::Time &t);
682
683         void on_audio_file_notify();
684         void on_audio_offset_notify();
685
686         bool on_duck_changed(const synfig::Point &value,const synfigapp::ValueDesc& value_desc);
687         bool on_duck_angle_changed(const synfig::Angle &rotation,const synfigapp::ValueDesc& value_desc);
688
689         void on_layer_toggle(synfig::Layer::Handle);
690
691         void on_edited_value(synfigapp::ValueDesc,synfig::ValueBase);
692
693         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);
694
695         //void on_audio_play();
696         bool on_audio_scrub();
697
698         void on_play_stop_pressed();
699
700 protected:
701         bool close_instance_when_safe();
702         bool on_delete_event(GdkEventAny* event);
703
704         /*
705  -- ** -- S T A T I C   P U B L I C   M E T H O D S ---------------------------
706         */
707
708 public:
709
710         static etl::handle<studio::CanvasView> create(etl::loose_handle<Instance> instance,etl::handle<synfig::Canvas> canvas);
711         static std::list<int>& get_pixel_sizes();
712
713 }; // END of class CanvasView
714
715 }; // END of namespace studio
716
717 /* === E N D =============================================================== */
718
719 #endif