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(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         Action::Handle  action(Action::create("waypoint_set_smart"));
 616
 617         assert(action);
 618         if(!action)
 619                 return;
 620
 621         waypoint.make_unique();
 622         waypoint.set_time(get_time());
 623
 624         ValueNode::Handle value_node(value_desc.get_value_node());
 625
 626         action->set_param("canvas",get_canvas());
 627         action->set_param("canvas_interface",etl::loose_handle<CanvasInterface>(this));
 628         action->set_param("waypoint",waypoint);
 629         action->set_param("time",get_time());
 630         action->set_param("value_node",value_node);
 631
 632         if(!get_instance()->perform_action(action))
 633                 get_ui_interface()->error(_("Action Failed."));
 634 }
 635
 636 void
 637 CanvasInterface::waypoint_remove(synfigapp::ValueDesc value_desc,synfig::Waypoint waypoint)
 638 {
 639         Action::Handle  action(Action::create("waypoint_remove"));
 640
 641         assert(action);
 642         if(!action)
 643                 return;
 644
 645         ValueNode::Handle value_node(value_desc.get_value_node());
 646
 647         action->set_param("canvas",get_canvas());
 648         action->set_param("canvas_interface",etl::loose_handle<CanvasInterface>(this));
 649         action->set_param("waypoint",waypoint);
 650         action->set_param("value_node",value_node);
 651
 652         if(!get_instance()->perform_action(action))
 653                 get_ui_interface()->error(_("Action Failed."));
 654 }
 655
 656
 657 void
 658 CanvasInterface::auto_export(synfig::ValueNode::Handle /*value_node*/)
 659 {
 660 /*
 661         // Check to see if we are already exported.
 662         if(value_node->is_exported())
 663                 return;
 664
 665         Action::Handle  action(Action::create("value_node_add"));
 666
 667         assert(action);
 668         if(!action)
 669                 return;
 670
 671         String name(strprintf(_("Unnamed%08d"),synfig::UniqueID().get_uid()));
 672
 673         action->set_param("canvas",get_canvas());
 674         action->set_param("canvas_interface",etl::loose_handle<CanvasInterface>(this));
 675         action->set_param("new",value_node);
 676         action->set_param("name",name);
 677
 678         if(!get_instance()->perform_action(action))
 679                 get_ui_interface()->error(_("Action Failed."));
 680 */
 681 }
 682
 683 void
 684 CanvasInterface::auto_export(const ValueDesc& /*value_desc*/)
 685 {
 686         // THIS FUNCTION IS DEPRECATED, AND IS NOW A STUB.
 687 #if 0
 688         // Check to see if we are already exported.
 689         if(value_desc.is_exported())
 690                 return;
 691
 692         Action::Handle  action(Action::create("value_desc_export"));
 693
 694         assert(action);
 695         if(!action)
 696                 return;
 697
 698         String name(strprintf(_("Unnamed%08d"),synfig::UniqueID().get_uid()));
 699
 700         action->set_param("canvas",get_canvas());
 701         action->set_param("canvas_interface",etl::loose_handle<CanvasInterface>(this));
 702         action->set_param("value_desc",value_desc);
 703         action->set_param("name",name);
 704
 705         if(!get_instance()->perform_action(action))
 706                 get_ui_interface()->error(_("Action Failed."));
 707 #endif
 708 }
 709
 710 bool
 711 CanvasInterface::change_value(synfigapp::ValueDesc value_desc,synfig::ValueBase new_value)
 712 {
 713         // If this isn't really a change, then don't bother
 714         if(new_value==value_desc.get_value(get_time()))
 715                 return true;
 716
 717         // If this change needs to take place elsewhere, then so be it.
 718         if(value_desc.get_canvas() && value_desc.get_canvas()->get_root()!=get_canvas()->get_root())do
 719         {
 720                 etl::handle<Instance> instance;
 721                 instance=find_instance(value_desc.get_canvas()->get_root());
 722
 723                 if(instance)
 724                         return instance->find_canvas_interface(value_desc.get_canvas())->change_value(value_desc,new_value);
 725                 else
 726                 {
 727                         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."));
 728                         return false;
 729                 }
 730         }while(0);
 731 #ifdef _DEBUG
 732         else
 733         { synfig::warning("Can't get canvas from value desc...?"); }
 734 #endif
 735
 736         synfigapp::Action::Handle action(synfigapp::Action::create("value_desc_set"));
 737         if(!action)
 738         {
 739                 return false;
 740         }
 741
 742         action->set_param("canvas",get_canvas());
 743         action->set_param("canvas_interface",etl::loose_handle<CanvasInterface>(this));
 744         action->set_param("time",get_time());
 745         action->set_param("value_desc",value_desc);
 746         action->set_param("new_value",new_value);
 747
 748         return get_instance()->perform_action(action);
 749 }
 750
 751 void
 752 CanvasInterface::set_meta_data(const synfig::String& key,const synfig::String& data)
 753 {
 754         get_canvas()->set_meta_data(key,data);
 755 }
 756
 757
 758 // this function goes with find_important_value_descs()
 759 static int
 760 _process_value_desc(const synfigapp::ValueDesc& value_desc,std::vector<synfigapp::ValueDesc>& out, synfig::GUIDSet& guid_set)
 761 {
 762         int ret(0);
 763
 764         if(value_desc.get_value_type()==ValueBase::TYPE_CANVAS)
 765         {
 766                 Canvas::Handle canvas;
 767                 canvas=value_desc.get_value().get(canvas);
 768                 if(!canvas || !canvas->is_inline())
 769                         return ret;
 770                 ret+=CanvasInterface::find_important_value_descs(canvas,out,guid_set);
 771         }
 772
 773         if(value_desc.is_value_node())
 774         {
 775                 ValueNode::Handle value_node(value_desc.get_value_node());
 776
 777                 if(guid_set.count(value_node->get_guid()))
 778                         return ret;
 779                 guid_set.insert(value_node->get_guid());
 780
 781                 if(LinkableValueNode::Handle::cast_dynamic(value_node))
 782                 {
 783                         if(ValueNode_DynamicList::Handle::cast_dynamic(value_node))
 784                         {
 785                                 out.push_back(value_desc);
 786                                 ret++;
 787                         }
 788                         // Process the linkable ValueNode's children
 789                         LinkableValueNode::Handle value_node_copy(LinkableValueNode::Handle::cast_dynamic(value_node));
 790                         int i;
 791                         for(i=0;i<value_node_copy->link_count();i++)
 792                         {
 793                                 ValueNode::Handle link(value_node_copy->get_link(i));
 794                                 if(!link->is_exported())
 795                                         ret+=_process_value_desc(ValueDesc(value_node_copy,i),out,guid_set);
 796                         }
 797                 }
 798                 else if(ValueNode_Animated::Handle::cast_dynamic(value_node))
 799                 {
 800                         out.push_back(value_desc);
 801                         ret++;
 802                 }
 803         }
 804
 805         return ret;
 806 }
 807
 808 int
 809 CanvasInterface::find_important_value_descs(synfig::Canvas::Handle canvas,std::vector<synfigapp::ValueDesc>& out,synfig::GUIDSet& guid_set)
 810 {
 811         int ret(0);
 812         if(!canvas->is_inline())
 813         {
 814                 ValueNodeList::const_iterator iter;
 815
 816                 for(
 817                         iter=canvas->value_node_list().begin();
 818                         iter!=canvas->value_node_list().end();
 819                         ++iter)
 820                         ret+=_process_value_desc(ValueDesc(canvas,(*iter)->get_id()),out,guid_set);
 821         }
 822
 823         Canvas::const_iterator iter;
 824
 825         for(iter=canvas->begin();iter!=canvas->end();++iter)
 826         {
 827                 Layer::Handle layer(*iter);
 828
 829                 Layer::DynamicParamList::const_iterator iter;
 830                 for(
 831                         iter=layer->dynamic_param_list().begin();
 832                         iter!=layer->dynamic_param_list().end();
 833                         ++iter)
 834                 {
 835                         if(!iter->second->is_exported())
 836                                 ret+=_process_value_desc(ValueDesc(layer,iter->first),out,guid_set);
 837                 }
 838                 ValueBase value(layer->get_param("canvas"));
 839                 if(value.is_valid())
 840                         ret+=_process_value_desc(ValueDesc(layer,"canvas"),out,guid_set);
 841         }
 842
 843         return ret;
 844 }
 845
 846 int
 847 CanvasInterface::find_important_value_descs(std::vector<synfigapp::ValueDesc>& out)
 848 {
 849         synfig::GUIDSet tmp;
 850         return find_important_value_descs(get_canvas(),out,tmp);
 851 }
 852
 853 void
 854 CanvasInterface::seek_frame(int frames)
 855 {
 856         if(!frames)
 857                 return;
 858         float fps(get_canvas()->rend_desc().get_frame_rate());
 859         Time newtime(get_time()+(float)frames/fps);
 860         newtime=newtime.round(fps);
 861
 862         if(newtime<=get_canvas()->rend_desc().get_time_start())
 863                 newtime=get_canvas()->rend_desc().get_time_start();
 864         if(newtime>=get_canvas()->rend_desc().get_time_end())
 865                 newtime=get_canvas()->rend_desc().get_time_end();
 866         set_time(newtime);
 867 }
 868
 869 void
 870 CanvasInterface::seek_time(synfig::Time time)
 871 {
 872         if(!time)
 873                 return;
 874
 875         float fps(get_canvas()->rend_desc().get_frame_rate());
 876
 877         if(time>=synfig::Time::end())
 878         {
 879                 set_time(get_canvas()->rend_desc().get_time_end());
 880                 return;
 881         }
 882         if(time<=synfig::Time::begin())
 883         {
 884                 set_time(get_canvas()->rend_desc().get_time_start());
 885                 return;
 886         }
 887
 888         Time newtime(get_time()+time);
 889         newtime=newtime.round(fps);
 890
 891         if(newtime<=get_canvas()->rend_desc().get_time_start())
 892                 newtime=get_canvas()->rend_desc().get_time_start();
 893         if(newtime>=get_canvas()->rend_desc().get_time_end())
 894                 newtime=get_canvas()->rend_desc().get_time_end();
 895         set_time(newtime);
 896 }