Added copyright lines for files I've edited this year.
[synfig.git] / synfig-studio / trunk / src / synfigapp / canvasinterface.cpp
1 /* === S Y N F I G ========================================================= */
2 /*!     \file canvasinterface.cpp
3 **      \brief Template File
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 /* === H E A D E R S ======================================================= */
25
26 #ifdef USING_PCH
27 #       include "pch.h"
28 #else
29 #ifdef HAVE_CONFIG_H
30 #       include <config.h>
31 #endif
32
33 //#include <iostream>
34
35 #include <ETL/clock>
36 #include <synfig/valuenode_scale.h>
37 #include <synfig/valuenode_timedswap.h>
38 #include <synfig/valuenode_composite.h>
39 #include <synfig/valuenode_subtract.h>
40 #include <synfig/valuenode_linear.h>
41 #include <synfig/valuenode_reference.h>
42 #include <synfig/valuenode_twotone.h>
43 #include <synfig/valuenode_stripes.h>
44
45 #include <synfig/waypoint.h>
46 #include <synfig/loadcanvas.h>
47 #include <synfig/importer.h>
48 #include <synfig/guidset.h>
49
50 #include "canvasinterface.h"
51 #include "instance.h"
52
53 #include "actions/layeradd.h"
54 #include "actions/valuedescconvert.h"
55 #include "actions/valuenodeadd.h"
56 #include "actions/editmodeset.h"
57 #include "action_system.h"
58
59 #include "main.h"
60
61 #include <synfig/gradient.h>
62
63 #include "general.h"
64
65 #endif
66
67 /* === U S I N G =========================================================== */
68
69 using namespace std;
70 using namespace etl;
71 using namespace synfig;
72 using namespace synfigapp;
73
74 /* === M A C R O S ========================================================= */
75
76 /* === G L O B A L S ======================================================= */
77
78 /* === P R O C E D U R E S ================================================= */
79
80 /* === M E T H O D S ======================================================= */
81
82 CanvasInterface::CanvasInterface(etl::loose_handle<Instance> instance,etl::handle<synfig::Canvas> canvas):
83         instance_(instance),
84         canvas_(canvas),
85         cur_time_(canvas->rend_desc().get_frame_start()),
86         mode_(MODE_NORMAL|MODE_ANIMATE_PAST|MODE_ANIMATE_FUTURE)
87 {
88         set_selection_manager(get_instance()->get_selection_manager());
89         set_ui_interface(get_instance()->get_ui_interface());
90 }
91
92 CanvasInterface::~CanvasInterface()
93 {
94         if (getenv("SYNFIG_DEBUG_DESTRUCTORS"))
95                 synfig::info("CanvasInterface::~CanvasInterface(): Deleted");
96 }
97
98 void
99 CanvasInterface::set_time(synfig::Time x)
100 {
101         if(get_canvas()->rend_desc().get_frame_rate())
102         {
103                 float fps(get_canvas()->rend_desc().get_frame_rate());
104                 Time r(x.round(fps));
105                 //synfig::info("CanvasInterface::set_time(): %s rounded to %s\n",x.get_string(fps).c_str(),r.get_string(fps).c_str());
106                 x=r;
107         }
108         if(cur_time_.is_equal(x))
109                 return;
110         get_canvas()->set_time(cur_time_=x);
111
112         // update the time in all the child canvases
113         Canvas::Children children = get_canvas()->get_root()->children();
114         handle<CanvasInterface> interface;
115         for (Canvas::Children::iterator iter = children.begin(); iter != children.end(); iter++)
116                 if ((interface = get_instance()->find_canvas_interface(*iter)) != this)
117                         interface->set_time(interface->get_canvas()->get_time());
118
119         signal_time_changed()();
120         signal_dirty_preview()();
121 }
122
123 synfig::Time
124 CanvasInterface::get_time()const
125 {
126         return cur_time_;
127 }
128
129 void
130 CanvasInterface::refresh_current_values()
131 {
132         get_canvas()->set_time(cur_time_);
133         signal_time_changed()();
134         signal_dirty_preview()();
135 }
136
137 etl::handle<CanvasInterface>
138 CanvasInterface::create(etl::loose_handle<Instance> instance, etl::handle<synfig::Canvas> canvas)
139 {
140         etl::handle<CanvasInterface> intrfc;
141         intrfc=new CanvasInterface(instance,canvas);
142         instance->canvas_interface_list().push_front(intrfc);
143         return intrfc;
144 }
145
146 void
147 CanvasInterface::set_mode(Mode x)
148 {
149         Action::Handle  action(Action::EditModeSet::create());
150
151         assert(action);
152
153         action->set_param("canvas",get_canvas());
154         action->set_param("canvas_interface",etl::loose_handle<CanvasInterface>(this));
155         action->set_param("edit_mode",x);
156
157         if(!action->is_ready())
158         {
159                 get_ui_interface()->error(_("Action Not Ready, unable to change mode"));
160                 assert(0);
161                 return;
162         }
163
164         if(!get_instance()->perform_action(action))
165                 get_ui_interface()->error(_("Unable to change mode"));
166
167 //      mode_=x;
168 //      signal_mode_changed_(x);
169 }
170
171 CanvasInterface::Mode
172 CanvasInterface::get_mode()const
173 {
174         return mode_;
175 }
176
177
178
179 Layer::Handle
180 CanvasInterface::add_layer_to(synfig::String name, synfig::Canvas::Handle canvas, int depth)
181 {
182         synfigapp::Action::PassiveGrouper group(get_instance().get(),_("Add Layer To"));
183
184         Layer::Handle   layer(Layer::create(name));
185
186         assert(layer);
187
188         if(!layer)
189                 return 0;
190
191         if(canvas!=get_canvas() && !canvas->is_inline())
192         {
193                 synfig::error("Bad canvas passed to \"add_layer_to\"");
194                 return 0;
195         }
196
197         // automatically export the Index parameter of new Duplicate layers
198         if (name == "duplicate")
199                 for (int i = 1; ; i++)
200                 {
201                         String name = strprintf(_("Index %d"), i);
202                         try
203                         {
204                                 canvas->find_value_node(name);
205                         }
206                         catch (Exception::IDNotFound x)
207                         {
208                                 add_value_node(layer->dynamic_param_list().find("index")->second, name);
209                                 break;
210                         }
211                 }
212
213         layer->set_canvas(canvas);
214
215         // Apply some defaults
216         if(layer->set_param("fg",synfigapp::Main::get_foreground_color()))
217                 layer->set_param("bg",synfigapp::Main::get_background_color());
218         else
219                 layer->set_param("color",synfigapp::Main::get_foreground_color());
220
221         layer->set_param("width",synfigapp::Main::get_bline_width().units(get_canvas()->rend_desc()));
222         layer->set_param("gradient",synfigapp::Main::get_gradient());
223         if(name!="zoom")
224                 layer->set_param("amount",synfigapp::Main::get_opacity());
225         layer->set_param("blend_method",synfigapp::Main::get_blend_method());
226
227         {
228                 // Grab the layer's list of parameters
229                 Layer::ParamList paramlist=layer->get_param_list();
230                 Layer::ParamList::iterator iter;
231                 for(iter=paramlist.begin();iter!=paramlist.end();++iter)
232                 {
233                         ValueNode::Handle value_node;
234
235                         if(iter->second.get_type()==ValueBase::TYPE_LIST)
236                                 value_node=LinkableValueNode::create("dynamic_list",iter->second);
237                         else if(LinkableValueNode::check_type("composite",iter->second.get_type()) &&
238                                 (iter->second.get_type()!=ValueBase::TYPE_COLOR && iter->second.get_type()!=ValueBase::TYPE_VECTOR)
239                         )
240                                 value_node=LinkableValueNode::create("composite",iter->second);
241
242                         if(value_node)
243                                 layer->connect_dynamic_param(iter->first,value_node);
244                 }
245         }
246
247         // Action to add the layer
248         Action::Handle  action(Action::LayerAdd::create());
249
250         assert(action);
251         if(!action)
252                 return 0;
253
254         action->set_param("canvas",canvas);
255         action->set_param("canvas_interface",etl::loose_handle<CanvasInterface>(this));
256         action->set_param("new",layer);
257
258         if(!action->is_ready())
259         {
260                 get_ui_interface()->error(_("Action Not Ready"));
261                 return 0;
262         }
263
264         if(!get_instance()->perform_action(action))
265         {
266                 get_ui_interface()->error(_("Action Failed."));
267                 return 0;
268         }
269
270         // synfig::info("DEPTH=%d",depth);
271
272         // Action to move the layer (if necessary)
273         if(depth>0)
274         {
275                 Action::Handle  action(Action::create("layer_move"));
276
277                 assert(action);
278                 if(!action)
279                         return 0;
280
281                 action->set_param("canvas",canvas);
282                 action->set_param("canvas_interface",etl::loose_handle<CanvasInterface>(this));
283                 action->set_param("layer",layer);
284                 action->set_param("new_index",depth);
285
286                 if(!action->is_ready())
287                 {
288                         get_ui_interface()->error(_("Move Action Not Ready"));
289                         return 0;
290                 }
291
292                 if(!get_instance()->perform_action(action))
293                 {
294                         get_ui_interface()->error(_("Move Action Failed."));
295                         return 0;
296                 }
297         }
298
299
300         return layer;
301 }
302
303
304 bool
305 CanvasInterface::convert(ValueDesc value_desc, synfig::String type)
306 {
307         Action::Handle  action(Action::ValueDescConvert::create());
308
309         assert(action);
310         if(!action)
311                 return 0;
312
313         action->set_param("canvas",get_canvas());
314         action->set_param("canvas_interface",etl::loose_handle<CanvasInterface>(this));
315         action->set_param("value_desc",value_desc);
316         action->set_param("type",type);
317         action->set_param("time",get_time());
318
319         if(!action->is_ready())
320         {
321                 get_ui_interface()->error(_("Action Not Ready"));
322                 return 0;
323         }
324
325         if(get_instance()->perform_action(action))
326                 return true;
327
328         get_ui_interface()->error(_("Action Failed."));
329         return false;
330 }
331
332 bool
333 CanvasInterface::add_value_node(synfig::ValueNode::Handle value_node, synfig::String name)
334 {
335         if(name.empty())
336         {
337                 get_ui_interface()->error(_("Empty name!"));
338                 return false;
339         }
340
341         Action::Handle  action(Action::ValueNodeAdd::create());
342
343         assert(action);
344         if(!action)
345                 return 0;
346
347         action->set_param("canvas",get_canvas());
348         action->set_param("canvas_interface",etl::loose_handle<CanvasInterface>(this));
349         action->set_param("new",value_node);
350         action->set_param("name",name);
351
352         if(!action->is_ready())
353         {
354                 get_ui_interface()->error(_("Action Not Ready"));
355                 return 0;
356         }
357
358         if(get_instance()->perform_action(action))
359                 return true;
360
361         get_ui_interface()->error(_("Action Failed."));
362         return false;
363 }
364
365 Action::ParamList
366 CanvasInterface::generate_param_list(const ValueDesc &value_desc)
367 {
368         synfigapp::Action::ParamList param_list;
369         param_list.add("time",get_time());
370         param_list.add("canvas_interface",etl::handle<CanvasInterface>(this));
371         param_list.add("canvas",get_canvas());
372
373         param_list.add("value_desc",value_desc);
374
375         if(value_desc.parent_is_value_node())
376                 param_list.add("parent_value_node",value_desc.get_parent_value_node());
377
378         if(value_desc.is_value_node())
379                 param_list.add("value_node",value_desc.get_value_node());
380
381         if(value_desc.is_const())
382         {
383                 // Fix 1868911: if we put a ValueBase holding a Canvas handle
384                 // into the param_list and then export the canvas, the handle
385                 // will miss out of having its reference count reduced,
386                 // because by the time the handle is destructed the canvas
387                 // will no longer be inline.  So let's not propogate that
388                 // ValueBase any further than here.
389                 if (value_desc.get_value_type() == ValueBase::TYPE_CANVAS)
390                         param_list.add("value",Canvas::LooseHandle(value_desc.get_value().get(Canvas::LooseHandle())));
391                 else
392                         param_list.add("value",value_desc.get_value());
393         }
394
395         if(value_desc.parent_is_layer_param())
396         {
397                 param_list.add("parent_layer",value_desc.get_layer());
398                 param_list.add("parent_layer_param",value_desc.get_param_name());
399         }
400
401         {
402                 synfigapp::SelectionManager::ChildrenList children_list;
403                 children_list=get_selection_manager()->get_selected_children();
404                 if(!value_desc.parent_is_canvas() && children_list.size()==1)
405                 {
406                         param_list.add("dest",value_desc);
407                         param_list.add("src",children_list.front().get_value_node());
408                 }
409         }
410         return param_list;
411 }
412
413 Action::ParamList
414 CanvasInterface::generate_param_list(const std::list<synfigapp::ValueDesc> &value_desc_list)
415 {
416         synfigapp::Action::ParamList param_list;
417         param_list.add("time",get_time());
418         param_list.add("canvas_interface",etl::handle<CanvasInterface>(this));
419         param_list.add("canvas",get_canvas());
420
421         std::list<synfigapp::ValueDesc>::const_iterator iter;
422         for(iter=value_desc_list.begin();iter!=value_desc_list.end();++iter)
423         {
424                 param_list.add("value_desc",*iter);
425                 if(iter->is_value_node())
426                 {
427                         param_list.add("value_node",iter->get_value_node());
428                 }
429         }
430
431
432         return param_list;
433 }
434
435 void
436 CanvasInterface::set_rend_desc(const synfig::RendDesc &rend_desc)
437 {
438         Action::Handle  action(Action::create("canvas_rend_desc_set"));
439
440         assert(action);
441         if(!action)
442                 return;
443
444         action->set_param("canvas",get_canvas());
445         action->set_param("canvas_interface",etl::loose_handle<CanvasInterface>(this));
446         action->set_param("rend_desc",rend_desc);
447
448         if(!get_instance()->perform_action(action))
449                 get_ui_interface()->error(_("Action Failed."));
450 }
451
452 bool
453 CanvasInterface::set_name(const synfig::String &x)
454 {
455         //! \todo This needs to be converted into an action
456         get_canvas()->set_name(x);
457         signal_id_changed_();
458         return true;
459 }
460
461 bool
462 CanvasInterface::set_description(const synfig::String &x)
463 {
464         //! \todo This needs to be converted into an action
465         get_canvas()->set_description(x);
466         return true;
467 }
468
469 bool
470 CanvasInterface::set_id(const synfig::String &x)
471 {
472         //! \todo This needs to be converted into an action
473         get_canvas()->set_id(x);
474         signal_id_changed_();
475         return true;
476 }
477
478
479 void
480 CanvasInterface::jump_to_next_keyframe()
481 {
482         synfig::info("Current time: %s",get_time().get_string().c_str());
483         try
484         {
485                 synfig::Keyframe keyframe(*get_canvas()->keyframe_list().find_next(get_time()));
486                 synfig::info("Jumping to keyframe \"%s\" at %s",keyframe.get_description().c_str(),keyframe.get_time().get_string().c_str());
487                 set_time(keyframe.get_time());
488         }
489         catch(...) { synfig::warning("Unable to find next keyframe"); }
490 }
491
492 void
493 CanvasInterface::jump_to_prev_keyframe()
494 {
495         synfig::info("Current time: %s",get_time().get_string().c_str());
496         try
497         {
498                 synfig::Keyframe keyframe(*get_canvas()->keyframe_list().find_prev(get_time()));
499                 synfig::info("Jumping to keyframe \"%s\" at %s",keyframe.get_description().c_str(),keyframe.get_time().get_string().c_str());
500                 set_time(keyframe.get_time());
501         }
502         catch(...) { synfig::warning("Unable to find prev keyframe"); }
503 }
504
505 bool
506 CanvasInterface::import(const synfig::String &filename, bool /*copy*/)
507 {
508         Action::PassiveGrouper group(get_instance().get(),_("Import Image"));
509
510         synfig::info("Attempting to import "+filename);
511
512         if (filename_extension(filename) == "")
513         {
514                 get_ui_interface()->error(_("Filename must have an extension!"));
515                 return false;
516         }
517
518         String ext(filename_extension(filename));
519         if (ext.size()) ext = ext.substr(1); // skip initial '.'
520         std::transform(ext.begin(),ext.end(),ext.begin(),&::tolower);
521
522         // If this is a SIF file, then we need to do things slightly differently
523         if(ext=="sif" || ext=="sifz")try
524         {
525
526                 Canvas::Handle outside_canvas(synfig::open_canvas(filename));
527                 if(!outside_canvas)
528                         throw String(_("Unable to open this composition"));
529
530                 Layer::Handle layer(add_layer_to("PasteCanvas",get_canvas()));
531                 if(!layer)
532                         throw String(_("Unable to create \"Paste Canvas\" layer"));
533                 if(!layer->set_param("canvas",ValueBase(outside_canvas)))
534                         throw int();
535
536                 //layer->set_description(basename(filename));
537                 signal_layer_new_description()(layer,filename);
538                 return true;
539         }
540         catch(String x)
541         {
542                 get_ui_interface()->error(x+" -- "+filename);
543                 return false;
544         }
545         catch(...)
546         {
547                 get_ui_interface()->error(_("Uncaught exception when attempting\nto open this composition -- ")+filename);
548                 return false;
549         }
550
551         if(!Importer::book().count(ext))
552         {
553                 get_ui_interface()->error(_("I don't know how to open images of this type -- ")+ext);
554                 return false;
555         }
556
557         try
558         {
559                 Layer::Handle layer(add_layer_to("Import",get_canvas()));
560                 int w,h;
561                 if(!layer)
562                         throw int();
563                 if(!layer->set_param("filename",ValueBase(filename)))
564                         throw int();
565                 w=layer->get_param("_width").get(int());
566                 h=layer->get_param("_height").get(int());
567                 if(w&&h)
568                 {
569                         Vector size=ValueBase(get_canvas()->rend_desc().get_br()-get_canvas()->rend_desc().get_tl());
570                         Vector x;
571                         if(size[0]<size[1])
572                         {
573                                 x[0]=size[0];
574                                 x[1]=size[0]/w*h;
575                                 if((size[0]<0) ^ (size[1]<0))
576                                         x[1]=-x[1];
577                         }
578                         else
579                         {
580                                 x[1]=size[1];
581                                 x[0]=size[1]/h*w;
582                                 if((size[0]<0) ^ (size[1]<0))
583                                         x[0]=-x[0];
584                         }
585                         if(!layer->set_param("tl",ValueBase(-x/2)))
586                                 throw int();
587                         if(!layer->set_param("br",ValueBase(x/2)))
588                                 throw int();
589                 }
590                 else
591                 {
592                         if(!layer->set_param("tl",ValueBase(get_canvas()->rend_desc().get_tl())))
593                                 throw int();
594                         if(!layer->set_param("br",ValueBase(get_canvas()->rend_desc().get_br())))
595                                 throw int();
596                 }
597
598                 layer->set_description(basename(filename));
599                 signal_layer_new_description()(layer,filename);
600
601                 return true;
602         }
603         catch(...)
604         {
605                 get_ui_interface()->error("Unable to import "+filename);
606                 group.cancel();
607                 return false;
608         }
609 }
610
611
612 void
613 CanvasInterface::waypoint_duplicate(synfigapp::ValueDesc value_desc,synfig::Waypoint waypoint)
614 {
615         ValueNode::Handle value_node();
616         waypoint_duplicate(value_desc.get_value_node(), waypoint);
617 }
618
619 void
620 CanvasInterface::waypoint_duplicate(ValueNode::Handle value_node,synfig::Waypoint waypoint)
621 {
622         Action::Handle  action(Action::create("waypoint_set_smart"));
623
624         assert(action);
625         if(!action)
626                 return;
627
628         waypoint.make_unique();
629         waypoint.set_time(get_time());
630
631         action->set_param("canvas",get_canvas());
632         action->set_param("canvas_interface",etl::loose_handle<CanvasInterface>(this));
633         action->set_param("waypoint",waypoint);
634         action->set_param("time",get_time());
635         action->set_param("value_node",value_node);
636
637         if(!get_instance()->perform_action(action))
638                 get_ui_interface()->error(_("Action Failed."));
639 }
640
641 void
642 CanvasInterface::waypoint_remove(synfigapp::ValueDesc value_desc,synfig::Waypoint waypoint)
643 {
644         ValueNode::Handle value_node();
645         waypoint_remove(value_desc.get_value_node(), waypoint);
646 }
647
648 void
649 CanvasInterface::waypoint_remove(ValueNode::Handle value_node,synfig::Waypoint waypoint)
650 {
651         Action::Handle  action(Action::create("waypoint_remove"));
652
653         assert(action);
654         if(!action)
655                 return;
656
657         action->set_param("canvas",get_canvas());
658         action->set_param("canvas_interface",etl::loose_handle<CanvasInterface>(this));
659         action->set_param("waypoint",waypoint);
660         action->set_param("value_node",value_node);
661
662         if(!get_instance()->perform_action(action))
663                 get_ui_interface()->error(_("Action Failed."));
664 }
665
666
667 void
668 CanvasInterface::auto_export(synfig::ValueNode::Handle /*value_node*/)
669 {
670 /*
671         // Check to see if we are already exported.
672         if(value_node->is_exported())
673                 return;
674
675         Action::Handle  action(Action::create("value_node_add"));
676
677         assert(action);
678         if(!action)
679                 return;
680
681         String name(strprintf(_("Unnamed%08d"),synfig::UniqueID().get_uid()));
682
683         action->set_param("canvas",get_canvas());
684         action->set_param("canvas_interface",etl::loose_handle<CanvasInterface>(this));
685         action->set_param("new",value_node);
686         action->set_param("name",name);
687
688         if(!get_instance()->perform_action(action))
689                 get_ui_interface()->error(_("Action Failed."));
690 */
691 }
692
693 void
694 CanvasInterface::auto_export(const ValueDesc& /*value_desc*/)
695 {
696         // THIS FUNCTION IS DEPRECATED, AND IS NOW A STUB.
697 #if 0
698         // Check to see if we are already exported.
699         if(value_desc.is_exported())
700                 return;
701
702         Action::Handle  action(Action::create("value_desc_export"));
703
704         assert(action);
705         if(!action)
706                 return;
707
708         String name(strprintf(_("Unnamed%08d"),synfig::UniqueID().get_uid()));
709
710         action->set_param("canvas",get_canvas());
711         action->set_param("canvas_interface",etl::loose_handle<CanvasInterface>(this));
712         action->set_param("value_desc",value_desc);
713         action->set_param("name",name);
714
715         if(!get_instance()->perform_action(action))
716                 get_ui_interface()->error(_("Action Failed."));
717 #endif
718 }
719
720 bool
721 CanvasInterface::change_value(synfigapp::ValueDesc value_desc,synfig::ValueBase new_value)
722 {
723         // If this isn't really a change, then don't bother
724         if(new_value==value_desc.get_value(get_time()))
725                 return true;
726
727         // If this change needs to take place elsewhere, then so be it.
728         if(value_desc.get_canvas() && value_desc.get_canvas()->get_root()!=get_canvas()->get_root())do
729         {
730                 etl::handle<Instance> instance;
731                 instance=find_instance(value_desc.get_canvas()->get_root());
732
733                 if(instance)
734                         return instance->find_canvas_interface(value_desc.get_canvas())->change_value(value_desc,new_value);
735                 else
736                 {
737                         get_ui_interface()->error(_("The value you are trying to edit is in a composition\nwhich doesn't seem to be open. Open that composition and you\nshould be able to edit this value as normal."));
738                         return false;
739                 }
740         }while(0);
741 #ifdef _DEBUG
742         else
743         { synfig::warning("Can't get canvas from value desc...?"); }
744 #endif
745
746         synfigapp::Action::Handle action(synfigapp::Action::create("value_desc_set"));
747         if(!action)
748         {
749                 return false;
750         }
751
752         action->set_param("canvas",get_canvas());
753         action->set_param("canvas_interface",etl::loose_handle<CanvasInterface>(this));
754         action->set_param("time",get_time());
755         action->set_param("value_desc",value_desc);
756         action->set_param("new_value",new_value);
757
758         return get_instance()->perform_action(action);
759 }
760
761 void
762 CanvasInterface::set_meta_data(const synfig::String& key,const synfig::String& data)
763 {
764         get_canvas()->set_meta_data(key,data);
765 }
766
767
768 // this function goes with find_important_value_descs()
769 static int
770 _process_value_desc(const synfigapp::ValueDesc& value_desc,std::vector<synfigapp::ValueDesc>& out, synfig::GUIDSet& guid_set)
771 {
772         int ret(0);
773
774         if(value_desc.get_value_type()==ValueBase::TYPE_CANVAS)
775         {
776                 Canvas::Handle canvas;
777                 canvas=value_desc.get_value().get(canvas);
778                 if(!canvas || !canvas->is_inline())
779                         return ret;
780                 ret+=CanvasInterface::find_important_value_descs(canvas,out,guid_set);
781         }
782
783         if(value_desc.is_value_node())
784         {
785                 ValueNode::Handle value_node(value_desc.get_value_node());
786
787                 if(guid_set.count(value_node->get_guid()))
788                         return ret;
789                 guid_set.insert(value_node->get_guid());
790
791                 if(LinkableValueNode::Handle::cast_dynamic(value_node))
792                 {
793                         if(ValueNode_DynamicList::Handle::cast_dynamic(value_node))
794                         {
795                                 out.push_back(value_desc);
796                                 ret++;
797                         }
798                         // Process the linkable ValueNode's children
799                         LinkableValueNode::Handle value_node_copy(LinkableValueNode::Handle::cast_dynamic(value_node));
800                         int i;
801                         for(i=0;i<value_node_copy->link_count();i++)
802                         {
803                                 ValueNode::Handle link(value_node_copy->get_link(i));
804                                 if(!link->is_exported())
805                                         ret+=_process_value_desc(ValueDesc(value_node_copy,i),out,guid_set);
806                         }
807                 }
808                 else if(ValueNode_Animated::Handle::cast_dynamic(value_node))
809                 {
810                         out.push_back(value_desc);
811                         ret++;
812                 }
813         }
814
815         return ret;
816 }
817
818 int
819 CanvasInterface::find_important_value_descs(synfig::Canvas::Handle canvas,std::vector<synfigapp::ValueDesc>& out,synfig::GUIDSet& guid_set)
820 {
821         int ret(0);
822         if(!canvas->is_inline())
823         {
824                 ValueNodeList::const_iterator iter;
825
826                 for(
827                         iter=canvas->value_node_list().begin();
828                         iter!=canvas->value_node_list().end();
829                         ++iter)
830                         ret+=_process_value_desc(ValueDesc(canvas,(*iter)->get_id()),out,guid_set);
831         }
832
833         Canvas::const_iterator iter;
834
835         for(iter=canvas->begin();iter!=canvas->end();++iter)
836         {
837                 Layer::Handle layer(*iter);
838
839                 Layer::DynamicParamList::const_iterator iter;
840                 for(
841                         iter=layer->dynamic_param_list().begin();
842                         iter!=layer->dynamic_param_list().end();
843                         ++iter)
844                 {
845                         if(!iter->second->is_exported())
846                                 ret+=_process_value_desc(ValueDesc(layer,iter->first),out,guid_set);
847                 }
848                 ValueBase value(layer->get_param("canvas"));
849                 if(value.is_valid())
850                         ret+=_process_value_desc(ValueDesc(layer,"canvas"),out,guid_set);
851         }
852
853         return ret;
854 }
855
856 int
857 CanvasInterface::find_important_value_descs(std::vector<synfigapp::ValueDesc>& out)
858 {
859         synfig::GUIDSet tmp;
860         return find_important_value_descs(get_canvas(),out,tmp);
861 }
862
863 void
864 CanvasInterface::seek_frame(int frames)
865 {
866         if(!frames)
867                 return;
868         float fps(get_canvas()->rend_desc().get_frame_rate());
869         Time newtime(get_time()+(float)frames/fps);
870         newtime=newtime.round(fps);
871
872         if(newtime<=get_canvas()->rend_desc().get_time_start())
873                 newtime=get_canvas()->rend_desc().get_time_start();
874         if(newtime>=get_canvas()->rend_desc().get_time_end())
875                 newtime=get_canvas()->rend_desc().get_time_end();
876         set_time(newtime);
877 }
878
879 void
880 CanvasInterface::seek_time(synfig::Time time)
881 {
882         if(!time)
883                 return;
884
885         float fps(get_canvas()->rend_desc().get_frame_rate());
886
887         if(time>=synfig::Time::end())
888         {
889                 set_time(get_canvas()->rend_desc().get_time_end());
890                 return;
891         }
892         if(time<=synfig::Time::begin())
893         {
894                 set_time(get_canvas()->rend_desc().get_time_start());
895                 return;
896         }
897
898         Time newtime(get_time()+time);
899         newtime=newtime.round(fps);
900
901         if(newtime<=get_canvas()->rend_desc().get_time_start())
902                 newtime=get_canvas()->rend_desc().get_time_start();
903         if(newtime>=get_canvas()->rend_desc().get_time_end())
904                 newtime=get_canvas()->rend_desc().get_time_end();
905         set_time(newtime);
906 }