Removed unneeded index param and code from ConnectNode / Child
[platform/core/uifw/dali-core.git] / dali / internal / event / actors / actor-impl.h
index 5f5d900..6887d8b 100644 (file)
 #include <string>
 
 // INTERNAL INCLUDES
-#include <dali/public-api/common/vector-wrapper.h>
-#include <dali/public-api/object/ref-object.h>
 #include <dali/public-api/actors/actor.h>
+#include <dali/public-api/common/vector-wrapper.h>
 #include <dali/public-api/common/dali-common.h>
 #include <dali/public-api/events/gesture.h>
 #include <dali/public-api/math/viewport.h>
-#include <dali/internal/event/common/object-impl.h>
+#include <dali/public-api/object/ref-object.h>
 #include <dali/public-api/size-negotiation/relayout-container.h>
-#include <dali/internal/event/common/stage-def.h>
 #include <dali/internal/event/actors/actor-declarations.h>
-#include <dali/internal/event/actors/renderer-impl.h>
 #include <dali/internal/event/actor-attachments/actor-attachment-declarations.h>
+#include <dali/internal/event/common/object-impl.h>
+#include <dali/internal/event/common/stage-def.h>
+#include <dali/internal/event/rendering/renderer-impl.h>
 #include <dali/internal/update/nodes/node-declarations.h>
 
-#ifdef DYNAMICS_SUPPORT
-#include <dali/internal/event/dynamics/dynamics-declarations.h>
-#endif
-
 namespace Dali
 {
 
 struct KeyEvent;
 struct TouchEvent;
 struct HoverEvent;
-struct MouseWheelEvent;
+struct WheelEvent;
 
 namespace Internal
 {
@@ -56,10 +52,8 @@ class ActorGestureData;
 class Animation;
 class RenderTask;
 class Renderer;
-struct DynamicsData;
 
-typedef IntrusivePtr< Actor > ActorPtr;
-typedef Dali::ActorContainer ActorContainer; // Store handles to return via public-api
+typedef std::vector< ActorPtr > ActorContainer;
 typedef ActorContainer::iterator ActorIter;
 typedef ActorContainer::const_iterator ActorConstIter;
 
@@ -88,7 +82,7 @@ public:
      * @param[in] newActor The actor to assign
      * @param[in] newDimension The dimension to assign
      */
-    ActorDimensionPair( Actor* newActor, Dimension newDimension )
+    ActorDimensionPair( Actor* newActor, Dimension::Type newDimension )
     : actor( newActor ),
       dimension( newDimension )
     {
@@ -106,7 +100,7 @@ public:
     }
 
     Actor* actor;           ///< The actor to hold
-    Dimension dimension;    ///< The dimension to hold
+    Dimension::Type dimension;    ///< The dimension to hold
   };
 
   typedef std::vector< ActorDimensionPair > ActorDimensionStack;
@@ -203,16 +197,6 @@ public:
   void Add( Actor& child );
 
   /**
-   * Inserts a child Actor to this Actor's child list
-   * @pre The child actor is not the same as the parent actor.
-   * @pre The child actor does not already have a parent.
-   * @param [in] index in childlist to insert child at
-   * @param [in] child The child.
-   * @post The child will be referenced by its parent.
-   */
-  void Insert( unsigned int index, Actor& child );
-
-  /**
    * Removes a child Actor from this Actor.
    * @param [in] child The child.
    * @post The child will be unreferenced.
@@ -233,19 +217,7 @@ public:
   /**
    * @copydoc Dali::Actor::GetChildAt
    */
-  Dali::Actor GetChildAt( unsigned int index ) const;
-
-  /**
-   * Retrieve the Actor's children.
-   * @return A copy of the container of children.
-   */
-  ActorContainer GetChildren();
-
-  /**
-   * Retrieve the Actor's children.
-   * @return A const reference to the container of children.
-   */
-  const ActorContainer& GetChildren() const;
+  ActorPtr GetChildAt( unsigned int index ) const;
 
   /**
    * Retrieve a reference to Actor's children.
@@ -304,6 +276,13 @@ public:
   void SetSize( const Vector2& size );
 
   /**
+   * Sets the update size for an actor.
+   *
+   * @param[in] size The size to set.
+   */
+  void SetSizeInternal( const Vector2& size );
+
+  /**
    * Sets the size of an actor.
    * ActorAttachments attached to the actor, can be scaled to fit within this area.
    * This does not interfere with the actors scale factor.
@@ -312,6 +291,13 @@ public:
   void SetSize( const Vector3& size );
 
   /**
+   * Sets the update size for an actor.
+   *
+   * @param[in] size The size to set.
+   */
+  void SetSizeInternal( const Vector3& size );
+
+  /**
    * Set the width component of the Actor's size.
    * @param [in] width The new width component.
    */
@@ -475,6 +461,13 @@ public:
   const Vector3& GetCurrentPosition() const;
 
   /**
+   * Retrieve the target position of the Actor.
+   * The coordinates are relative to the Actor's parent.
+   * @return the Actor's position.
+   */
+  const Vector3& GetTargetPosition() const;
+
+  /**
    * @copydoc Dali::Actor::GetCurrentWorldPosition()
    */
   const Vector3& GetCurrentWorldPosition() const;
@@ -535,27 +528,15 @@ public:
   bool IsOrientationInherited() const;
 
   /**
-   * @brief Defines how a child actors size is affected by its parents size.
-   * @param[in] mode The size relative to parent mode to use.
-   */
-  void SetSizeMode( SizeMode mode );
-
-  /**
-   * Query how the child actors size is affected by its parents size.
-   * @return The size relative to parent mode in use.
-   */
-  SizeMode GetSizeMode() const;
-
-  /**
    * Sets the factor of the parents size used for the child actor.
-   * Note: Only used if SizeMode is SIZE_RELATIVE_TO_PARENT or SIZE_FIXED_OFFSET_FROM_PARENT.
+   * Note: Only used if ResizePolicy is ResizePolicy::SIZE_RELATIVE_TO_PARENT or ResizePolicy::SIZE_FIXED_OFFSET_FROM_PARENT.
    * @param[in] factor The vector to multiply the parents size by to get the childs size.
    */
   void SetSizeModeFactor( const Vector3& factor );
 
   /**
    * Gets the factor of the parents size used for the child actor.
-   * Note: Only used if SizeMode is SIZE_RELATIVE_TO_PARENT or SIZE_FIXED_OFFSET_FROM_PARENT.
+   * Note: Only used if ResizePolicy is ResizePolicy::SIZE_RELATIVE_TO_PARENT or ResizePolicy::SIZE_FIXED_OFFSET_FROM_PARENT.
    * @return The vector being used to multiply the parents size by to get the childs size.
    */
   const Vector3& GetSizeModeFactor() const;
@@ -765,6 +746,19 @@ public:
    */
   const Vector4& GetCurrentWorldColor() const;
 
+  /**
+   * @copydoc Dali::Actor::GetHierarchyDepth()
+   */
+  int GetHierarchyDepth() const
+  {
+    if( mIsOnStage )
+    {
+      return static_cast<int>(mDepth);
+    }
+
+    return -1;
+  }
+
 public:
 
   // Size negotiation virtual functions
@@ -795,7 +789,7 @@ public:
    * @param[in] policy The policy being set
    * @param[in] dimension The dimension the policy is being set for
    */
-  virtual void OnSetResizePolicy( ResizePolicy policy, Dimension dimension ) {}
+  virtual void OnSetResizePolicy( ResizePolicy::Type policy, Dimension::Type dimension ) {}
 
   /**
    * @brief Virtual method to notify deriving classes that relayout dependencies have been
@@ -803,7 +797,7 @@ public:
    *
    * @param dimension The dimension that is about to be calculated
    */
-  virtual void OnCalculateRelayoutSize( Dimension dimension );
+  virtual void OnCalculateRelayoutSize( Dimension::Type dimension );
 
   /**
    * @brief Virtual method to notify deriving classes that the size for a dimension
@@ -812,7 +806,7 @@ public:
    * @param[in] size The new size for the given dimension
    * @param[in] dimension The dimension that was just negotiated
    */
-  virtual void OnLayoutNegotiated( float size, Dimension dimension );
+  virtual void OnLayoutNegotiated( float size, Dimension::Type dimension );
 
   /**
    * @brief Determine if this actor is dependent on it's children for relayout
@@ -820,7 +814,7 @@ public:
    * @param dimension The dimension(s) to check for
    * @return Return if the actor is dependent on it's children
    */
-  virtual bool RelayoutDependentOnChildren( Dimension dimension = ALL_DIMENSIONS );
+  virtual bool RelayoutDependentOnChildren( Dimension::Type dimension = Dimension::ALL_DIMENSIONS );
 
   /**
    * @brief Determine if this actor is dependent on it's children for relayout.
@@ -830,7 +824,7 @@ public:
    * @param dimension The dimension(s) to check for
    * @return Return if the actor is dependent on it's children
    */
-  virtual bool RelayoutDependentOnChildrenBase( Dimension dimension = ALL_DIMENSIONS );
+  virtual bool RelayoutDependentOnChildrenBase( Dimension::Type dimension = Dimension::ALL_DIMENSIONS );
 
   /**
    * @brief Calculate the size for a child
@@ -839,7 +833,7 @@ public:
    * @param[in] dimension The dimension to calculate the size for. E.g. width or height.
    * @return Return the calculated size for the given dimension
    */
-  virtual float CalculateChildSize( const Dali::Actor& child, Dimension dimension );
+  virtual float CalculateChildSize( const Dali::Actor& child, Dimension::Type dimension );
 
   /**
    * @brief This method is called during size negotiation when a height is required for a given width.
@@ -882,40 +876,44 @@ public:
   /**
    * @copydoc Dali::Actor::SetResizePolicy()
    */
-  void SetResizePolicy( ResizePolicy policy, Dimension dimension = ALL_DIMENSIONS );
+  void SetResizePolicy( ResizePolicy::Type policy, Dimension::Type dimension = Dimension::ALL_DIMENSIONS );
 
   /**
    * @copydoc Dali::Actor::GetResizePolicy()
    */
-  ResizePolicy GetResizePolicy( Dimension dimension ) const;
+  ResizePolicy::Type GetResizePolicy( Dimension::Type dimension ) const;
 
   /**
    * @copydoc Dali::Actor::SetSizeScalePolicy()
    */
-  void SetSizeScalePolicy( SizeScalePolicy policy );
+  void SetSizeScalePolicy( SizeScalePolicy::Type policy );
 
   /**
    * @copydoc Dali::Actor::GetSizeScalePolicy()
    */
-  SizeScalePolicy GetSizeScalePolicy() const;
+  SizeScalePolicy::Type GetSizeScalePolicy() const;
 
   /**
    * @copydoc Dali::Actor::SetDimensionDependency()
    */
-  void SetDimensionDependency( Dimension dimension, Dimension dependency );
+  void SetDimensionDependency( Dimension::Type dimension, Dimension::Type dependency );
 
   /**
    * @copydoc Dali::Actor::GetDimensionDependency()
    */
-  Dimension GetDimensionDependency( Dimension dimension ) const;
+  Dimension::Type GetDimensionDependency( Dimension::Type dimension ) const;
 
   /**
-   * @copydoc Dali::Actor::SetRelayoutEnabled()
+   * @brief Set the size negotiation relayout enabled on this actor
+   *
+   * @param[in] relayoutEnabled Boolean to enable or disable relayout
    */
   void SetRelayoutEnabled( bool relayoutEnabled );
 
   /**
-   * @copydoc Dali::Actor::IsRelayoutEnabled()
+   * @brief Return if relayout is enabled
+   *
+   * @return Return if relayout is enabled or not for this actor
    */
   bool IsRelayoutEnabled() const;
 
@@ -925,7 +923,7 @@ public:
    * @param dirty Whether to mark actor as dirty or not
    * @param dimension The dimension(s) to mark as dirty
    */
-  void SetLayoutDirty( bool dirty, Dimension dimension = ALL_DIMENSIONS );
+  void SetLayoutDirty( bool dirty, Dimension::Type dimension = Dimension::ALL_DIMENSIONS );
 
   /**
    * @brief Return if any of an actor's dimensions are marked as dirty
@@ -933,21 +931,21 @@ public:
    * @param dimension The dimension(s) to check
    * @return Return if any of the requested dimensions are dirty
    */
-  bool IsLayoutDirty( Dimension dimension = ALL_DIMENSIONS ) const;
+  bool IsLayoutDirty( Dimension::Type dimension = Dimension::ALL_DIMENSIONS ) const;
 
   /**
    * @brief Returns if relayout is enabled and the actor is not dirty
    *
    * @return Return if it is possible to relayout the actor
    */
-  bool RelayoutPossible( Dimension dimension = ALL_DIMENSIONS ) const;
+  bool RelayoutPossible( Dimension::Type dimension = Dimension::ALL_DIMENSIONS ) const;
 
   /**
    * @brief Returns if relayout is enabled and the actor is dirty
    *
    * @return Return if it is required to relayout the actor
    */
-  bool RelayoutRequired( Dimension dimension = ALL_DIMENSIONS ) const;
+  bool RelayoutRequired( Dimension::Type dimension = Dimension::ALL_DIMENSIONS ) const;
 
   /**
    * @brief Request a relayout, which means performing a size negotiation on this actor, its parent and children (and potentially whole scene)
@@ -962,21 +960,7 @@ public:
    * @note RelayoutRequest() can be called multiple times; the size negotiation is still
    * only performed once, i.e. there is no need to keep track of this in the calling side.
    */
-  void RelayoutRequest( Dimension dimension = ALL_DIMENSIONS );
-
-  /**
-   * @brief Request to relayout of all actors in the sub-tree below the given actor.
-   *
-   * This flags the actor and all actors below it for relayout. The actual
-   * relayout is performed at the end of the frame. This means that multiple calls to relayout
-   * will not cause multiple relayouts to occur.
-   */
-  void RelayoutRequestTree();
-
-  /*
-   * @copydoc Dali::Actor::PropagateRelayoutFlags
-   */
-  void PropagateRelayoutFlags();
+  void RelayoutRequest( Dimension::Type dimension = Dimension::ALL_DIMENSIONS );
 
   /**
    * @brief Determine if this actor is dependent on it's parent for relayout
@@ -984,7 +968,7 @@ public:
    * @param dimension The dimension(s) to check for
    * @return Return if the actor is dependent on it's parent
    */
-  bool RelayoutDependentOnParent( Dimension dimension = ALL_DIMENSIONS );
+  bool RelayoutDependentOnParent( Dimension::Type dimension = Dimension::ALL_DIMENSIONS );
 
   /**
    * @brief Determine if this actor has another dimension depedent on the specified one
@@ -993,7 +977,7 @@ public:
    * @param dependentDimension The dimension to check for dependency with
    * @return Return if the actor is dependent on this dimension
    */
-  bool RelayoutDependentOnDimension( Dimension dimension, Dimension dependentDimension );
+  bool RelayoutDependentOnDimension( Dimension::Type dimension, Dimension::Type dependentDimension );
 
   /**
    * Negotiate sizes for a control in all dimensions
@@ -1015,7 +999,7 @@ public:
    * @param[in] dimension The dimension to negotiate on
    * @param[in] allocatedSize The size constraint that the actor must respect
    */
-  void NegotiateDimension( Dimension dimension, const Vector2& allocatedSize, ActorDimensionStack& recursionStack );
+  void NegotiateDimension( Dimension::Type dimension, const Vector2& allocatedSize, ActorDimensionStack& recursionStack );
 
   /**
    * @brief Calculate the size of a dimension
@@ -1024,16 +1008,16 @@ public:
    * @param[in] maximumSize The upper bounds on the size
    * @return Return the calculated size for the dimension
    */
-  float CalculateSize( Dimension dimension, const Vector2& maximumSize );
+  float CalculateSize( Dimension::Type dimension, const Vector2& maximumSize );
 
   /**
-   * @brief Constain a dimension given the relayout constraints on this actor
+   * @brief Clamp a dimension given the relayout constraints on this actor
    *
    * @param[in] size The size to constrain
    * @param[in] dimension The dimension the size exists in
-   * @return Return the constrained size
+   * @return Return the clamped size
    */
-  float ConstrainDimension( float size, Dimension dimension );
+  float ClampDimension( float size, Dimension::Type dimension );
 
   /**
    * Negotiate a dimension based on the size of the parent
@@ -1041,7 +1025,7 @@ public:
    * @param[in] dimension The dimension to negotiate on
    * @return Return the negotiated size
    */
-  float NegotiateFromParent( Dimension dimension );
+  float NegotiateFromParent( Dimension::Type dimension );
 
   /**
    * Negotiate a dimension based on the size of the parent. Fitting inside.
@@ -1049,7 +1033,7 @@ public:
    * @param[in] dimension The dimension to negotiate on
    * @return Return the negotiated size
    */
-  float NegotiateFromParentFit( Dimension dimension );
+  float NegotiateFromParentFit( Dimension::Type dimension );
 
   /**
    * Negotiate a dimension based on the size of the parent. Flooding the whole space.
@@ -1057,7 +1041,7 @@ public:
    * @param[in] dimension The dimension to negotiate on
    * @return Return the negotiated size
    */
-  float NegotiateFromParentFlood( Dimension dimension );
+  float NegotiateFromParentFlood( Dimension::Type dimension );
 
   /**
    * @brief Negotiate a dimension based on the size of the children
@@ -1065,7 +1049,7 @@ public:
    * @param[in] dimension The dimension to negotiate on
    * @return Return the negotiated size
    */
-  float NegotiateFromChildren( Dimension dimension );
+  float NegotiateFromChildren( Dimension::Type dimension );
 
   /**
    * Set the negotiated dimension value for the given dimension(s)
@@ -1073,7 +1057,7 @@ public:
    * @param negotiatedDimension The value to set
    * @param dimension The dimension(s) to set the value for
    */
-  void SetNegotiatedDimension( float negotiatedDimension, Dimension dimension = ALL_DIMENSIONS );
+  void SetNegotiatedDimension( float negotiatedDimension, Dimension::Type dimension = Dimension::ALL_DIMENSIONS );
 
   /**
    * Return the value of negotiated dimension for the given dimension
@@ -1081,7 +1065,7 @@ public:
    * @param dimension The dimension to retrieve
    * @return Return the value of the negotiated dimension
    */
-  float GetNegotiatedDimension( Dimension dimension ) const;
+  float GetNegotiatedDimension( Dimension::Type dimension ) const;
 
   /**
    * @brief Set the padding for a dimension
@@ -1089,7 +1073,7 @@ public:
    * @param[in] padding Padding for the dimension. X = start (e.g. left, bottom), y = end (e.g. right, top)
    * @param[in] dimension The dimension to set
    */
-  void SetPadding( const Vector2& padding, Dimension dimension );
+  void SetPadding( const Vector2& padding, Dimension::Type dimension );
 
   /**
    * Return the value of padding for the given dimension
@@ -1097,7 +1081,7 @@ public:
    * @param dimension The dimension to retrieve
    * @return Return the value of padding for the dimension
    */
-  Vector2 GetPadding( Dimension dimension ) const;
+  Vector2 GetPadding( Dimension::Type dimension ) const;
 
   /**
    * Return the actor size for a given dimension
@@ -1105,7 +1089,7 @@ public:
    * @param[in] dimension The dimension to retrieve the size for
    * @return Return the size for the given dimension
    */
-  float GetSize( Dimension dimension ) const;
+  float GetSize( Dimension::Type dimension ) const;
 
   /**
    * Return the natural size of the actor for a given dimension
@@ -1113,7 +1097,7 @@ public:
    * @param[in] dimension The dimension to retrieve the size for
    * @return Return the natural size for the given dimension
    */
-  float GetNaturalSize( Dimension dimension ) const;
+  float GetNaturalSize( Dimension::Type dimension ) const;
 
   /**
    * @brief Return the amount of size allocated for relayout
@@ -1123,7 +1107,7 @@ public:
    * @param[in] dimension The dimension to retrieve
    * @return Return the size
    */
-  float GetRelayoutSize( Dimension dimension ) const;
+  float GetRelayoutSize( Dimension::Type dimension ) const;
 
   /**
    * @brief If the size has been negotiated return that else return normal size
@@ -1131,7 +1115,7 @@ public:
    * @param[in] dimension The dimension to retrieve
    * @return Return the size
    */
-  float GetLatestSize( Dimension dimension ) const;
+  float GetLatestSize( Dimension::Type dimension ) const;
 
   /**
    * Apply the negotiated size to the actor
@@ -1146,7 +1130,7 @@ public:
    * @param[in] negotiated The status of the flag to set.
    * @param[in] dimension The dimension to set the flag for
    */
-  void SetLayoutNegotiated( bool negotiated, Dimension dimension = ALL_DIMENSIONS );
+  void SetLayoutNegotiated( bool negotiated, Dimension::Type dimension = Dimension::ALL_DIMENSIONS );
 
   /**
    * @brief Test whether the layout dimension for this actor has been negotiated or not.
@@ -1154,7 +1138,21 @@ public:
    * @param[in] dimension The dimension to determine the value of the flag for
    * @return Return if the layout dimension is negotiated or not.
    */
-  bool IsLayoutNegotiated( Dimension dimension = ALL_DIMENSIONS ) const;
+  bool IsLayoutNegotiated( Dimension::Type dimension = Dimension::ALL_DIMENSIONS ) const;
+
+  /**
+   * @brief provides the Actor implementation of GetHeightForWidth
+   * @param width to use.
+   * @return the height based on the width.
+   */
+  float GetHeightForWidthBase( float width );
+
+  /**
+   * @brief provides the Actor implementation of GetWidthForHeight
+   * @param height to use.
+   * @return the width based on the height.
+   */
+  float GetWidthForHeightBase( float height );
 
   /**
    * @brief Calculate the size for a child
@@ -1163,37 +1161,42 @@ public:
    * @param[in] dimension The dimension to calculate the size for. E.g. width or height.
    * @return Return the calculated size for the given dimension
    */
-  float CalculateChildSizeBase( const Dali::Actor& child, Dimension dimension );
+  float CalculateChildSizeBase( const Dali::Actor& child, Dimension::Type dimension );
 
   /**
-   * @copydoc Dali::Actor::SetPreferredSize
+   * @brief Set the preferred size for size negotiation
+   *
+   * @param[in] size The preferred size to set
    */
   void SetPreferredSize( const Vector2& size );
 
   /**
-   * @copydoc Dali::Actor::GetPreferredSize
+   * @brief Return the preferred size used for size negotiation
+   *
+   * @return Return the preferred size
    */
   Vector2 GetPreferredSize() const;
 
   /**
    * @copydoc Dali::Actor::SetMinimumSize
    */
-  void SetMinimumSize( float size, Dimension dimension = ALL_DIMENSIONS );
+  void SetMinimumSize( float size, Dimension::Type dimension = Dimension::ALL_DIMENSIONS );
 
   /**
    * @copydoc Dali::Actor::GetMinimumSize
    */
-  float GetMinimumSize( Dimension dimension ) const;
+  float GetMinimumSize( Dimension::Type dimension ) const;
 
   /**
    * @copydoc Dali::Actor::SetMaximumSize
    */
-  void SetMaximumSize( float size, Dimension dimension = ALL_DIMENSIONS );
+  void SetMaximumSize( float size, Dimension::Type dimension = Dimension::ALL_DIMENSIONS );
 
   /**
    * @copydoc Dali::Actor::GetMaximumSize
    */
-  float GetMaximumSize( Dimension dimension ) const;
+  float GetMaximumSize( Dimension::Type dimension ) const;
+  
   /**
    * @copydoc Dali::Actor::AddRenderer()
    */
@@ -1219,93 +1222,8 @@ public:
    */
   void RemoveRenderer( unsigned int index );
 
-#ifdef DYNAMICS_SUPPORT
-
-  // Dynamics
-
-  /// @copydoc Dali::Actor::DisableDynamics
-  void DisableDynamics();
-
-  /// @copydoc Dali::Actor::EnableDynamics(Dali::DynamicsBodyConfig)
-  DynamicsBodyPtr EnableDynamics(DynamicsBodyConfigPtr bodyConfig);
-
-  /// @copydoc Dali::Actor::GetDynamicsBody
-  DynamicsBodyPtr GetDynamicsBody() const;
-
-  /// @copydoc Dali::Actor::AddDynamicsJoint(Dali::Actor,const Vector3&)
-  DynamicsJointPtr AddDynamicsJoint( ActorPtr attachedActor, const Vector3& offset );
-
-  /// @copydoc Dali::Actor::AddDynamicsJoint(Dali::Actor,const Vector3&,const Vector3&)
-  DynamicsJointPtr AddDynamicsJoint( ActorPtr attachedActor, const Vector3& offsetA, const Vector3& offsetB );
-
-  /// @copydoc Dali::Actor::GetNumberOfJoints
-  const int GetNumberOfJoints() const;
-
-  /// @copydoc Dali::Actor::GetDynamicsJointByIndex
-  DynamicsJointPtr GetDynamicsJointByIndex( const int index ) const;
-
-  /// @copydoc Dali::Actor::GetDynamicsJoint
-  DynamicsJointPtr GetDynamicsJoint( ActorPtr attachedActor ) const;
-
-  /// @copydoc Dali::Actor::RemoveDynamicsJoint
-  void RemoveDynamicsJoint( DynamicsJointPtr joint );
-
-  /**
-   * Hold a reference to a DynamicsJoint
-   * @param[in] joint The joint
-   */
-  void ReferenceJoint( DynamicsJointPtr joint );
-
-  /**
-   * Release a reference to a DynamicsJoint
-   * @param[in] joint The joint
-   */
-  void ReleaseJoint( DynamicsJointPtr joint );
-
-  /**
-   * Set this actor to be the root actor in the dynamics simulation
-   * All children of the actor are added/removed from the simulation.
-   * @param[in] flag  When true sets this actor to be the simulation world root actor and
-   *                  if OnStage() all dynamics enabled child actors are added to the simulation,
-   *                  when false stops this actor being the simulation root and if OnStage() all
-   *                  dynamics enabled child actors are removed from the simulation.
-   */
-  void SetDynamicsRoot(bool flag);
-
-private:
-  /**
-   * Check if this actor is the root actor in the dynamics simulation
-   * @return true if this is the dynamics root actor.
-   */
-  bool IsDynamicsRoot() const;
-
-  /**
-   * Add actor to the dynamics simulation
-   * Invoked when the actor is staged, or it's parent becomes the simulation root
-   */
-  void ConnectDynamics();
-
-  /**
-   * Remove actor from the dynamics simulation
-   * Invoked when the actor is unstaged, or it's parent stops being the the simulation root
-   */
-  void DisconnectDynamics();
-
-  /**
-   * An actor in a DynamicsJoint relationship has been staged
-   * @param[in] actor The actor passed into AddDynamicsJoint()
-   */
-  void AttachedActorOnStage( Dali::Actor actor );
-
-  /**
-   * An actor in a DynamicsJoint relationship has been unstaged
-   * @param[in] actor The actor passed into AddDynamicsJoint()
-   */
-  void AttachedActorOffStage( Dali::Actor actor );
-
-#endif // DYNAMICS_SUPPORT
-
 public:
+
   /**
    * Converts screen coordinates into the actor's coordinate system.
    * @note The actor coordinates are relative to the top-left (0.0, 0.0, 0.5)
@@ -1413,10 +1331,10 @@ public:
   bool GetHoverRequired() const;
 
   /**
-   * Query whether the application or derived actor type requires mouse wheel events.
-   * @return True if mouse wheel events are required.
+   * Query whether the application or derived actor type requires wheel events.
+   * @return True if wheel events are required.
    */
-  bool GetMouseWheelEventRequired() const;
+  bool GetWheelEventRequired() const;
 
   /**
    * Query whether the actor is actually hittable.  This method checks whether the actor is
@@ -1460,11 +1378,11 @@ public:
   bool EmitHoverEventSignal( const HoverEvent& event );
 
   /**
-   * Used by the EventProcessor to emit mouse wheel event signals.
-   * @param[in] event The mouse wheel event.
+   * Used by the EventProcessor to emit wheel event signals.
+   * @param[in] event The wheel event.
    * @return True if the event was consumed.
    */
-  bool EmitMouseWheelEventSignal( const MouseWheelEvent& event );
+  bool EmitWheelEventSignal( const WheelEvent& event );
 
   /**
    * @copydoc Dali::Actor::TouchedSignal()
@@ -1477,9 +1395,9 @@ public:
   Dali::Actor::HoverSignalType& HoveredSignal();
 
   /**
-   * @copydoc Dali::Actor::MouseWheelEventSignal()
+   * @copydoc Dali::Actor::WheelEventSignal()
    */
-  Dali::Actor::MouseWheelEventSignalType& MouseWheelEventSignal();
+  Dali::Actor::WheelEventSignalType& WheelEventSignal();
 
   /**
    * @copydoc Dali::Actor::OnStageSignal()
@@ -1519,13 +1437,13 @@ public:
    */
   static bool DoAction( BaseObject* object,
                         const std::string& actionName,
-                        const std::vector< Property::Value >& attributes );
+                        const Property::Map& attributes );
 
 public:
   // For Animation
 
   /**
-   * This should only be called by Animation, when the actor is resized using Animation::Resize().
+   * This should only be called by Animation, when the actors SIZE property is animated.
    *
    * @param[in] animation The animation that resized the actor
    * @param[in] targetSize The new target size of the actor
@@ -1533,6 +1451,14 @@ public:
   void NotifySizeAnimation( Animation& animation, const Vector3& targetSize );
 
   /**
+   * This should only be called by Animation, when the actors SIZE_WIDTH or SIZE_HEIGHT property is animated.
+   *
+   * @param[in] animation The animation that resized the actor
+   * @param[in] targetSize The new target size of the actor
+   */
+  void NotifySizeAnimation( Animation& animation, float targetSize, Property::Index property );
+
+  /**
    * For use in derived classes.
    * This should only be called by Animation, when the actor is resized using Animation::Resize().
    */
@@ -1566,24 +1492,22 @@ protected:
 
   /**
    * Called on a child during Add() when the parent actor is connected to the Stage.
-   * @param[in] stage The stage.
-   * @param[in] index If set, it is only used for positioning the actor within the parent's child list.
+   * @param[in] parentDepth The depth of the parent in the hierarchy.
    */
-  void ConnectToStage( int index = -1 );
+  void ConnectToStage( unsigned int parentDepth );
 
   /**
    * Helper for ConnectToStage, to recursively connect a tree of actors.
    * This is atomic i.e. not interrupted by user callbacks.
-   * @param[in] index If set, it is only used for positioning the actor within the parent's child list.
+   * @param[in]  depth The depth in the hierarchy of the actor
    * @param[out] connectionList On return, the list of connected actors which require notification.
    */
-  void RecursiveConnectToStage( ActorContainer& connectionList, int index = -1 );
+  void RecursiveConnectToStage( ActorContainer& connectionList, unsigned int depth );
 
   /**
    * Connect the Node associated with this Actor to the scene-graph.
-   * @param[in] index If set, it is only used for positioning the actor within the parent's child list.
    */
-  void ConnectToSceneGraph( int index = -1 );
+  void ConnectToSceneGraph();
 
   /**
    * Helper for ConnectToStage, to notify a connected actor through the public API.
@@ -1724,9 +1648,8 @@ private:
   /**
    * Set the actors parent.
    * @param[in] parent The new parent.
-   * @param[in] index If set, it is only used for positioning the actor within the parent's child list.
    */
-  void SetParent( Actor* parent, int index = -1 );
+  void SetParent( Actor* parent );
 
   /**
    * Helper to create a Node for this Actor.
@@ -1764,7 +1687,7 @@ private:
    * For use in external (CustomActor) derived classes.
    * This is called after the atomic ConnectToStage() traversal has been completed.
    */
-  virtual void OnStageConnectionExternal()
+  virtual void OnStageConnectionExternal( int depth )
   {
   }
 
@@ -1824,11 +1747,11 @@ private:
 
   /**
    * For use in derived classes.
-   * This is only called if the mouse wheel signal was not consumed.
-   * @param[in] event The mouse event.
+   * This is only called if the wheel signal was not consumed.
+   * @param[in] event The wheel event.
    * @return True if the event should be consumed.
    */
-  virtual bool OnMouseWheelEvent( const MouseWheelEvent& event )
+  virtual bool OnWheelEvent( const WheelEvent& event )
   {
     return false;
   }
@@ -1836,7 +1759,7 @@ private:
   /**
    * @brief Ensure the relayout data is allocated
    */
-  void EnsureRelayoutData() const;
+  void EnsureRelayoutData();
 
   /**
    * @brief Apply the size set policy to the input size
@@ -1848,7 +1771,6 @@ private:
 
 protected:
 
-  StagePtr mStage;                ///< Used to send messages to Node; valid until Core destruction
   Actor* mParent;                 ///< Each actor (except the root) can have one parent
   ActorContainer* mChildren;      ///< Container of referenced actors
   const SceneGraph::Node* mNode;  ///< Not owned
@@ -1856,11 +1778,7 @@ protected:
   Vector3* mAnchorPoint;          ///< NULL means AnchorPoint::DEFAULT. AnchorPoint is non-animatable
 
   struct RelayoutData;
-  mutable RelayoutData* mRelayoutData; ///< Struct to hold optional collection of relayout variables
-
-#ifdef DYNAMICS_SUPPORT
-  DynamicsData* mDynamicsData; ///< optional physics data
-#endif
+  RelayoutData* mRelayoutData; ///< Struct to hold optional collection of relayout variables
 
   ActorGestureData* mGestureData;   ///< Optional Gesture data. Only created when actor requires gestures
 
@@ -1869,28 +1787,30 @@ protected:
   // Signals
   Dali::Actor::TouchSignalType             mTouchedSignal;
   Dali::Actor::HoverSignalType             mHoveredSignal;
-  Dali::Actor::MouseWheelEventSignalType   mMouseWheelEventSignal;
+  Dali::Actor::WheelEventSignalType        mWheelEventSignal;
   Dali::Actor::OnStageSignalType           mOnStageSignal;
   Dali::Actor::OffStageSignalType          mOffStageSignal;
   Dali::Actor::OnRelayoutSignalType        mOnRelayoutSignal;
 
-  Vector3         mTargetSize;      ///< Event-side storage for size (not a pointer as most actors will have a size)
+  Vector3         mTargetSize;       ///< Event-side storage for size (not a pointer as most actors will have a size)
+  Vector3         mTargetPosition;   ///< Event-side storage for position (not a pointer as most actors will have a position)
 
   std::string     mName;      ///< Name of the actor
   unsigned int    mId;        ///< A unique ID to identify the actor starting from 1, and 0 is reserved
 
+  unsigned short mDepth                            :12; ///< Cached: The depth in the hierarchy of the actor. Only 4096 levels of depth are supported
   const bool mIsRoot                               : 1; ///< Flag to identify the root actor
   const bool mIsRenderable                         : 1; ///< Flag to identify that this is a renderable actor
   const bool mIsLayer                              : 1; ///< Flag to identify that this is a layer
   bool mIsOnStage                                  : 1; ///< Flag to identify whether the actor is on-stage
-  bool mIsDynamicsRoot                             : 1; ///< Flag to identify if this is the dynamics world root
   bool mSensitive                                  : 1; ///< Whether the actor emits touch event signals
   bool mLeaveRequired                              : 1; ///< Whether a touch event signal is emitted when the a touch leaves the actor's bounds
   bool mKeyboardFocusable                          : 1; ///< Whether the actor should be focusable by keyboard navigation
   bool mDerivedRequiresTouch                       : 1; ///< Whether the derived actor type requires touch event signals
   bool mDerivedRequiresHover                       : 1; ///< Whether the derived actor type requires hover event signals
-  bool mDerivedRequiresMouseWheelEvent             : 1; ///< Whether the derived actor type requires mouse wheel event signals
+  bool mDerivedRequiresWheelEvent                  : 1; ///< Whether the derived actor type requires wheel event signals
   bool mOnStageSignalled                           : 1; ///< Set to true before OnStageConnection signal is emitted, and false before OnStageDisconnection
+  bool mInsideOnSizeSet                            : 1; ///< Whether we are inside OnSizeSet
   bool mInheritOrientation                         : 1; ///< Cached: Whether the parent's orientation should be inherited.
   bool mInheritScale                               : 1; ///< Cached: Whether the parent's scale should be inherited.
   DrawMode::Type mDrawMode                         : 2; ///< Cached: How the actor and its children should be drawn