Added copyright lines for files I've edited this year.
[synfig.git] / synfig-studio / trunk / src / synfigapp / actions / valuedesclink.cpp
index 23d6282..84effe4 100644 (file)
@@ -6,6 +6,7 @@
 **
 **     \legal
 **     Copyright (c) 2002-2005 Robert B. Quattlebaum Jr., Adrian Bentley
+**     Copyright (c) 2007, 2008 Chris Moore
 **
 **     This package is free software; you can redistribute it and/or
 **     modify it under the terms of the GNU General Public License as
@@ -34,6 +35,8 @@
 #include <synfigapp/canvasinterface.h>
 #include <synfig/valuenode_const.h>
 
+#include <synfigapp/general.h>
+
 #endif
 
 using namespace std;
@@ -46,7 +49,7 @@ using namespace Action;
 
 ACTION_INIT(Action::ValueDescLink);
 ACTION_SET_NAME(Action::ValueDescLink,"value_desc_link");
-ACTION_SET_LOCAL_NAME(Action::ValueDescLink,"Link");
+ACTION_SET_LOCAL_NAME(Action::ValueDescLink,N_("Link"));
 ACTION_SET_TASK(Action::ValueDescLink,"connect");
 ACTION_SET_CATEGORY(Action::ValueDescLink,Action::CATEGORY_VALUEDESC);
 ACTION_SET_PRIORITY(Action::ValueDescLink,0);
@@ -59,9 +62,8 @@ ACTION_SET_CVS_ID(Action::ValueDescLink,"$Id$");
 
 /* === M E T H O D S ======================================================= */
 
-Action::ValueDescLink::ValueDescLink()
+Action::ValueDescLink::ValueDescLink(): poison(false), status_level(0)
 {
-       poison=false;
 }
 
 Action::ParamVocab
@@ -92,6 +94,9 @@ Action::ValueDescLink::set_param(const synfig::String& name, const Action::Param
                return true;
        }
 
+       // don't bother looking for the best value to use if there's already been an error
+       if (poison==true) return false;
+
        if(name=="value_desc" && param.get_type()==Param::TYPE_VALUEDESC)
        {
                ValueDesc value_desc(param.get_value_desc());
@@ -104,61 +109,109 @@ Action::ValueDescLink::set_param(const synfig::String& name, const Action::Param
                        if(link_value_node && link_value_node->is_exported())
                        {
                                poison=true;
+                               status_message = (_("Cannot link two different exported values ('") +
+                                                                 value_desc.get_value_node()->get_id() + _("' and '") +
+                                                                 link_value_node->get_id()) + _("')");
                                return false;
                        }
 
                        link_value_node=value_desc.get_value_node();
+                       status_message = _("Used exported ValueNode ('") + link_value_node->get_id() + _("').");
                }
                else if(value_desc.is_value_node())
                {
                        if(!link_value_node)
                        {
+                               status_level = 1;
+                               status_message = _("Using the only available ValueNode.");
                                link_value_node=value_desc.get_value_node();
                        }
-
+                       else if(link_value_node->is_exported())
+                       {
+                               // we've already seen an exported value, so use that rather than the current value
+                       }
                        // Use the one that is referenced more
-                       else if(link_value_node->rcount()<value_desc.get_value_node()->rcount())
+                       else if(link_value_node->rcount()!=value_desc.get_value_node()->rcount())
                        {
-                               link_value_node=value_desc.get_value_node();
+                               if(link_value_node->rcount()<value_desc.get_value_node()->rcount())
+                               {
+                                       status_level = 2;
+                                       status_message = _("Using the most referenced ValueNode.");
+                                       link_value_node=value_desc.get_value_node();
+                               }
+                               else if (status_level <= 2)
+                               {
+                                       status_level = 2;
+                                       status_message = _("Using the most referenced ValueNode.");
+                               }
                        }
-
                        // If the current link value node is a constant and
                        // this one isn't, then give preference to the exotic
                        else if(ValueNode_Const::Handle::cast_dynamic(link_value_node) && !ValueNode_Const::Handle::cast_dynamic(value_desc.get_value_node()))
                        {
+                               status_level = 3;
+                               status_message = _("There's a tie for most referenced; using the animated ValueNode.");
                                link_value_node=value_desc.get_value_node();
                        }
-
-                       // If both are animated, and this one has more waypoints,
-                       // then use the one with more waypoints
-                       else if(
-                                       ValueNode_Animated::Handle::cast_dynamic(link_value_node)
-                               &&      ValueNode_Animated::Handle::cast_dynamic(value_desc.get_value_node())
-                               && (
-                                       ValueNode_Animated::Handle::cast_dynamic(link_value_node)->waypoint_list().size()
-                               <       ValueNode_Animated::Handle::cast_dynamic(value_desc.get_value_node())->waypoint_list().size()
-                               )
-                       )
+                       else if(ValueNode_Const::Handle::cast_dynamic(value_desc.get_value_node()) && !ValueNode_Const::Handle::cast_dynamic(link_value_node))
                        {
-                               link_value_node=value_desc.get_value_node();
+                               if (status_level <= 3)
+                               {
+                                       status_level = 3;
+                                       status_message = _("There's a tie for most referenced; using the animated ValueNode.");
+                               }
                        }
-
-                       /*
-                       // Use the one that was most recently changed
-                       else if(link_value_node->get_time_last_changed()<value_desc.get_value_node()->get_time_last_changed())
+                       // If both are animated, and this one has more waypoints, then use the one with more waypoints
+                       else if(ValueNode_Animated::Handle::cast_dynamic(link_value_node) &&
+                                       ValueNode_Animated::Handle::cast_dynamic(value_desc.get_value_node()) &&
+                                       ValueNode_Animated::Handle::cast_dynamic(link_value_node)->waypoint_list().size() !=
+                                       ValueNode_Animated::Handle::cast_dynamic(value_desc.get_value_node())->waypoint_list().size())
                        {
-                               link_value_node=value_desc.get_value_node();
+                               if (ValueNode_Animated::Handle::cast_dynamic(link_value_node)->waypoint_list().size() <
+                                       ValueNode_Animated::Handle::cast_dynamic(value_desc.get_value_node())->waypoint_list().size())
+                               {
+                                       status_level = 4;
+                                       status_message = _("There's a tie for most referenced, and both are animated; using the one with the most waypoints.");
+                                       link_value_node=value_desc.get_value_node();
+                               }
+                               else if (status_level <= 4)
+                               {
+                                       status_level = 4;
+                                       status_message = _("There's a tie for most referenced, and both are animated; using the one with the most waypoints.");
+                               }
+                       }
+                       // Use the one that was least recently changed
+                       else if(link_value_node->get_time_last_changed()!=value_desc.get_value_node()->get_time_last_changed())
+                       {
+                               if(link_value_node->get_time_last_changed()>value_desc.get_value_node()->get_time_last_changed())
+                               {
+                                       status_level = 5;
+                                       status_message = _("Everything is tied; using the least recently modified value.");
+                                       link_value_node=value_desc.get_value_node();
+                               }
+                               else if (status_level <= 5)
+                               {
+                                       status_level = 5;
+                                       status_message = _("Everything is tied; using the least recently modified value.");
+                               }
+                       }
+                       else
+                       {
+                               status_level = 6;
+                               status_message = _("Absolutely everything is tied.");
                        }
-                       */
                }
 
-
                if(value_desc_list.size() && value_desc.get_value_type()!=value_desc_list.front().get_value_type())
                {
                        // Everything must be of the same type
                        poison=true;
+                       status_message = (strprintf(_("Cannot link two values of different types ('%s' and '%s')"),
+                                                                               ValueBase::type_local_name(value_desc.get_value_type()).c_str(),
+                                                                               ValueBase::type_local_name(value_desc_list.front().get_value_type()).c_str()));
                        return false;
                }
+
                value_desc_list.push_back(value_desc);
 
                return true;
@@ -170,7 +223,9 @@ Action::ValueDescLink::set_param(const synfig::String& name, const Action::Param
 bool
 Action::ValueDescLink::is_ready()const
 {
-       if(poison || value_desc_list.size()<=1)
+       if(poison)
+               return true;
+       if(value_desc_list.size()<=1)
                return false;
        return Action::CanvasSpecific::is_ready();
 }
@@ -178,14 +233,18 @@ Action::ValueDescLink::is_ready()const
 void
 Action::ValueDescLink::prepare()
 {
-       if(poison || value_desc_list.empty())
+       if(poison)
+               throw Error(status_message.c_str());
+
+       if(value_desc_list.empty())
                throw Error(Error::TYPE_NOTREADY);
 
        clear();
 
        if(!link_value_node)
        {
-               ValueDesc& value_desc(value_desc_list.front());
+               status_message = _("No ValueNodes were available, so one was created.");
+               ValueDesc& value_desc(value_desc_list.back());
 
                link_value_node=ValueNode_Const::create(value_desc.get_value(time));
 
@@ -226,7 +285,9 @@ Action::ValueDescLink::prepare()
        {
                ValueDesc& value_desc(*iter);
 
-               if(value_desc.is_value_node() && value_desc.get_value_node()==link_value_node)
+               // only one of the selected items can be exported - that's the one we're linking to
+               // don't link it to itself
+               if (value_desc.is_exported())
                        continue;
 
                Action::Handle action(Action::create("value_desc_connect"));
@@ -242,4 +303,6 @@ Action::ValueDescLink::prepare()
 
                add_action_front(action);
        }
+
+       synfig::info("http://synfig.org/Linking#Tier_%d : %s", status_level, status_message.c_str());
 }