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