Make link_name(), link_local_name, and get_link_index_from_name non pure virtual...

[synfig.git] / synfig-core / src / synfig / valuenode_animated.h

diff --git a/synfig-core/src/synfig/valuenode_animated.h b/synfig-core/src/synfig/valuenode_animated.h
index fe16255..093236a 100644 (file)
--- a/synfig-core/src/synfig/valuenode_animated.h
+++ b/synfig-core/src/synfig/valuenode_animated.h
@@ -39,6 +39,17 @@
 
 namespace synfig {
 
+/*! \class ValueNode_Animated
+ *  \brief Virtual class for the derived ValueNode Animated implementations.
+ *
+ * It stores the list of waypoints and defines the base methods for:
+ * add a given waypoint, return a new waypoint at a given time, some find
+ * functions to find waypoints in the list, and to create a handles to
+ * ValueNode_Animated based on the ValueBase Type of the given value node.
+ * Also defines virtual methods to add a new waypoint at a given time using
+ * a value node. They must be redefined by the inherited classes and will
+ * be different depending on the type of value being animated.
+*/
 struct ValueNode_Animated : public ValueNode
 {
 public:
@@ -52,6 +63,7 @@ public:
        typedef std::pair<WaypointList::const_iterator,bool>    const_findresult;
 
 protected:
+       //! List of Waypoints. \see waypoint.h
        WaypointList waypoint_list_;
 
 public:
@@ -59,52 +71,80 @@ public:
 
        const WaypointList &waypoint_list()const { return waypoint_list_; }
 
+       //! Creates a new waypoint at a Time \t with a given ValueBase \value
+       //! Must be redefined in the inherited class
        virtual WaypointList::iterator new_waypoint(Time t, ValueBase value)=0;
-
+       //! Creates a new waypoint at a Time \t with a given ValueNode handle \value_node
+       //! Must be redefined in the inherited class
        virtual WaypointList::iterator new_waypoint(Time t, ValueNode::Handle value_node)=0;
 
+       //! Returns a new waypoint at a given time but it is not inserted in the Waypoint List.
        /*! \note this does not add any waypoint to the ValueNode! */
        Waypoint new_waypoint_at_time(const Time& t)const;
 
+       //! Adds a waypoint \x
+       //! \see : Waypoint new_waypoint_at_time(const Time& t)const;
        WaypointList::iterator add(const Waypoint &x);
 
+       //! Removes a waypoint based on its UniqueId from the waypoint list
        void erase(const UniqueID &x);
 
-       //either use find result (return bool and iterator) or
+       //! Finds Waypoint iterator and associated boolean if found. Find by UniqueID
        findresult                      find_uid(const UniqueID &x);
+       //! Finds Waypoint iterator and associated boolean if found. Find by UniqueID
        const_findresult        find_uid(const UniqueID &x)const;
+       //! Finds Waypoint iterator and associated boolean if found. Find by Time
        findresult                      find_time(const Time &x);
+       //! Finds Waypoint iterator and associated boolean if found. Find by Time
        const_findresult        find_time(const Time &x)const;
 
+       //! Finds a Waypoint by given UniqueID \x
        WaypointList::iterator find(const UniqueID &x);
+       //! Finds a Waypoint by given UniqueID \x
        WaypointList::const_iterator find(const UniqueID &x)const;
+       //! Finds a Waypoint by given Time \x
        WaypointList::iterator find(const Time &x);
+       //! Finds a Waypoint by given Time \x
        WaypointList::const_iterator find(const Time &x)const;
 
+       //! Finds next Waypoint at a given time \x starting from current waypoint
        WaypointList::iterator find_next(const Time &x);
+       //! Finds next Waypoint at a given time \x starting from current waypoint
        WaypointList::const_iterator find_next(const Time &x)const;
+       //! Finds previous Waypoint at a given time \x starting from current waypoint
        WaypointList::iterator find_prev(const Time &x);
+       //! Finds previous Waypoint at a given time \x starting from current waypoint
        WaypointList::const_iterator find_prev(const Time &x)const;
 
        virtual ~ValueNode_Animated();
 
+       //! Virtual member to be filled by inherited classes
        virtual String get_name()const;
+       //! Virtual member to be filled by inherited classes
        virtual String get_local_name()const;
 
+       //! Creates a Valuenode_Animated by type
        static Handle create(ValueBase::Type type);
-
+       //! Creates a Valuenode_Animated by ValueBase and Time
        static Handle create(const ValueBase& value, const Time& time);
-
+       //! Creates a Valuenode_Animated by ValueNode and Time
        static Handle create(ValueNode::Handle value_node, const Time& time);
 
+       //! Fills the \list with the waypoints between \begin and \end
        int find(const Time& begin,const Time& end,std::vector<Waypoint*>& list);
 
+       //! Inserts time \delta from time \location to the waypoints.
+       //! used to move waypoints in the time line.
        void insert_time(const Time& location, const Time& delta);
 
 protected:
        ValueNode_Animated();
 
+       //! Sets thee type of the Animated Value Node
        void set_type(ValueBase::Type t);
+       //!     Function to be overloaded that fills the Time Point Set with
+       //! all the children Time Points. Time Point is like Waypoint but
+       //! without value node
        virtual void get_times_vfunc(Node::time_set &set) const;
 };