1 #ifndef DALI_INTERNAL_SCENE_GRAPH_NODE_H
2 #define DALI_INTERNAL_SCENE_GRAPH_NODE_H
5 * Copyright (c) 2018 Samsung Electronics Co., Ltd.
7 * Licensed under the Apache License, Version 2.0 (the "License");
8 * you may not use this file except in compliance with the License.
9 * You may obtain a copy of the License at
11 * http://www.apache.org/licenses/LICENSE-2.0
13 * Unless required by applicable law or agreed to in writing, software
14 * distributed under the License is distributed on an "AS IS" BASIS,
15 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16 * See the License for the specific language governing permissions and
17 * limitations under the License.
22 #include <dali/public-api/actors/actor-enumerations.h>
23 #include <dali/public-api/actors/draw-mode.h>
24 #include <dali/public-api/math/quaternion.h>
25 #include <dali/public-api/math/math-utils.h>
26 #include <dali/public-api/math/vector3.h>
27 #include <dali/integration-api/debug.h>
28 #include <dali/internal/common/message.h>
29 #include <dali/internal/event/common/event-thread-services.h>
30 #include <dali/internal/render/data-providers/node-data-provider.h>
31 #include <dali/internal/update/common/animatable-property.h>
32 #include <dali/internal/update/common/property-owner.h>
33 #include <dali/internal/update/common/scene-graph-buffers.h>
34 #include <dali/internal/update/common/inherited-property.h>
35 #include <dali/internal/update/manager/transform-manager.h>
36 #include <dali/internal/update/manager/transform-manager-property.h>
37 #include <dali/internal/update/nodes/node-declarations.h>
38 #include <dali/internal/update/rendering/scene-graph-renderer.h>
46 // Value types used by messages.
47 template <> struct ParameterType< ColorMode > : public BasicType< ColorMode > {};
48 template <> struct ParameterType< ClippingMode::Type > : public BasicType< ClippingMode::Type > {};
59 // Flags which require the scene renderable lists to be updated
60 static NodePropertyFlags RenderableUpdateFlags = NodePropertyFlags::TRANSFORM | NodePropertyFlags::CHILD_DELETED;
63 * Node is the base class for all nodes in the Scene Graph.
65 * Each node provides a transformation which applies to the node and
66 * its children. Node data is double-buffered. This allows an update
67 * thread to modify node data, without interferring with another
68 * thread reading the values from the previous update traversal.
70 class Node : public PropertyOwner, public NodeDataProvider
75 static const ColorMode DEFAULT_COLOR_MODE;
80 * Construct a new Node.
87 static void Delete( Node* node );
90 * Called during UpdateManager::DestroyNode shortly before Node is destroyed.
95 * @return the unique ID of the node
97 uint32_t GetId() const;
102 * Query whether the node is a layer.
103 * @return True if the node is a layer.
111 * Convert a node to a layer.
112 * @return A pointer to the layer, or NULL.
114 virtual Layer* GetLayer()
120 * This method sets clipping information on the node based on its hierarchy in the scene-graph.
121 * A value is calculated that can be used during sorting to increase sort speed.
122 * @param[in] clippingId The Clipping ID of the node to set
123 * @param[in] clippingDepth The Clipping Depth of the node to set
124 * @param[in] scissorDepth The Scissor Clipping Depth of the node to set
126 void SetClippingInformation( const uint32_t clippingId, const uint32_t clippingDepth, const uint32_t scissorDepth )
128 // We only set up the sort value if we have a stencil clipping depth, IE. At least 1 clipping node has been hit.
129 // If not, if we traverse down a clipping tree and back up, and there is another
130 // node on the parent, this will have a non-zero clipping ID that must be ignored
131 if( clippingDepth > 0u )
133 mClippingDepth = clippingDepth;
135 // Calculate the sort value here on write, as when read (during sort) it may be accessed several times.
136 // The items must be sorted by Clipping ID first (so the ID is kept in the most-significant bits).
137 // For the same ID, the clipping nodes must be first, so we negate the
138 // clipping enabled flag and set it as the least significant bit.
139 mClippingSortModifier = ( clippingId << 1u ) | ( mClippingMode == ClippingMode::DISABLED ? 1u : 0u );
143 // If we do not have a clipping depth, then set this to 0 so we do not have a Clipping ID either.
144 mClippingSortModifier = 0u;
147 // The scissor depth does not modify the clipping sort modifier (as scissor clips are 2D only).
148 // For this reason we can always update the member variable.
149 mScissorDepth = scissorDepth;
153 * Gets the Clipping ID for this node.
154 * @return The Clipping ID for this node.
156 uint32_t GetClippingId() const
158 return mClippingSortModifier >> 1u;
162 * Gets the Clipping Depth for this node.
163 * @return The Clipping Depth for this node.
165 uint32_t GetClippingDepth() const
167 return mClippingDepth;
171 * Gets the Scissor Clipping Depth for this node.
172 * @return The Scissor Clipping Depth for this node.
174 uint32_t GetScissorDepth() const
176 return mScissorDepth;
180 * Sets the clipping mode for this node.
181 * @param[in] clippingMode The ClippingMode to set
183 void SetClippingMode( const ClippingMode::Type clippingMode )
185 SetPropertyDirty( true );
186 mClippingMode = clippingMode;
190 * Gets the Clipping Mode for this node.
191 * @return The ClippingMode of this node
193 ClippingMode::Type GetClippingMode() const
195 return mClippingMode;
199 * Add a renderer to the node
200 * @param[in] renderer The renderer added to the node
202 void AddRenderer( Renderer* renderer );
205 * Remove a renderer from the node
206 * @param[in] renderer The renderer to be removed
208 void RemoveRenderer( const Renderer* renderer );
211 * Get the renderer at the given index
214 Renderer* GetRendererAt( uint32_t index ) const
216 return mRenderer[index];
220 * Retrieve the number of renderers for the node
222 uint32_t GetRendererCount() const
224 return static_cast<uint32_t>( mRenderer.Size() );
227 // Containment methods
230 * Query whether a node is the root node. Root nodes cannot have a parent node.
231 * A node becomes a root node, when it is installed by UpdateManager.
232 * @return True if the node is a root node.
240 * Set whether a node is the root node. Root nodes cannot have a parent node.
241 * This method should only be called by UpdateManager.
242 * @pre When isRoot is true, the node must not have a parent.
243 * @param[in] isRoot Whether the node is now a root node.
245 void SetRoot(bool isRoot);
248 * Retrieve the parent of a Node.
249 * @return The parent node, or NULL if the Node has not been added to the scene-graph.
257 * Retrieve the parent of a Node.
258 * @return The parent node, or NULL if the Node has not been added to the scene-graph.
260 const Node* GetParent() const
266 * @return true if the node is connected to SceneGraph
268 bool ConnectedToScene()
270 return IsRoot() || GetParent();
274 * Connect a node to the scene-graph.
275 * @pre A node cannot be added to itself.
276 * @pre The parent node is connected to the scene-graph.
277 * @pre The childNode does not already have a parent.
278 * @pre The childNode is not a root node.
279 * @param[in] childNode The child to add.
281 void ConnectChild( Node* childNode );
284 * Disconnect a child (& its children) from the scene-graph.
285 * @pre childNode is a child of this Node.
286 * @param[in] updateBufferIndex The current update buffer index.
287 * @param[in] childNode The node to disconnect.
289 void DisconnectChild( BufferIndex updateBufferIndex, Node& childNode );
292 * Retrieve the children a Node.
293 * @return The container of children.
295 const NodeContainer& GetChildren() const
301 * Retrieve the children a Node.
302 * @return The container of children.
304 NodeContainer& GetChildren()
312 * Flag that one of the node values has changed in the current frame.
313 * @param[in] flag The flag to set.
315 void SetDirtyFlag( NodePropertyFlags flag )
317 SetPropertyDirty( true );
322 * Flag that all of the node values are dirty.
324 void SetAllDirtyFlags()
326 SetPropertyDirty( true );
327 mDirtyFlags = NodePropertyFlags::ALL;
331 * Query whether a node is dirty.
332 * @return The dirty flags
334 NodePropertyFlags GetDirtyFlags() const;
337 * Query inherited dirty flags.
339 * @param The parentFlags to or with
340 * @return The inherited dirty flags
342 NodePropertyFlags GetInheritedDirtyFlags( NodePropertyFlags parentFlags ) const;
345 * Retrieve the parent-origin of the node.
346 * @return The parent-origin.
348 const Vector3& GetParentOrigin() const
350 return mParentOrigin.Get(0);
354 * Sets both the local & base parent-origins of the node.
355 * @param[in] origin The new local & base parent-origins.
357 void SetParentOrigin(const Vector3& origin)
359 mParentOrigin.Set(0,origin );
363 * Retrieve the anchor-point of the node.
364 * @return The anchor-point.
366 const Vector3& GetAnchorPoint() const
368 return mAnchorPoint.Get(0);
372 * Sets both the local & base anchor-points of the node.
373 * @param[in] anchor The new local & base anchor-points.
375 void SetAnchorPoint(const Vector3& anchor)
377 mAnchorPoint.Set(0, anchor );
381 * Retrieve the local position of the node, relative to its parent.
382 * @param[in] bufferIndex The buffer to read from.
383 * @return The local position.
385 const Vector3& GetPosition(BufferIndex bufferIndex) const
387 if( mTransformId != INVALID_TRANSFORM_ID )
389 return mPosition.Get(bufferIndex);
392 return Vector3::ZERO;
396 * Retrieve the position of the node derived from the position of all its parents.
397 * @return The world position.
399 const Vector3& GetWorldPosition( BufferIndex bufferIndex ) const
401 return mWorldPosition.Get(bufferIndex);
405 * Set whether the Node inherits position.
406 * @param[in] inherit True if the parent position is inherited.
408 void SetInheritPosition(bool inherit)
410 if( mTransformId != INVALID_TRANSFORM_ID )
412 mTransformManager->SetInheritPosition( mTransformId, inherit );
417 * Retrieve the local orientation of the node, relative to its parent.
418 * @param[in] bufferIndex The buffer to read from.
419 * @return The local orientation.
421 const Quaternion& GetOrientation(BufferIndex bufferIndex) const
423 if( mTransformId != INVALID_TRANSFORM_ID )
425 return mOrientation.Get(0);
428 return Quaternion::IDENTITY;
432 * Retrieve the orientation of the node derived from the rotation of all its parents.
433 * @param[in] bufferIndex The buffer to read from.
434 * @return The world rotation.
436 const Quaternion& GetWorldOrientation( BufferIndex bufferIndex ) const
438 return mWorldOrientation.Get(0);
442 * Set whether the Node inherits orientation.
443 * @param[in] inherit True if the parent orientation is inherited.
445 void SetInheritOrientation(bool inherit)
447 if( mTransformId != INVALID_TRANSFORM_ID )
449 mTransformManager->SetInheritOrientation(mTransformId, inherit );
454 * Retrieve the local scale of the node, relative to its parent.
455 * @param[in] bufferIndex The buffer to read from.
456 * @return The local scale.
458 const Vector3& GetScale(BufferIndex bufferIndex) const
460 if( mTransformId != INVALID_TRANSFORM_ID )
462 return mScale.Get(0);
470 * Retrieve the scale of the node derived from the scale of all its parents.
471 * @param[in] bufferIndex The buffer to read from.
472 * @return The world scale.
474 const Vector3& GetWorldScale( BufferIndex bufferIndex ) const
476 return mWorldScale.Get(0);
480 * Set whether the Node inherits scale.
481 * @param inherit True if the Node inherits scale.
483 void SetInheritScale( bool inherit )
485 if( mTransformId != INVALID_TRANSFORM_ID )
487 mTransformManager->SetInheritScale(mTransformId, inherit );
492 * Retrieve the visibility of the node.
493 * @param[in] bufferIndex The buffer to read from.
494 * @return True if the node is visible.
496 bool IsVisible(BufferIndex bufferIndex) const
498 return mVisible[bufferIndex];
502 * Retrieve the opacity of the node.
503 * @param[in] bufferIndex The buffer to read from.
504 * @return The opacity.
506 float GetOpacity(BufferIndex bufferIndex) const
508 return mColor[bufferIndex].a;
512 * Retrieve the color of the node.
513 * @param[in] bufferIndex The buffer to read from.
516 const Vector4& GetColor(BufferIndex bufferIndex) const
518 return mColor[bufferIndex];
522 * Sets the color of the node derived from the color of all its parents.
523 * @param[in] color The world color.
524 * @param[in] updateBufferIndex The current update buffer index.
526 void SetWorldColor(const Vector4& color, BufferIndex updateBufferIndex)
528 mWorldColor.Set( updateBufferIndex, color );
532 * Sets the color of the node derived from the color of all its parents.
533 * This method should only be called when the parents world color is up-to-date.
534 * @pre The node has a parent.
535 * @param[in] updateBufferIndex The current update buffer index.
537 void InheritWorldColor( BufferIndex updateBufferIndex )
539 DALI_ASSERT_DEBUG(mParent != NULL);
542 if( mColorMode == USE_OWN_MULTIPLY_PARENT_ALPHA )
544 const Vector4& ownColor = mColor[updateBufferIndex];
545 mWorldColor.Set( updateBufferIndex, ownColor.r, ownColor.g, ownColor.b, ownColor.a * mParent->GetWorldColor(updateBufferIndex).a );
547 else if( mColorMode == USE_OWN_MULTIPLY_PARENT_COLOR )
549 mWorldColor.Set( updateBufferIndex, mParent->GetWorldColor(updateBufferIndex) * mColor[updateBufferIndex] );
551 else if( mColorMode == USE_PARENT_COLOR )
553 mWorldColor.Set( updateBufferIndex, mParent->GetWorldColor(updateBufferIndex) );
555 else // USE_OWN_COLOR
557 mWorldColor.Set( updateBufferIndex, mColor[updateBufferIndex] );
562 * Copies the previous inherited scale, if this changed in the previous frame.
563 * This method should be called instead of InheritWorldScale i.e. if the inherited scale
564 * does not need to be recalculated in the current frame.
565 * @param[in] updateBufferIndex The current update buffer index.
567 void CopyPreviousWorldColor( BufferIndex updateBufferIndex )
569 mWorldColor.CopyPrevious( updateBufferIndex );
573 * Retrieve the color of the node, possibly derived from the color
574 * of all its parents, depending on the value of mColorMode.
575 * @param[in] bufferIndex The buffer to read from.
576 * @return The world color.
578 const Vector4& GetWorldColor(BufferIndex bufferIndex) const
580 return mWorldColor[bufferIndex];
584 * Set the color mode. This specifies whether the Node uses its own color,
585 * or inherits its parent color.
586 * @param[in] colorMode The new color mode.
588 void SetColorMode( ColorMode colorMode )
590 mColorMode = colorMode;
592 SetDirtyFlag( NodePropertyFlags::COLOR );
596 * Retrieve the color mode.
597 * @return The color mode.
599 ColorMode GetColorMode() const
605 * Retrieve the size of the node.
606 * @param[in] bufferIndex The buffer to read from.
609 const Vector3& GetSize(BufferIndex bufferIndex) const
611 if( mTransformId != INVALID_TRANSFORM_ID )
616 return Vector3::ZERO;
620 * Retrieve the bounding sphere of the node
621 * @return A vector4 describing the bounding sphere. XYZ is the center and W is the radius
623 const Vector4& GetBoundingSphere() const
625 if( mTransformId != INVALID_TRANSFORM_ID )
627 return mTransformManager->GetBoundingSphere( mTransformId );
630 return Vector4::ZERO;
634 * Retrieve world matrix and size of the node
635 * @param[out] The local to world matrix of the node
636 * @param[out] size The current size of the node
638 void GetWorldMatrixAndSize( Matrix& worldMatrix, Vector3& size ) const
640 if( mTransformId != INVALID_TRANSFORM_ID )
642 mTransformManager->GetWorldMatrixAndSize( mTransformId, worldMatrix, size );
647 * Checks if local matrix has changed since last update
648 * @return true if local matrix has changed, false otherwise
650 bool IsLocalMatrixDirty() const
652 return (mTransformId != INVALID_TRANSFORM_ID) &&
653 (mTransformManager->IsLocalMatrixDirty( mTransformId ));
657 * Retrieve the cached world-matrix of a node.
658 * @param[in] bufferIndex The buffer to read from.
659 * @return The world-matrix.
661 const Matrix& GetWorldMatrix( BufferIndex bufferIndex ) const
663 return mWorldMatrix.Get(bufferIndex);
667 * Mark the node as exclusive to a single RenderTask.
668 * @param[in] renderTask The render-task, or NULL if the Node is not exclusive to a single RenderTask.
670 void SetExclusiveRenderTask( RenderTask* renderTask )
672 mExclusiveRenderTask = renderTask;
676 * Query whether the node is exclusive to a single RenderTask.
677 * @return The render-task, or NULL if the Node is not exclusive to a single RenderTask.
679 RenderTask* GetExclusiveRenderTask() const
681 return mExclusiveRenderTask;
685 * Set how the Node and its children should be drawn; see Dali::Actor::SetDrawMode() for more details.
686 * @param[in] drawMode The new draw-mode to use.
688 void SetDrawMode( const DrawMode::Type& drawMode )
690 SetPropertyDirty( true );
691 mDrawMode = drawMode;
695 * Returns whether node is an overlay or not.
696 * @return True if node is an overlay, false otherwise.
698 DrawMode::Type GetDrawMode() const
704 * Returns the transform id of the node
705 * @return The transform component id of the node
707 TransformId GetTransformId() const
713 * Equality operator, checks for identity, not values.
716 bool operator==( const Node* rhs ) const
718 return ( this == rhs );
722 * @brief Sets the sibling order of the node
723 * @param[in] order The new order
725 void SetDepthIndex( uint32_t depthIndex )
727 SetPropertyDirty( true );
728 mDepthIndex = depthIndex;
732 * @brief Get the depth index of the node
733 * @return Current depth index
735 uint32_t GetDepthIndex() const
741 * @brief Sets the boolean which states whether the position should use the anchor-point.
742 * @param[in] positionUsesAnchorPoint True if the position should use the anchor-point
744 void SetPositionUsesAnchorPoint( bool positionUsesAnchorPoint )
746 if( mTransformId != INVALID_TRANSFORM_ID && mPositionUsesAnchorPoint != positionUsesAnchorPoint )
748 mPositionUsesAnchorPoint = positionUsesAnchorPoint;
749 mTransformManager->SetPositionUsesAnchorPoint( mTransformId, mPositionUsesAnchorPoint );
754 * @brief Sets whether the node is culled or not.
755 * @param[in] bufferIndex The buffer to read from.
756 * @param[in] culled True if the node is culled.
758 void SetCulled( BufferIndex bufferIndex, bool culled )
760 mCulled[bufferIndex] = culled;
764 * @brief Retrieves whether the node is culled or not.
765 * @param[in] bufferIndex The buffer to read from.
766 * @return True if the node is culled.
768 bool IsCulled( BufferIndex bufferIndex ) const
770 return mCulled[bufferIndex];
774 * @Is component changed
775 * @Return true if component is changed else false
777 bool IsComponentChanged()
779 return (mTransformId != INVALID_TRANSFORM_ID) &&
780 (mTransformManager->IsComponentChanged( mTransformId ));
784 * Retrieve the update size hint of the node
785 * @return A vector3 describing the update size hint
787 const Vector3& GetUpdateSizeHint( BufferIndex bufferIndex ) const
789 if( mTransformId != INVALID_TRANSFORM_ID )
791 return mTransformManager->GetUpdateSizeHint( mTransformId );
794 return Vector3::ZERO;
798 * Set whether partial update needs to run following a render.
799 * @param[in] value Set to true if an partial update is required to be run
801 virtual void SetPropertyDirty( bool value );
804 * Query the property status following rendering of a frame.
805 * @return True if the property has changed
807 virtual bool IsPropertyDirty() const;
811 * @copydoc UniformMap::Add
813 void AddUniformMapping( OwnerPointer< UniformPropertyMapping >& map );
816 * @copydoc UniformMap::Remove
818 void RemoveUniformMapping( const std::string& uniformName );
821 * Prepare the node for rendering.
822 * This is called by the UpdateManager when an object is due to be rendered in the current frame.
823 * @param[in] updateBufferIndex The current update buffer index.
825 void PrepareRender( BufferIndex bufferIndex );
828 * Called by UpdateManager when the node is added.
829 * Creates a new transform component in the transform manager and initialize all the properties
830 * related to the transformation
831 * @param[in] transformManager A pointer to the trnasform manager (Owned by UpdateManager)
833 void CreateTransform( SceneGraph::TransformManager* transformManager );
838 void ResetDirtyFlags( BufferIndex updateBufferIndex );
843 * Set the parent of a Node.
844 * @param[in] parentNode the new parent.
846 void SetParent( Node& parentNode );
851 * Protected constructor; See also Node::New()
856 * Protected virtual destructor; See also Node::Delete( Node* )
857 * Kept protected to allow destructor chaining from layer
861 private: // from NodeDataProvider
864 * @copydoc NodeDataProvider::GetModelMatrix
866 virtual const Matrix& GetModelMatrix( BufferIndex bufferIndex ) const
868 return GetWorldMatrix( bufferIndex );
872 * @copydoc NodeDataProvider::GetRenderColor
874 virtual const Vector4& GetRenderColor( BufferIndex bufferIndex ) const
876 return GetWorldColor( bufferIndex );
879 public: // From UniformMapDataProvider
881 * @copydoc UniformMapDataProvider::GetUniformMapChanged
883 virtual bool GetUniformMapChanged( BufferIndex bufferIndex ) const
885 return mUniformMapChanged[bufferIndex];
889 * @copydoc UniformMapDataProvider::GetUniformMap
891 virtual const CollectedUniformMap& GetUniformMap( BufferIndex bufferIndex ) const
893 return mCollectedUniformMap[bufferIndex];
902 Node& operator=(const Node& rhs);
905 * Recursive helper to disconnect a Node and its children.
906 * Disconnected Nodes have no parent or children.
907 * @param[in] updateBufferIndex The current update buffer index.
909 void RecursiveDisconnectFromSceneGraph( BufferIndex updateBufferIndex );
911 public: // Default properties
913 TransformManager* mTransformManager;
914 TransformId mTransformId;
915 TransformManagerPropertyVector3 mParentOrigin; ///< Local transform; the position is relative to this. Sets the Transform flag dirty when changed
916 TransformManagerPropertyVector3 mAnchorPoint; ///< Local transform; local center of rotation. Sets the Transform flag dirty when changed
917 TransformManagerPropertyVector3 mSize; ///< Size is provided for layouting
918 TransformManagerPropertyVector3 mPosition; ///< Local transform; distance between parent-origin & anchor-point
919 TransformManagerPropertyQuaternion mOrientation; ///< Local transform; rotation relative to parent node
920 TransformManagerPropertyVector3 mScale; ///< Local transform; scale relative to parent node
921 TransformManagerPropertyVector3 mUpdateSizeHint; ///< Local transform; update size hint is provided for partial update
923 AnimatableProperty<bool> mVisible; ///< Visibility can be inherited from the Node hierachy
924 AnimatableProperty<bool> mCulled; ///< True if the node is culled. This is not animatable. It is just double-buffered.
925 AnimatableProperty<Vector4> mColor; ///< Color can be inherited from the Node hierarchy
927 // Inherited properties; read-only from public API
929 TransformManagerVector3Input mWorldPosition; ///< Full inherited position
930 TransformManagerVector3Input mWorldScale;
931 TransformManagerQuaternionInput mWorldOrientation; ///< Full inherited orientation
932 TransformManagerMatrixInput mWorldMatrix; ///< Full inherited world matrix
933 InheritedColor mWorldColor; ///< Full inherited color
935 uint32_t mClippingSortModifier; ///< Contains bit-packed clipping information for quick access when sorting
936 const uint32_t mId; ///< The Unique ID of the node.
940 static uint32_t mNodeCounter; ///< count of total nodes, used for unique ids
942 Node* mParent; ///< Pointer to parent node (a child is owned by its parent)
943 RenderTask* mExclusiveRenderTask; ///< Nodes can be marked as exclusive to a single RenderTask
945 RendererContainer mRenderer; ///< Container of renderers; not owned
947 NodeContainer mChildren; ///< Container of children; not owned
949 CollectedUniformMap mCollectedUniformMap[2]; ///< Uniform maps of the node
950 uint32_t mUniformMapChanged[2]; ///< Records if the uniform map has been altered this frame
951 uint32_t mClippingDepth; ///< The number of stencil clipping nodes deep this node is
952 uint32_t mScissorDepth; ///< The number of scissor clipping nodes deep this node is
954 uint32_t mDepthIndex; ///< Depth index of the node
956 // flags, compressed to bitfield
957 NodePropertyFlags mDirtyFlags; ///< Dirty flags for each of the Node properties
958 uint32_t mRegenerateUniformMap:2; ///< Indicate if the uniform map has to be regenerated this frame
959 DrawMode::Type mDrawMode:3; ///< How the Node and its children should be drawn
960 ColorMode mColorMode:3; ///< Determines whether mWorldColor is inherited, 2 bits is enough
961 ClippingMode::Type mClippingMode:3; ///< The clipping mode of this node
962 bool mIsRoot:1; ///< True if the node cannot have a parent
963 bool mIsLayer:1; ///< True if the node is a layer
964 bool mPositionUsesAnchorPoint:1; ///< True if the node should use the anchor-point when calculating the position
966 // Changes scope, should be at end of class
967 DALI_LOG_OBJECT_STRING_DECLARATION;
972 inline void SetInheritOrientationMessage( EventThreadServices& eventThreadServices, const Node& node, bool inherit )
974 typedef MessageValue1< Node, bool > LocalType;
976 // Reserve some memory inside the message queue
977 uint32_t* slot = eventThreadServices.ReserveMessageSlot( sizeof( LocalType ) );
979 // Construct message in the message queue memory; note that delete should not be called on the return value
980 new (slot) LocalType( &node, &Node::SetInheritOrientation, inherit );
983 inline void SetParentOriginMessage( EventThreadServices& eventThreadServices, const Node& node, const Vector3& origin )
985 typedef MessageValue1< Node, Vector3 > LocalType;
987 // Reserve some memory inside the message queue
988 uint32_t* slot = eventThreadServices.ReserveMessageSlot( sizeof( LocalType ) );
990 // Construct message in the message queue memory; note that delete should not be called on the return value
991 new (slot) LocalType( &node, &Node::SetParentOrigin, origin );
994 inline void SetAnchorPointMessage( EventThreadServices& eventThreadServices, const Node& node, const Vector3& anchor )
996 typedef MessageValue1< Node, Vector3 > LocalType;
998 // Reserve some memory inside the message queue
999 uint32_t* slot = eventThreadServices.ReserveMessageSlot( sizeof( LocalType ) );
1001 // Construct message in the message queue memory; note that delete should not be called on the return value
1002 new (slot) LocalType( &node, &Node::SetAnchorPoint, anchor );
1005 inline void SetInheritPositionMessage( EventThreadServices& eventThreadServices, const Node& node, bool inherit )
1007 typedef MessageValue1< Node, bool > LocalType;
1009 // Reserve some memory inside the message queue
1010 uint32_t* slot = eventThreadServices.ReserveMessageSlot( sizeof( LocalType ) );
1012 // Construct message in the message queue memory; note that delete should not be called on the return value
1013 new (slot) LocalType( &node, &Node::SetInheritPosition, inherit );
1016 inline void SetInheritScaleMessage( EventThreadServices& eventThreadServices, const Node& node, bool inherit )
1018 typedef MessageValue1< Node, bool > LocalType;
1020 // Reserve some memory inside the message queue
1021 uint32_t* slot = eventThreadServices.ReserveMessageSlot( sizeof( LocalType ) );
1023 // Construct message in the message queue memory; note that delete should not be called on the return value
1024 new (slot) LocalType( &node, &Node::SetInheritScale, inherit );
1027 inline void SetColorModeMessage( EventThreadServices& eventThreadServices, const Node& node, ColorMode colorMode )
1029 typedef MessageValue1< Node, ColorMode > LocalType;
1031 // Reserve some memory inside the message queue
1032 uint32_t* slot = eventThreadServices.ReserveMessageSlot( sizeof( LocalType ) );
1034 // Construct message in the message queue memory; note that delete should not be called on the return value
1035 new (slot) LocalType( &node, &Node::SetColorMode, colorMode );
1038 inline void SetDrawModeMessage( EventThreadServices& eventThreadServices, const Node& node, DrawMode::Type drawMode )
1040 typedef MessageValue1< Node, DrawMode::Type > LocalType;
1042 // Reserve some memory inside the message queue
1043 uint32_t* slot = eventThreadServices.ReserveMessageSlot( sizeof( LocalType ) );
1045 // Construct message in the message queue memory; note that delete should not be called on the return value
1046 new (slot) LocalType( &node, &Node::SetDrawMode, drawMode );
1049 inline void AttachRendererMessage( EventThreadServices& eventThreadServices, const Node& node, const Renderer& renderer )
1051 typedef MessageValue1< Node, Renderer* > LocalType;
1053 // Reserve some memory inside the message queue
1054 uint32_t* slot = eventThreadServices.ReserveMessageSlot( sizeof( LocalType ) );
1056 // Construct message in the message queue memory; note that delete should not be called on the return value
1057 new (slot) LocalType( &node, &Node::AddRenderer, const_cast<Renderer*>( &renderer ) );
1060 inline void DetachRendererMessage( EventThreadServices& eventThreadServices, const Node& node, const Renderer& renderer )
1062 typedef MessageValue1< Node, const Renderer* > LocalType;
1064 // Reserve some memory inside the message queue
1065 uint32_t* slot = eventThreadServices.ReserveMessageSlot( sizeof( LocalType ) );
1067 // Construct message in the message queue memory; note that delete should not be called on the return value
1068 new (slot) LocalType( &node, &Node::RemoveRenderer, &renderer );
1071 inline void SetDepthIndexMessage( EventThreadServices& eventThreadServices, const Node& node, uint32_t depthIndex )
1073 typedef MessageValue1< Node, uint32_t > LocalType;
1075 // Reserve some memory inside the message queue
1076 uint32_t* slot = eventThreadServices.ReserveMessageSlot( sizeof( LocalType ) );
1078 // Construct message in the message queue memory; note that delete should not be called on the return value
1079 new (slot) LocalType( &node, &Node::SetDepthIndex, depthIndex );
1082 inline void SetClippingModeMessage( EventThreadServices& eventThreadServices, const Node& node, ClippingMode::Type clippingMode )
1084 typedef MessageValue1< Node, ClippingMode::Type > LocalType;
1086 // Reserve some memory inside the message queue
1087 uint32_t* slot = eventThreadServices.ReserveMessageSlot( sizeof( LocalType ) );
1089 // Construct message in the message queue memory; note that delete should not be called on the return value
1090 new (slot) LocalType( &node, &Node::SetClippingMode, clippingMode );
1093 inline void SetPositionUsesAnchorPointMessage( EventThreadServices& eventThreadServices, const Node& node, bool positionUsesAnchorPoint )
1095 typedef MessageValue1< Node, bool > LocalType;
1097 // Reserve some memory inside the message queue
1098 uint32_t* slot = eventThreadServices.ReserveMessageSlot( sizeof( LocalType ) );
1100 // Construct message in the message queue memory; note that delete should not be called on the return value
1101 new (slot) LocalType( &node, &Node::SetPositionUsesAnchorPoint, positionUsesAnchorPoint );
1104 } // namespace SceneGraph
1106 // Template specialisation for OwnerPointer<Node>, because delete is protected
1108 inline void OwnerPointer<Dali::Internal::SceneGraph::Node>::Reset()
1110 if (mObject != NULL)
1112 Dali::Internal::SceneGraph::Node::Delete(mObject);
1116 } // namespace Internal
1118 // Template specialisations for OwnerContainer<Node*>, because delete is protected
1120 inline void OwnerContainer<Dali::Internal::SceneGraph::Node*>::Delete( Dali::Internal::SceneGraph::Node* pointer )
1122 Dali::Internal::SceneGraph::Node::Delete(pointer);
1126 #endif // DALI_INTERNAL_SCENE_GRAPH_NODE_H