2 * Copyright (c) 2023 Samsung Electronics Co., Ltd.
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
19 #include <dali/internal/update/nodes/node.h>
22 #include <dali/internal/common/internal-constants.h>
23 #include <dali/internal/common/memory-pool-object-allocator.h>
24 #include <dali/internal/update/common/discard-queue.h>
25 #include <dali/public-api/common/constants.h>
26 #include <dali/public-api/common/dali-common.h>
28 #include <dali/internal/update/common/resetter-manager.h> ///< For AddInitializeResetter
32 // Memory pool used to allocate new nodes. Memory used by this pool will be released when process dies
33 // or DALI library is unloaded
34 Dali::Internal::MemoryPoolObjectAllocator<Dali::Internal::SceneGraph::Node>& GetNodeMemoryPool()
36 static Dali::Internal::MemoryPoolObjectAllocator<Dali::Internal::SceneGraph::Node> gNodeMemoryPool;
37 return gNodeMemoryPool;
40 // keep track of nodes alive, to ensure we have 0 when the process exits or DALi library is unloaded
41 int32_t gNodeCount = 0;
43 // Called when the process is about to exit, Node count should be zero at this point.
44 void __attribute__((destructor)) ShutDown(void)
46 DALI_ASSERT_DEBUG((gNodeCount == 0) && "Node memory leak");
49 } // Unnamed namespace
57 const ColorMode Node::DEFAULT_COLOR_MODE(USE_OWN_MULTIPLY_PARENT_ALPHA);
59 uint32_t Node::mNodeCounter = 0; ///< A counter to provide unique node ids, up-to 4 billion
63 return new(GetNodeMemoryPool().AllocateRawThreadSafe()) Node;
66 void Node::Delete(Node* node)
68 // check we have a node not a derived node
69 if(!node->mIsLayer && !node->mIsCamera)
71 // Manually call the destructor
74 // Mark the memory it used as free in the memory pool
75 GetNodeMemoryPool().FreeThreadSafe(node);
79 // not in the pool, just delete it.
85 : mTransformManagerData(), // Initialized to use invalid id by default
86 mOrientation(), // Initialized to identity by default
87 mWorldPosition(TRANSFORM_PROPERTY_WORLD_POSITION, Vector3(0.0f, 0.0f, 0.0f)), // Zero initialized by default
88 mWorldScale(TRANSFORM_PROPERTY_WORLD_SCALE, Vector3(1.0f, 1.0f, 1.0f)),
89 mWorldOrientation(), // Initialized to identity by default
94 mWorldColor(Color::WHITE),
95 mUpdateAreaHint(Vector4::ZERO),
96 mClippingSortModifier(0u),
99 mExclusiveRenderTask(nullptr),
104 mDirtyFlags(NodePropertyFlags::ALL),
105 mDrawMode(DrawMode::NORMAL),
106 mColorMode(DEFAULT_COLOR_MODE),
107 mClippingMode(ClippingMode::DISABLED),
111 mPositionUsesAnchorPoint(true),
113 mUpdateAreaChanged(false),
114 mUseTextureUpdateArea(false)
123 if(mTransformManagerData.Id() != INVALID_TRANSFORM_ID)
125 mTransformManagerData.Manager()->RemoveTransform(mTransformManagerData.Id());
133 void Node::OnDestroy()
135 // Animators, Constraints etc. should be disconnected from the child's properties.
136 PropertyOwner::Destroy();
139 uint32_t Node::GetId() const
144 void Node::CreateTransform(SceneGraph::TransformManager* transformManager)
146 // Create a new transform
147 mTransformManagerData.mManager = transformManager;
148 TransformId createdTransformId = transformManager->CreateTransform();
150 // Set whether the position should use the anchor point
151 transformManager->SetPositionUsesAnchorPoint(createdTransformId, mPositionUsesAnchorPoint);
153 // Set TransformId after initialize done.
154 mTransformManagerData.mId = createdTransformId;
157 void Node::SetRoot(bool isRoot)
159 DALI_ASSERT_DEBUG(!isRoot || mParent == NULL); // Root nodes cannot have a parent
164 bool Node::IsAnimationPossible() const
166 return mIsConnectedToSceneGraph;
169 void Node::AddInitializeResetter(ResetterManager& manager) const
171 manager.AddNodeResetter(*this);
174 void Node::ConnectChild(Node* childNode)
176 DALI_ASSERT_ALWAYS(this != childNode);
177 DALI_ASSERT_ALWAYS(IsRoot() || nullptr != mParent); // Parent should be connected first
178 DALI_ASSERT_ALWAYS(!childNode->IsRoot() && nullptr == childNode->GetParent()); // Child should be disconnected
180 childNode->SetParent(*this);
182 // Everything should be reinherited when reconnected to scene-graph
183 childNode->SetAllDirtyFlags();
185 // Add the node to the end of the child list.
186 mChildren.PushBack(childNode);
188 // Inform property observers of new connection
189 childNode->ConnectToSceneGraph();
192 void Node::DisconnectChild(BufferIndex updateBufferIndex, Node& childNode)
194 DALI_ASSERT_ALWAYS(this != &childNode);
195 DALI_ASSERT_ALWAYS(childNode.GetParent() == this);
197 // Find the childNode and remove it
198 Node* found(nullptr);
200 const NodeIter endIter = mChildren.End();
201 for(NodeIter iter = mChildren.Begin(); iter != endIter; ++iter)
203 Node* current = *iter;
204 if(current == &childNode)
207 mChildren.Erase(iter); // order matters here
208 break; // iter is no longer valid
211 DALI_ASSERT_ALWAYS(nullptr != found);
213 found->RecursiveDisconnectFromSceneGraph(updateBufferIndex);
216 void Node::AddRenderer(const RendererKey& renderer)
218 // If it is the first renderer added, make sure the world transform will be calculated
219 // in the next update as world transform is not computed if node has no renderers.
220 if(mRenderers.Empty())
222 mDirtyFlags |= NodePropertyFlags::TRANSFORM;
226 // Check that it has not been already added.
227 for(auto&& existingRenderer : mRenderers)
229 if(existingRenderer == renderer)
231 // Renderer is already in the list.
239 mRenderers.PushBack(renderer);
242 void Node::RemoveRenderer(const RendererKey& renderer)
244 RendererContainer::SizeType rendererCount(mRenderers.Size());
245 for(RendererContainer::SizeType i = 0; i < rendererCount; ++i)
247 if(mRenderers[i] == renderer)
249 renderer->DetachFromNodeDataProvider(*this);
252 mRenderers.Erase(mRenderers.Begin() + i);
258 NodePropertyFlags Node::GetDirtyFlags() const
260 // get initial dirty flags, they are reset ResetDefaultProperties, but setters may have made the node dirty already
261 NodePropertyFlags flags = mDirtyFlags;
263 // Check whether the visible property has changed
264 if(!mVisible.IsClean())
266 flags |= NodePropertyFlags::VISIBLE;
269 // Check whether the color property has changed
270 if(!mColor.IsClean())
272 flags |= NodePropertyFlags::COLOR;
278 NodePropertyFlags Node::GetInheritedDirtyFlags(NodePropertyFlags parentFlags) const
280 // Size is not inherited. VisibleFlag is inherited
281 static const NodePropertyFlags InheritedDirtyFlags = NodePropertyFlags::TRANSFORM | NodePropertyFlags::VISIBLE | NodePropertyFlags::COLOR;
282 using UnderlyingType = typename std::underlying_type<NodePropertyFlags>::type;
284 return static_cast<NodePropertyFlags>(static_cast<UnderlyingType>(mDirtyFlags) |
285 (static_cast<UnderlyingType>(parentFlags) & static_cast<UnderlyingType>(InheritedDirtyFlags)));
288 void Node::ResetDirtyFlags(BufferIndex updateBufferIndex)
290 mDirtyFlags = NodePropertyFlags::NOTHING;
292 mUpdateAreaChanged = false;
295 void Node::SetParent(Node& parentNode)
297 DALI_ASSERT_ALWAYS(this != &parentNode);
298 DALI_ASSERT_ALWAYS(!mIsRoot);
299 DALI_ASSERT_ALWAYS(mParent == nullptr);
301 mParent = &parentNode;
303 if(mTransformManagerData.Id() != INVALID_TRANSFORM_ID)
305 mTransformManagerData.Manager()->SetParent(mTransformManagerData.Id(), parentNode.GetTransformId());
309 void Node::RecursiveDisconnectFromSceneGraph(BufferIndex updateBufferIndex)
311 DALI_ASSERT_ALWAYS(!mIsRoot);
312 DALI_ASSERT_ALWAYS(mParent != nullptr);
314 const NodeIter endIter = mChildren.End();
315 for(NodeIter iter = mChildren.Begin(); iter != endIter; ++iter)
317 (*iter)->RecursiveDisconnectFromSceneGraph(updateBufferIndex);
320 // Animators, Constraints etc. should be disconnected from the child's properties.
321 PropertyOwner::DisconnectFromSceneGraph(updateBufferIndex);
323 // Remove back-pointer to parent
326 // Remove all child pointers
329 if(mTransformManagerData.Id() != INVALID_TRANSFORM_ID)
331 mTransformManagerData.Manager()->SetParent(mTransformManagerData.Id(), INVALID_TRANSFORM_ID);
335 uint32_t Node::GetMemoryPoolCapacity()
337 return GetNodeMemoryPool().GetCapacity();
340 } // namespace SceneGraph
342 } // namespace Internal