#define DALI_INTERNAL_ACTOR_H
/*
- * Copyright (c) 2017 Samsung Electronics Co., Ltd.
+ * Copyright (c) 2018 Samsung Electronics Co., Ltd.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
class Animation;
class RenderTask;
class Renderer;
+class Scene;
typedef std::vector< ActorPtr > ActorContainer;
typedef ActorContainer::iterator ActorIter;
static ActorPtr New();
/**
+ * Helper to create node for derived classes who don't have their own node type
+ * @return pointer to newly created unique node
+ */
+ static const SceneGraph::Node* CreateNode();
+
+ /**
* Retrieve the name of the actor.
* @return The name.
*/
/**
* @copydoc Dali::Actor::GetId
*/
- unsigned int GetId() const;
+ uint32_t GetId() const;
// Containment
* Retrieve the number of children held by the actor.
* @return The number of children
*/
- unsigned int GetChildCount() const;
+ uint32_t GetChildCount() const;
/**
* @copydoc Dali::Actor::GetChildAt
*/
- ActorPtr GetChildAt( unsigned int index ) const;
+ ActorPtr GetChildAt( uint32_t index ) const;
/**
* Retrieve a reference to Actor's children.
/**
* @copydoc Dali::Actor::FindChildById
*/
- ActorPtr FindChildById( const unsigned int id );
+ ActorPtr FindChildById( const uint32_t id );
/**
* Retrieve the parent of an Actor.
}
/**
+ * Calculates screen position and size.
+ *
+ * @return pair of two values, position of top-left corner on screen and size respectively.
+ */
+ Rect<> CalculateScreenExtents( ) const;
+
+ /**
* Sets the size of an actor.
* This does not interfere with the actors scale factor.
* @param [in] width The new width.
const Vector3& GetCurrentWorldPosition() const;
/**
- * @copydoc Dali::Actor::SetPositionInheritanceMode()
- */
- void SetPositionInheritanceMode( PositionInheritanceMode mode );
-
- /**
- * @copydoc Dali::Actor::GetPositionInheritanceMode()
- */
- PositionInheritanceMode GetPositionInheritanceMode() const;
-
- /**
* @copydoc Dali::Actor::SetInheritPosition()
*/
void SetInheritPosition( bool inherit );
/**
* @copydoc Dali::Actor::GetHierarchyDepth()
*/
- inline int GetHierarchyDepth() const
+ inline int32_t GetHierarchyDepth() const
{
if( mIsOnStage )
{
- return static_cast<int>(mDepth);
+ return mDepth;
}
return -1;
*
* @return The depth used for hit-testing and renderer sorting
*/
- unsigned int GetSortingDepth();
+ uint32_t GetSortingDepth();
public:
float GetMaximumSize( Dimension::Type dimension ) const;
/**
+ * @brief Sets the update size hint of an actor for partial update.
+ * @param [in] updateSizeHint The new updateSizeHint.
+ */
+ void SetUpdateSizeHint( const Vector2& updateSizeHint );
+
+ /**
+ * @brief Return the update size hint of actor
+ * @return Return the update size hint
+ */
+ Vector2 GetUpdateSizeHint() const;
+
+ /**
* @copydoc Dali::Actor::AddRenderer()
*/
- unsigned int AddRenderer( Renderer& renderer );
+ uint32_t AddRenderer( Renderer& renderer );
/**
* @copydoc Dali::Actor::GetRendererCount()
*/
- unsigned int GetRendererCount() const;
+ uint32_t GetRendererCount() const;
/**
* @copydoc Dali::Actor::GetRendererAt()
*/
- RendererPtr GetRendererAt( unsigned int index );
+ RendererPtr GetRendererAt( uint32_t index );
/**
* @copydoc Dali::Actor::RemoveRenderer()
/**
* @copydoc Dali::Actor::RemoveRenderer()
*/
- void RemoveRenderer( unsigned int index );
+ void RemoveRenderer( uint32_t index );
public:
* @brief Emits the layout direction change signal for this actor and all its children.
* @param[in] type Whether the actor's layout direction property has changed or a parent's.
*/
- void EmitLayoutDirectionChangedSignal( DevelActor::LayoutDirection::Type type );
+ void EmitLayoutDirectionChangedSignal( LayoutDirection::Type type );
+
+ /**
+ * @brief Emits the ChildAdded signal for this actor
+ * @param[in] child The child actor that has been added
+ */
+ void EmitChildAddedSignal( Actor& child );
+
+ /**
+ * @brief Emits the ChildRemoved signal for this actor
+ * @param[in] child The child actor that has been removed
+ */
+ void EmitChildRemovedSignal( Actor& child );
/**
* @copydoc Dali::Actor::TouchedSignal()
DevelActor::VisibilityChangedSignalType& VisibilityChangedSignal();
/**
- * @copydoc DevelActor::LayoutDirectionChangedSignal
+ * @copydoc LayoutDirectionChangedSignal
+ */
+ Dali::Actor::LayoutDirectionChangedSignalType& LayoutDirectionChangedSignal();
+
+ /**
+ * @copydoc DevelActor::ChildAddedSignal
*/
- DevelActor::LayoutDirectionChangedSignalType& LayoutDirectionChangedSignal();
+ DevelActor::ChildChangedSignalType& ChildAddedSignal();
+
+ /**
+ * @copydoc DevelActor::ChildRemovedSignal
+ */
+ DevelActor::ChildChangedSignalType& ChildRemovedSignal();
+
+ /**
+ * @copydoc DevelActor::ChildOrderChangedSignal
+ */
+ DevelActor::ChildOrderChangedSignalType& ChildOrderChangedSignal();
/**
* Connects a callback function with the object's signals.
* Protected Constructor. See Actor::New().
* The second-phase construction Initialize() member should be called immediately after this.
* @param[in] derivedType The derived type of actor (if any).
+ * @param[in] reference to the node
*/
- Actor( DerivedType derivedType );
+ Actor( DerivedType derivedType, const SceneGraph::Node& node );
/**
* Second-phase constructor. Must be called immediately after creating a new Actor;
* Called on a child during Add() when the parent actor is connected to the Stage.
* @param[in] parentDepth The depth of the parent in the hierarchy.
*/
- void ConnectToStage( unsigned int parentDepth );
+ void ConnectToStage( uint32_t parentDepth );
/**
* Helper for ConnectToStage, to recursively connect a tree of actors.
* @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, unsigned int depth );
+ void RecursiveConnectToStage( ActorContainer& connectionList, uint32_t depth );
/**
* Connect the Node associated with this Actor to the scene-graph.
* @param[in] sceneGraphNodeDepths A vector capturing the nodes and their depth index
* @param[in,out] depthIndex The current depth index (traversal index)
*/
- void DepthTraverseActorTree( OwnerPointer<SceneGraph::NodeDepths>& sceneGraphNodeDepths, int& depthIndex );
+ void DepthTraverseActorTree( OwnerPointer<SceneGraph::NodeDepths>& sceneGraphNodeDepths, int32_t& depthIndex );
public:
// Default property extensions from Object
/**
- * @copydoc Dali::Internal::Object::GetDefaultPropertyCount()
- */
- virtual unsigned int GetDefaultPropertyCount() const;
-
- /**
- * @copydoc Dali::Internal::Object::GetDefaultPropertyIndices()
- */
- virtual void GetDefaultPropertyIndices( Property::IndexContainer& indices ) const;
-
- /**
- * @copydoc Dali::Internal::Object::GetDefaultPropertyName()
- */
- virtual const char* GetDefaultPropertyName( Property::Index index ) const;
-
- /**
- * @copydoc Dali::Internal::Object::GetDefaultPropertyIndex()
- */
- virtual Property::Index GetDefaultPropertyIndex( const std::string& name ) const;
-
- /**
- * @copydoc Dali::Internal::Object::IsDefaultPropertyWritable()
- */
- virtual bool IsDefaultPropertyWritable( Property::Index index ) const;
-
- /**
- * @copydoc Dali::Internal::Object::IsDefaultPropertyAnimatable()
- */
- virtual bool IsDefaultPropertyAnimatable( Property::Index index ) const;
-
- /**
- * @copydoc Dali::Internal::Object::IsDefaultPropertyAConstraintInput()
- */
- virtual bool IsDefaultPropertyAConstraintInput( Property::Index index ) const;
-
- /**
- * @copydoc Dali::Internal::Object::GetDefaultPropertyType()
- */
- virtual Property::Type GetDefaultPropertyType( Property::Index index ) const;
-
- /**
* @copydoc Dali::Internal::Object::SetDefaultProperty()
*/
virtual void SetDefaultProperty( Property::Index index, const Property::Value& propertyValue );
virtual void OnNotifyDefaultPropertyAnimation( Animation& animation, Property::Index index, const Property::Value& value, Animation::Type animationType );
/**
- * @copydoc Dali::Internal::Object::GetPropertyOwner()
- */
- virtual const SceneGraph::PropertyOwner* GetPropertyOwner() const;
-
- /**
- * @copydoc Dali::Internal::Object::GetSceneObject()
- */
- virtual const SceneGraph::PropertyOwner* GetSceneObject() const;
-
- /**
* @copydoc Dali::Internal::Object::GetSceneObjectAnimatableProperty()
*/
virtual const SceneGraph::PropertyBase* GetSceneObjectAnimatableProperty( Property::Index index ) const;
/**
* @copydoc Dali::Internal::Object::GetPropertyComponentIndex()
*/
- virtual int GetPropertyComponentIndex( Property::Index index ) const;
+ virtual int32_t GetPropertyComponentIndex( Property::Index index ) const;
+
+ /**
+ * Retrieve the actor's node.
+ * @return The node used by this actor
+ */
+ const SceneGraph::Node& GetNode() const
+ {
+ return *static_cast<const SceneGraph::Node*>( mUpdateObject );
+ }
/**
* @copydoc Dali::DevelActor::Raise()
*/
void LowerBelow( Internal::Actor& target );
+public:
+
+ /**
+ * Sets the scene which this actor is added to.
+ * @param[in] scene The scene
+ */
+ void SetScene( Scene& scene );
+
+ /**
+ * Gets the scene which this actor is added to.
+ * @return The scene
+ */
+ Scene& GetScene() const;
+
private:
struct SendMessage
};
};
- // Undefined
- Actor();
-
- // Undefined
- Actor( const Actor& );
-
- // Undefined
- Actor& operator=( const Actor& rhs );
+ // Remove default constructor and copy constructor
+ Actor() = delete;
+ Actor( const Actor& ) = delete;
+ Actor& operator=( const Actor& rhs ) = delete;
/**
* Set the actors parent.
void SetParent( Actor* parent );
/**
- * Helper to create a Node for this Actor.
- * To be overriden in derived classes.
- * @return A newly allocated node.
- */
- virtual SceneGraph::Node* CreateNode() const;
-
- /**
* For use in derived classes, called after Initialize()
*/
virtual void OnInitialize()
* @param[in] order The sibling order this Actor should be. It will place
* the actor at this index in it's parent's child array.
*/
- void SetSiblingOrder( unsigned int order);
+ void SetSiblingOrder( uint32_t order);
/**
* Get Sibling order
* @return the order of this actor amongst it's siblings
*/
- unsigned int GetSiblingOrder() const;
+ uint32_t GetSiblingOrder() const;
/**
* Request that the stage rebuilds the actor depth indices.
* @param[in] actor The actor for seting layout direction.
* @param[in] direction New layout direction.
*/
- void InheritLayoutDirectionRecursively( ActorPtr actor, Dali::DevelActor::LayoutDirection::Type direction, bool set = false );
+ void InheritLayoutDirectionRecursively( ActorPtr actor, Dali::LayoutDirection::Type direction, bool set = false );
protected:
+ Scene* mScene; ///< The scene the actor is added to
+
Actor* mParent; ///< Each actor (except the root) can have one parent
ActorContainer* mChildren; ///< Container of referenced actors, lazily initialized
RendererContainer* mRenderers; ///< Renderer container
- const SceneGraph::Node* mNode; ///< Not owned
Vector3* mParentOrigin; ///< NULL means ParentOrigin::DEFAULT. ParentOrigin is non-animatable
Vector3* mAnchorPoint; ///< NULL means AnchorPoint::DEFAULT. AnchorPoint is non-animatable
Dali::Actor::OffStageSignalType mOffStageSignal;
Dali::Actor::OnRelayoutSignalType mOnRelayoutSignal;
DevelActor::VisibilityChangedSignalType mVisibilityChangedSignal;
- DevelActor::LayoutDirectionChangedSignalType mLayoutDirectionChangedSignal;
+ Dali::Actor::LayoutDirectionChangedSignalType mLayoutDirectionChangedSignal;
+ DevelActor::ChildChangedSignalType mChildAddedSignal;
+ DevelActor::ChildChangedSignalType mChildRemovedSignal;
+ DevelActor::ChildOrderChangedSignalType mChildOrderChangedSignal;
Quaternion mTargetOrientation; ///< Event-side storage for orientation
Vector4 mTargetColor; ///< Event-side storage for color
Vector3 mTargetPosition; ///< Event-side storage for position (not a pointer as most actors will have a position)
Vector3 mTargetScale; ///< Event-side storage for scale
- std::string mName; ///< Name of the actor
- unsigned int mId; ///< A unique ID to identify the actor starting from 1, and 0 is reserved
-
- uint32_t mSortedDepth; ///< The sorted depth index. A combination of tree traversal and sibling order.
- uint16_t mDepth; ///< The depth in the hierarchy of the actor. Only 4096 levels of depth are supported
-
+ std::string mName; ///< Name of the actor
+ uint32_t mSortedDepth; ///< The sorted depth index. A combination of tree traversal and sibling order.
+ int16_t mDepth; ///< The depth in the hierarchy of the actor. Only 32,767 levels of depth are supported
const bool mIsRoot : 1; ///< Flag to identify the root actor
const bool mIsLayer : 1; ///< Flag to identify that this is a layer
bool mPositionUsesAnchorPoint : 1; ///< Cached: Whether the position uses the anchor point or not.
bool mVisible : 1; ///< Cached: Whether the actor is visible or not.
bool mInheritLayoutDirection : 1; ///< Whether the actor inherits the layout direction from parent.
- DevelActor::LayoutDirection::Type mLayoutDirection : 1; ///< Layout direction, Left to Right or Right to Left.
- DrawMode::Type mDrawMode : 2; ///< Cached: How the actor and its children should be drawn
- PositionInheritanceMode mPositionInheritanceMode : 2; ///< Cached: Determines how position is inherited
- ColorMode mColorMode : 2; ///< Cached: Determines whether mWorldColor is inherited
- ClippingMode::Type mClippingMode : 2; ///< Cached: Determines which clipping mode (if any) to use.
+ LayoutDirection::Type mLayoutDirection : 2; ///< Layout direction, Left to Right or Right to Left.
+ DrawMode::Type mDrawMode : 3; ///< Cached: How the actor and its children should be drawn
+ ColorMode mColorMode : 3; ///< Cached: Determines whether mWorldColor is inherited
+ ClippingMode::Type mClippingMode : 3; ///< Cached: Determines which clipping mode (if any) to use.
private:
static ActorContainer mNullChildren; ///< Empty container (shared by all actors, returned by GetChildren() const)
- static unsigned int mActorCounter; ///< A counter to track the actor instance creation
+
};
} // namespace Internal