2 * Copyright (c) 2024 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/manager/update-manager.h>
22 #include <dali/integration-api/core.h>
24 #include <dali/internal/common/owner-key-container.h>
26 #include <dali/internal/event/animation/animation-playlist.h>
27 #include <dali/internal/event/common/notification-manager.h>
28 #include <dali/internal/event/common/property-notifier.h>
29 #include <dali/internal/event/effects/shader-factory.h>
31 #include <dali/internal/update/common/discard-queue.h>
32 #include <dali/internal/update/controllers/render-message-dispatcher.h>
33 #include <dali/internal/update/controllers/scene-controller-impl.h>
34 #include <dali/internal/update/manager/frame-callback-processor.h>
35 #include <dali/internal/update/manager/render-task-processor.h>
36 #include <dali/internal/update/manager/resetter-container.h>
37 #include <dali/internal/update/manager/transform-manager.h>
38 #include <dali/internal/update/manager/update-algorithms.h>
39 #include <dali/internal/update/manager/update-manager-debug.h>
40 #include <dali/internal/update/nodes/node.h>
41 #include <dali/internal/update/queue/update-message-queue.h>
43 #include <dali/internal/render/common/render-manager.h>
44 #include <dali/internal/render/queue/render-queue.h>
45 #include <dali/internal/render/renderers/render-vertex-buffer.h>
47 // Un-comment to enable node tree debug logging
48 //#define NODE_TREE_LOGGING 1
50 #if(defined(DEBUG_ENABLED) && defined(NODE_TREE_LOGGING))
51 #define SNAPSHOT_NODE_LOGGING \
52 const uint32_t FRAME_COUNT_TRIGGER = 16; \
53 if(mImpl->frameCounter >= FRAME_COUNT_TRIGGER) \
55 for(auto&& scene : mImpl->scenes) \
57 if(scene && scene->root) \
59 mImpl->frameCounter = 0; \
60 PrintNodes(*scene->root, mSceneGraphBuffers.GetUpdateBufferIndex(), 0); \
64 mImpl->frameCounter++;
66 #define SNAPSHOT_NODE_LOGGING
69 #if defined(DEBUG_ENABLED)
70 extern Debug::Filter* gRenderTaskLogFilter;
73 Debug::Filter* gLogFilter = Debug::Filter::New(Debug::NoLogging, false, "LOG_UPDATE_MANAGER");
74 } // unnamed namespace
77 using namespace Dali::Integration;
78 using Dali::Internal::Update::MessageQueue;
89 * Helper to Erase an object from OwnerContainer using discard queue
90 * @param container to remove from
91 * @param object to remove
92 * @param discardQueue to put the object to
93 * @param updateBufferIndex to use
96 inline void EraseUsingDiscardQueue(OwnerContainer<Type*>& container, Type* object, DiscardQueue<Type*, OwnerContainer<Type*>>& discardQueue, BufferIndex updateBufferIndex)
98 DALI_ASSERT_DEBUG(object && "NULL object not allowed");
100 // need to use the reference version of auto as we need the pointer to the pointer for the Release call below
101 for(auto&& iter : container)
105 // Transfer ownership to the discard queue, this keeps the object alive, until the render-thread has finished with it
106 discardQueue.Add(updateBufferIndex, container.Release(&iter)); // take the address of the reference to a pointer (iter)
107 return; // return as we only ever remove one object. Iterators to container are now invalidated as well so cannot continue
113 * Helper to Erase an object from std::vector using discard queue
114 * @param container to remove from
115 * @param object to remove
116 * @param discardQueue to put the object to
117 * @param updateBufferIndex to use
120 inline void EraseUsingDiscardQueue(OwnerKeyContainer<Type>& container, const MemoryPoolKey<Type>& key, DiscardQueue<MemoryPoolKey<Type>, OwnerKeyContainer<Type>>& discardQueue, BufferIndex updateBufferIndex)
122 DALI_ASSERT_DEBUG(key && "INVALID Key not allowed");
124 for(auto iter = container.begin(), end = container.end(); iter != end; ++iter)
128 // Transfer ownership to the discard queue, this keeps the object alive, until the render-thread has finished with it
129 discardQueue.Add(updateBufferIndex, container.Release(iter));
130 return; // return as we only ever remove one object. Iterators to container are now invalidated as well so cannot continue
135 } // unnamed namespace
138 * Structure to contain UpdateManager internal data
140 struct UpdateManager::Impl
142 // SceneInfo keeps the root node of the Scene, its scene graph render task list, and the list of Layer pointers sorted by depth
145 SceneInfo(Layer* root) ///< Constructor
150 ~SceneInfo() = default; ///< Default non-virtual destructor
151 SceneInfo(SceneInfo&& rhs) = default; ///< Move constructor
152 SceneInfo& operator=(SceneInfo&& rhs) = default; ///< Move assignment operator
153 SceneInfo& operator=(const SceneInfo& rhs) = delete; ///< Assignment operator
154 SceneInfo(const SceneInfo& rhs) = delete; ///< Copy constructor
156 Layer* root{nullptr}; ///< Root node (root is a layer). The layer is not stored in the node memory pool.
157 OwnerPointer<RenderTaskList> taskList; ///< Scene graph render task list
158 SortedLayerPointers sortedLayerList; ///< List of Layer pointers sorted by depth (one list of sorted layers per root)
159 OwnerPointer<Scene> scene; ///< Scene graph object of the scene
162 Impl(NotificationManager& notificationManager,
163 CompleteNotificationInterface& animationPlaylist,
164 PropertyNotifier& propertyNotifier,
165 RenderController& renderController,
166 RenderManager& renderManager,
167 RenderQueue& renderQueue,
168 SceneGraphBuffers& sceneGraphBuffers,
169 RenderTaskProcessor& renderTaskProcessor)
170 : renderMessageDispatcher(renderManager, renderQueue, sceneGraphBuffers),
171 notificationManager(notificationManager),
173 animationPlaylist(animationPlaylist),
174 propertyNotifier(propertyNotifier),
175 shaderSaver(nullptr),
176 renderController(renderController),
177 sceneController(nullptr),
178 renderManager(renderManager),
179 renderQueue(renderQueue),
180 renderTaskProcessor(renderTaskProcessor),
181 backgroundColor(Dali::DEFAULT_BACKGROUND_COLOR),
185 panGestureProcessor(nullptr),
186 messageQueue(renderController, sceneGraphBuffers),
187 frameCallbackProcessor(nullptr),
188 nodeDirtyFlags(NodePropertyFlags::TRANSFORM), // set to TransformFlag to ensure full update the first time through Update()
190 renderingBehavior(DevelStage::Rendering::IF_REQUIRED),
191 animationFinishedDuringUpdate(false),
192 previousUpdateScene(false),
193 renderTaskWaiting(false),
194 renderersAdded(false),
195 renderingRequired(false)
197 sceneController = new SceneControllerImpl(renderMessageDispatcher, renderQueue);
199 // create first 'dummy' node
200 nodes.PushBack(nullptr);
205 // Disconnect render tasks from nodes, before destroying the nodes
206 for(auto&& scene : scenes)
208 if(scene && scene->taskList)
210 RenderTaskList::RenderTaskContainer& tasks = scene->taskList->GetTasks();
211 for(auto&& task : tasks)
213 task->SetSourceNode(nullptr);
218 // UpdateManager owns the Nodes. Although Nodes are pool allocated they contain heap allocated parts
219 // like custom properties, which get released here
220 Vector<Node*>::Iterator iter = nodes.Begin() + 1;
221 Vector<Node*>::Iterator endIter = nodes.End();
222 for(; iter != endIter; ++iter)
224 (*iter)->OnDestroy();
229 for(auto&& scene : scenes)
231 if(scene && scene->root)
233 scene->root->OnDestroy();
234 Node::Delete(scene->root);
239 delete sceneController;
241 // Ensure to clear renderers
247 * Lazy init for FrameCallbackProcessor.
248 * @param[in] updateManager A reference to the update-manager
250 FrameCallbackProcessor& GetFrameCallbackProcessor(UpdateManager& updateManager)
252 if(!frameCallbackProcessor)
254 frameCallbackProcessor = new FrameCallbackProcessor(updateManager, transformManager);
256 return *frameCallbackProcessor;
259 SceneGraphBuffers sceneGraphBuffers; ///< Used to keep track of which buffers are being written or read
260 RenderMessageDispatcher renderMessageDispatcher; ///< Used for passing messages to the render-thread
261 NotificationManager& notificationManager; ///< Queues notification messages for the event-thread.
262 TransformManager transformManager; ///< Used to update the transformation matrices of the nodes
263 CompleteNotificationInterface& animationPlaylist; ///< Holds handles to all the animations
264 PropertyNotifier& propertyNotifier; ///< Provides notification to applications when properties are modified.
265 ShaderSaver* shaderSaver; ///< Saves shader binaries.
266 RenderController& renderController; ///< render controller
267 SceneControllerImpl* sceneController; ///< scene controller
268 RenderManager& renderManager; ///< This is responsible for rendering the results of each "update"
269 RenderQueue& renderQueue; ///< Used to queue messages for the next render
270 RenderTaskProcessor& renderTaskProcessor; ///< Handles RenderTasks and RenderInstrucitons
272 Vector4 backgroundColor; ///< The glClear color used at the beginning of each frame.
274 using SceneInfoPtr = std::unique_ptr<SceneInfo>;
275 std::vector<SceneInfoPtr> scenes; ///< A container of SceneInfo.
277 Vector<Node*> nodes; ///< A container of all instantiated nodes
279 std::unordered_map<uint32_t, Node*> nodeIdMap; ///< A container of nodes map by id.
281 Vector<Camera*> cameras; ///< A container of cameras. Note : these cameras are owned by Impl::nodes.
283 OwnerContainer<PropertyOwner*> customObjects; ///< A container of owned objects (with custom properties)
285 ResetterContainer<PropertyResetterBase> propertyResetters; ///< A container of property resetters
286 ResetterContainer<NodeResetter> nodeResetters; ///< A container of node resetters
287 ResetterContainer<RendererResetter> rendererResetters; ///< A container of renderer resetters
289 OwnerContainer<Animation*> animations; ///< A container of owned animations
290 OwnerContainer<PropertyNotification*> propertyNotifications; ///< A container of owner property notifications.
291 OwnerKeyContainer<Renderer> renderers; ///< A container of owned renderers
292 OwnerContainer<TextureSet*> textureSets; ///< A container of owned texture sets
293 OwnerContainer<Shader*> shaders; ///< A container of owned shaders
295 DiscardQueue<Node*, OwnerContainer<Node*>> nodeDiscardQueue; ///< Nodes are added here when disconnected from the scene-graph.
296 DiscardQueue<Shader*, OwnerContainer<Shader*>> shaderDiscardQueue;
297 DiscardQueue<MemoryPoolKey<Renderer>, OwnerKeyContainer<Renderer>> rendererDiscardQueue;
298 DiscardQueue<Scene*, OwnerContainer<Scene*>> sceneDiscardQueue;
300 CompleteNotificationInterface::ParameterList notifyRequiredAnimations; ///< A temperal container of complete notify required animations, like animation finished, stopped, or loop completed.
302 OwnerPointer<PanGesture> panGestureProcessor; ///< Owned pan gesture processor; it lives for the lifecycle of UpdateManager
304 MessageQueue messageQueue; ///< The messages queued from the event-thread
305 std::vector<Internal::ShaderDataPtr> renderCompiledShaders; ///< Shaders compiled on Render thread are inserted here for update thread to pass on to event thread.
306 std::vector<Internal::ShaderDataPtr> updateCompiledShaders; ///< Shaders to be sent from Update to Event
307 Mutex compiledShaderMutex; ///< lock to ensure no corruption on the renderCompiledShaders
309 OwnerPointer<FrameCallbackProcessor> frameCallbackProcessor; ///< Owned FrameCallbackProcessor, only created if required.
311 std::atomic<std::size_t> renderInstructionCapacity{0u};
312 NodePropertyFlags nodeDirtyFlags; ///< cumulative node dirty flags from previous frame
313 uint32_t frameCounter; ///< Frame counter used in debugging to choose which frame to debug and which to ignore.
314 DevelStage::Rendering renderingBehavior; ///< Set via DevelStage::SetRenderingBehavior
316 bool animationFinishedDuringUpdate; ///< Flag whether any animations finished during the Update()
317 bool previousUpdateScene; ///< True if the scene was updated in the previous frame (otherwise it was optimized out)
318 bool renderTaskWaiting; ///< A REFRESH_ONCE render task is waiting to be rendered
319 bool renderersAdded; ///< Flag to keep track when renderers have been added to avoid unnecessary processing
320 bool renderingRequired; ///< True if required to render the current frame
323 Impl(const Impl&); ///< Undefined
324 Impl& operator=(const Impl&); ///< Undefined
327 UpdateManager::UpdateManager(NotificationManager& notificationManager,
328 CompleteNotificationInterface& animationFinishedNotifier,
329 PropertyNotifier& propertyNotifier,
330 RenderController& controller,
331 RenderManager& renderManager,
332 RenderQueue& renderQueue,
333 RenderTaskProcessor& renderTaskProcessor)
336 mImpl = new Impl(notificationManager,
337 animationFinishedNotifier,
343 renderTaskProcessor);
346 UpdateManager::~UpdateManager()
351 void UpdateManager::InstallRoot(OwnerPointer<Layer>& layer)
353 DALI_ASSERT_DEBUG(layer->IsLayer());
354 DALI_ASSERT_DEBUG(layer->GetParent() == NULL);
356 Layer* rootLayer = layer.Release();
358 DALI_ASSERT_DEBUG(std::find_if(mImpl->scenes.begin(), mImpl->scenes.end(), [rootLayer](Impl::SceneInfoPtr& scene) { return scene && scene->root == rootLayer; }) == mImpl->scenes.end() &&
359 "Root Node already installed");
361 rootLayer->CreateTransform(&mImpl->transformManager);
362 rootLayer->SetRoot(true);
364 rootLayer->AddInitializeResetter(*this);
366 // Do not allow to insert duplicated nodes.
367 // It could be happened if node id is overflowed.
368 DALI_ASSERT_ALWAYS(mImpl->nodeIdMap.insert({rootLayer->GetId(), rootLayer}).second);
370 mImpl->scenes.emplace_back(new Impl::SceneInfo(rootLayer));
373 void UpdateManager::UninstallRoot(Layer* layer)
375 DALI_ASSERT_DEBUG(layer->IsLayer());
376 DALI_ASSERT_DEBUG(layer->GetParent() == NULL);
378 for(auto iter = mImpl->scenes.begin(); iter != mImpl->scenes.end(); ++iter)
380 if((*iter) && (*iter)->root == layer)
382 mImpl->scenes.erase(iter);
387 mImpl->nodeIdMap.erase(layer->GetId());
389 mImpl->nodeDiscardQueue.Add(mSceneGraphBuffers.GetUpdateBufferIndex(), layer);
391 // Notify the layer about impending destruction
395 void UpdateManager::AddNode(OwnerPointer<Node>& node)
397 DALI_ASSERT_ALWAYS(nullptr == node->GetParent()); // Should not have a parent yet
399 Node* rawNode = node.Release();
400 DALI_LOG_INFO(gLogFilter, Debug::General, "[%x] AddNode\n", rawNode);
402 // Add camera nodes occured rarely.
403 if(DALI_UNLIKELY(rawNode->IsCamera()))
405 AddCamera(static_cast<Camera*>(rawNode));
408 // Do not allow to insert duplicated nodes.
409 // It could be happened if node id is overflowed.
410 DALI_ASSERT_ALWAYS(mImpl->nodeIdMap.insert({rawNode->GetId(), rawNode}).second);
412 mImpl->nodes.PushBack(rawNode);
414 rawNode->CreateTransform(&mImpl->transformManager);
417 void UpdateManager::ConnectNode(Node* parent, Node* node)
419 DALI_ASSERT_ALWAYS(nullptr != parent);
420 DALI_ASSERT_ALWAYS(nullptr != node);
421 DALI_ASSERT_ALWAYS(nullptr == node->GetParent()); // Should not have a parent yet
423 DALI_LOG_INFO(gLogFilter, Debug::General, "[%x] ConnectNode\n", node);
425 parent->SetDirtyFlag(NodePropertyFlags::DESCENDENT_HIERARCHY_CHANGED); // make parent dirty so that render items dont get reused
426 parent->ConnectChild(node);
428 node->AddInitializeResetter(*this);
430 // Inform the frame-callback-processor, if set, about the node-hierarchy changing
431 if(mImpl->frameCallbackProcessor)
433 mImpl->frameCallbackProcessor->NodeHierarchyChanged();
437 void UpdateManager::DisconnectNode(Node* node)
439 DALI_LOG_INFO(gLogFilter, Debug::General, "[%x] DisconnectNode\n", node);
441 Node* parent = node->GetParent();
442 DALI_ASSERT_ALWAYS(nullptr != parent);
443 parent->SetDirtyFlag(NodePropertyFlags::CHILD_DELETED | NodePropertyFlags::DESCENDENT_HIERARCHY_CHANGED); // make parent dirty so that render items dont get reused
445 parent->DisconnectChild(mSceneGraphBuffers.GetUpdateBufferIndex(), *node);
447 // Inform the frame-callback-processor, if set, about the node-hierarchy changing
448 if(mImpl->frameCallbackProcessor)
450 mImpl->frameCallbackProcessor->NodeHierarchyChanged();
454 void UpdateManager::DestroyNode(Node* node)
456 DALI_ASSERT_ALWAYS(nullptr != node);
457 DALI_ASSERT_ALWAYS(nullptr == node->GetParent()); // Should have been disconnected
459 DALI_LOG_INFO(gLogFilter, Debug::General, "[%x] DestroyNode\n", node);
461 Vector<Node*>::Iterator iter = mImpl->nodes.Begin() + 1;
462 Vector<Node*>::Iterator endIter = mImpl->nodes.End();
463 for(; iter != endIter; ++iter)
467 mImpl->nodes.Erase(iter);
472 // Remove camera nodes occured rarely.
473 if(DALI_UNLIKELY(node->IsCamera()))
475 RemoveCamera(static_cast<Camera*>(node));
478 mImpl->nodeIdMap.erase(node->GetId());
480 mImpl->nodeDiscardQueue.Add(mSceneGraphBuffers.GetUpdateBufferIndex(), node);
482 // Notify the Node about impending destruction
486 void UpdateManager::AddCamera(Camera* camera)
488 DALI_LOG_INFO(gLogFilter, Debug::General, "[%x] AddCamera\n", camera);
490 mImpl->cameras.PushBack(camera);
493 void UpdateManager::RemoveCamera(Camera* camera)
495 DALI_LOG_INFO(gLogFilter, Debug::General, "[%x] RemoveCamera\n", camera);
497 // Find the camera and remove it from list of cameras
498 Vector<Camera*>::Iterator iter = mImpl->cameras.Begin();
499 Vector<Camera*>::Iterator endIter = mImpl->cameras.End();
500 for(; iter != endIter; ++iter)
502 if((*iter) == camera)
504 mImpl->cameras.Erase(iter);
510 void UpdateManager::AddObject(OwnerPointer<PropertyOwner>& object)
512 mImpl->customObjects.PushBack(object.Release());
515 void UpdateManager::RemoveObject(PropertyOwner* object)
517 mImpl->customObjects.EraseObject(object);
520 void UpdateManager::AddRenderTaskList(OwnerPointer<RenderTaskList>& taskList)
522 RenderTaskList* taskListPointer = taskList.Release();
523 taskListPointer->Initialize(*this, mImpl->renderMessageDispatcher);
525 mImpl->scenes.back()->taskList = taskListPointer;
528 void UpdateManager::RemoveRenderTaskList(RenderTaskList* taskList)
530 for(auto&& scene : mImpl->scenes)
532 if(scene && scene->taskList == taskList)
534 scene->taskList.Reset();
540 void UpdateManager::AddScene(OwnerPointer<Scene>& scene)
542 auto& sceneInfo = mImpl->scenes.back();
543 sceneInfo->scene = scene.Release();
545 // Set root to the Scene
546 sceneInfo->scene->SetRoot(sceneInfo->root);
548 // Initialize the context from render manager
549 typedef MessageValue1<RenderManager, SceneGraph::Scene*> DerivedType;
551 // Reserve some memory inside the render queue
552 uint32_t* slot = mImpl->renderQueue.ReserveMessageSlot(mSceneGraphBuffers.GetUpdateBufferIndex(), sizeof(DerivedType));
554 // Construct message in the render queue memory; note that delete should not be called on the return value
555 SceneGraph::Scene& sceneObject = *sceneInfo->scene;
556 new(slot) DerivedType(&mImpl->renderManager, &RenderManager::InitializeScene, &sceneObject);
559 void UpdateManager::RemoveScene(Scene* scene)
561 // Initialize the context from render manager
562 using DerivedType = MessageValue1<RenderManager, SceneGraph::Scene*>;
564 // Reserve some memory inside the render queue
565 uint32_t* slot = mImpl->renderQueue.ReserveMessageSlot(mSceneGraphBuffers.GetUpdateBufferIndex(), sizeof(DerivedType));
567 // Construct message in the render queue memory; note that delete should not be called on the return value
568 new(slot) DerivedType(&mImpl->renderManager, &RenderManager::UninitializeScene, scene);
570 scene->RemoveSurfaceRenderTarget();
572 for(auto&& sceneInfo : mImpl->scenes)
574 if(sceneInfo && sceneInfo->scene && sceneInfo->scene.Get() == scene)
576 mImpl->sceneDiscardQueue.Add(mSceneGraphBuffers.GetUpdateBufferIndex(), sceneInfo->scene.Release()); // take the address of the reference to a pointer
582 void UpdateManager::AddAnimation(OwnerPointer<SceneGraph::Animation>& animation)
584 mImpl->animations.PushBack(animation.Release());
587 void UpdateManager::StopAnimation(Animation* animation)
589 DALI_ASSERT_DEBUG(animation && "NULL animation called to stop");
591 bool animationFinished = animation->Stop(mSceneGraphBuffers.GetUpdateBufferIndex());
593 // Queue this animation into notify required animations. Since we need to send Finished signal
594 mImpl->notifyRequiredAnimations.PushBack(animation->GetNotifyId());
596 mImpl->animationFinishedDuringUpdate = mImpl->animationFinishedDuringUpdate || animationFinished;
599 void UpdateManager::ClearAnimation(Animation* animation)
601 DALI_ASSERT_DEBUG(animation && "NULL animation called to clear");
603 animation->Clear(mSceneGraphBuffers.GetUpdateBufferIndex());
605 // We should remove all notify lists what we requests before clear.
606 // TODO : Could we do this more faster?
607 Dali::EraseIf(mImpl->notifyRequiredAnimations, [&animation](const NotifierInterface::NotifyId& key) { return key == animation->GetNotifyId(); });
610 void UpdateManager::RemoveAnimation(Animation* animation)
612 DALI_ASSERT_DEBUG(animation && "NULL animation called to remove");
614 animation->OnDestroy(mSceneGraphBuffers.GetUpdateBufferIndex());
616 DALI_ASSERT_DEBUG(animation->GetState() == Animation::Destroyed);
618 // Do not remove from container now. Destroyed animation will be removed at Animate.
621 bool UpdateManager::IsAnimationRunning() const
623 // Find any animation that isn't stopped or paused
624 for(auto&& iter : mImpl->animations)
626 const Animation::State state = iter->GetState();
628 if(state != Animation::Stopped &&
629 state != Animation::Paused)
631 return true; // stop iteration as soon as first one is found
638 void UpdateManager::AddPropertyResetter(OwnerPointer<PropertyResetterBase>& propertyResetter)
640 propertyResetter->Initialize();
641 mImpl->propertyResetters.PushBack(propertyResetter.Release());
644 void UpdateManager::AddNodeResetter(const Node& node)
646 OwnerPointer<SceneGraph::NodeResetter> nodeResetter = SceneGraph::NodeResetter::New(node);
647 nodeResetter->Initialize();
648 mImpl->nodeResetters.PushBack(nodeResetter.Release());
651 void UpdateManager::AddRendererResetter(const Renderer& renderer)
653 OwnerPointer<SceneGraph::RendererResetter> rendererResetter = SceneGraph::RendererResetter::New(renderer);
654 rendererResetter->Initialize();
655 mImpl->rendererResetters.PushBack(rendererResetter.Release());
658 void UpdateManager::AddPropertyNotification(OwnerPointer<PropertyNotification>& propertyNotification)
660 mImpl->propertyNotifications.PushBack(propertyNotification.Release());
663 void UpdateManager::RemovePropertyNotification(PropertyNotification* propertyNotification)
665 auto iter = std::find(mImpl->propertyNotifications.Begin(), mImpl->propertyNotifications.End(), propertyNotification);
666 if(iter != mImpl->propertyNotifications.End())
668 mImpl->propertyNotifications.Erase(iter);
672 void UpdateManager::PropertyNotificationSetNotify(PropertyNotification* propertyNotification, PropertyNotification::NotifyMode notifyMode)
674 DALI_ASSERT_DEBUG(propertyNotification && "propertyNotification scene graph object missing");
675 propertyNotification->SetNotifyMode(notifyMode);
678 void UpdateManager::AddShader(OwnerPointer<Shader>& shader)
680 mImpl->shaders.PushBack(shader.Release());
683 void UpdateManager::RemoveShader(Shader* shader)
685 // Find the shader and destroy it
686 EraseUsingDiscardQueue(mImpl->shaders, shader, mImpl->shaderDiscardQueue, mSceneGraphBuffers.GetUpdateBufferIndex());
689 void UpdateManager::SaveBinary(Internal::ShaderDataPtr shaderData)
691 DALI_ASSERT_DEBUG(shaderData && "No NULL shader data pointers please.");
692 DALI_ASSERT_DEBUG(shaderData->GetBufferSize() > 0 && "Shader binary empty so nothing to save.");
694 // lock as update might be sending previously compiled shaders to event thread
695 Mutex::ScopedLock lock(mImpl->compiledShaderMutex);
696 mImpl->renderCompiledShaders.push_back(shaderData);
700 void UpdateManager::SetShaderSaver(ShaderSaver& upstream)
702 mImpl->shaderSaver = &upstream;
705 void UpdateManager::AddRenderer(const RendererKey& rendererKey)
707 SceneGraph::Renderer* renderer = rendererKey.Get();
709 DALI_LOG_INFO(gLogFilter, Debug::General, "[%x] AddRenderer\n", renderer);
711 renderer->ConnectToSceneGraph(*mImpl->sceneController, mSceneGraphBuffers.GetUpdateBufferIndex());
712 renderer->AddInitializeResetter(*this);
714 mImpl->renderers.PushBack(rendererKey);
717 void UpdateManager::RemoveRenderer(const RendererKey& rendererKey)
719 DALI_LOG_INFO(gLogFilter, Debug::General, "[%x] RemoveRenderer\n", rendererKey.Get());
721 // Find the renderer and destroy it
722 EraseUsingDiscardQueue(mImpl->renderers, rendererKey, mImpl->rendererDiscardQueue, mSceneGraphBuffers.GetUpdateBufferIndex());
723 // Need to remove the render object as well
724 rendererKey->DisconnectFromSceneGraph(*mImpl->sceneController, mSceneGraphBuffers.GetUpdateBufferIndex());
727 void UpdateManager::AttachRenderer(Node* node, Renderer* renderer)
729 node->AddRenderer(Renderer::GetKey(renderer));
730 mImpl->renderersAdded = true;
733 void UpdateManager::SetPanGestureProcessor(PanGesture* panGestureProcessor)
735 DALI_ASSERT_DEBUG(NULL != panGestureProcessor);
737 mImpl->panGestureProcessor = panGestureProcessor;
740 void UpdateManager::AddTextureSet(OwnerPointer<TextureSet>& textureSet)
742 textureSet->SetRenderMessageDispatcher(&mImpl->renderMessageDispatcher);
743 mImpl->textureSets.PushBack(textureSet.Release());
746 void UpdateManager::RemoveTextureSet(TextureSet* textureSet)
748 mImpl->textureSets.EraseObject(textureSet);
751 uint32_t* UpdateManager::ReserveMessageSlot(uint32_t size, bool updateScene)
753 return mImpl->messageQueue.ReserveMessageSlot(size, updateScene);
756 std::size_t UpdateManager::GetUpdateMessageQueueCapacity() const
758 return mImpl->messageQueue.GetCapacity();
761 std::size_t UpdateManager::GetRenderMessageQueueCapacity() const
763 return mImpl->renderQueue.GetCapacity();
766 std::size_t UpdateManager::GetRenderInstructionCapacity() const
768 return mImpl->renderInstructionCapacity;
771 void UpdateManager::EventProcessingStarted()
773 mImpl->messageQueue.EventProcessingStarted();
776 void UpdateManager::EventProcessingFinished()
778 mImpl->messageQueue.EventProcessingFinished();
781 bool UpdateManager::FlushQueue()
783 return mImpl->messageQueue.FlushQueue();
786 void UpdateManager::ResetProperties(BufferIndex bufferIndex)
788 // Clear the "animations finished" flag; This should be set if any (previously playing) animation is stopped
789 mImpl->animationFinishedDuringUpdate = false;
791 // Reset node properties
792 mImpl->nodeResetters.ResetToBaseValues(bufferIndex);
794 // Reset renderer properties
795 mImpl->rendererResetters.ResetToBaseValues(bufferIndex);
797 // Reset all animating / constrained properties
798 mImpl->propertyResetters.ResetToBaseValues(bufferIndex);
800 // Clear all root nodes dirty flags
801 for(auto& scene : mImpl->scenes)
803 auto root = scene->root;
804 root->ResetDirtyFlags(bufferIndex);
807 // Clear node dirty flags
808 Vector<Node*>::Iterator iter = mImpl->nodes.Begin() + 1;
809 Vector<Node*>::Iterator endIter = mImpl->nodes.End();
810 for(; iter != endIter; ++iter)
812 (*iter)->ResetDirtyFlags(bufferIndex);
816 bool UpdateManager::ProcessGestures(BufferIndex bufferIndex, uint32_t lastVSyncTimeMilliseconds, uint32_t nextVSyncTimeMilliseconds)
818 bool gestureUpdated(false);
820 if(mImpl->panGestureProcessor)
822 // gesture processor only supports default properties
823 mImpl->panGestureProcessor->ResetDefaultProperties(bufferIndex); // Needs to be done every time as gesture data is written directly to an update-buffer rather than via a message
824 gestureUpdated |= mImpl->panGestureProcessor->UpdateProperties(lastVSyncTimeMilliseconds, nextVSyncTimeMilliseconds);
827 return gestureUpdated;
830 bool UpdateManager::Animate(BufferIndex bufferIndex, float elapsedSeconds)
832 bool animationActive = false;
833 bool animationLooped = false;
835 auto&& iter = mImpl->animations.Begin();
837 while(iter != mImpl->animations.End())
839 Animation* animation = *iter;
840 bool finished = false;
842 bool progressMarkerReached = false;
843 animation->Update(bufferIndex, elapsedSeconds, looped, finished, progressMarkerReached);
845 animationActive = animationActive || animation->IsActive();
847 if(progressMarkerReached)
849 mImpl->notificationManager.QueueMessage(Internal::NotifyProgressReachedMessage(mImpl->animationPlaylist, animation->GetNotifyId()));
852 mImpl->animationFinishedDuringUpdate = mImpl->animationFinishedDuringUpdate || finished;
853 animationLooped = animationLooped || looped;
855 // queue the notification on finished or stoped
858 mImpl->notifyRequiredAnimations.PushBack(animation->GetNotifyId());
861 // Remove animations that had been destroyed but were still waiting for an update
862 if(animation->GetState() == Animation::Destroyed)
864 iter = mImpl->animations.Erase(iter);
872 // The application should be notified by NotificationManager, in another thread
873 if(!mImpl->notifyRequiredAnimations.Empty())
875 mImpl->notificationManager.QueueNotification(&mImpl->animationPlaylist, std::move(mImpl->notifyRequiredAnimations));
878 return animationActive;
881 void UpdateManager::ConstrainCustomObjects(PropertyOwnerContainer& postPropertyOwners, BufferIndex bufferIndex)
883 // Constrain custom objects (in construction order)
884 for(auto&& object : mImpl->customObjects)
886 ConstrainPropertyOwner(*object, bufferIndex);
887 if(!object->GetPostConstraints().Empty())
889 postPropertyOwners.PushBack(object);
894 void UpdateManager::ConstrainRenderTasks(PropertyOwnerContainer& postPropertyOwners, BufferIndex bufferIndex)
896 // Constrain render-tasks
897 for(auto&& scene : mImpl->scenes)
899 if(scene && scene->taskList)
901 RenderTaskList::RenderTaskContainer& tasks = scene->taskList->GetTasks();
902 for(auto&& task : tasks)
904 ConstrainPropertyOwner(*task, bufferIndex);
905 if(!task->GetPostConstraints().Empty())
907 postPropertyOwners.PushBack(task);
914 void UpdateManager::ConstrainShaders(PropertyOwnerContainer& postPropertyOwners, BufferIndex bufferIndex)
916 // constrain shaders... (in construction order)
917 for(auto&& shader : mImpl->shaders)
919 ConstrainPropertyOwner(*shader, bufferIndex);
920 if(!shader->GetPostConstraints().Empty())
922 postPropertyOwners.PushBack(shader);
927 void UpdateManager::ProcessPropertyNotifications(BufferIndex bufferIndex)
929 for(auto&& notification : mImpl->propertyNotifications)
931 bool valid = notification->Check(bufferIndex);
934 mImpl->notificationManager.QueueMessage(PropertyChangedMessage(mImpl->propertyNotifier, notification->GetNotifyId(), notification->GetValidity()));
939 void UpdateManager::ForwardCompiledShadersToEventThread()
941 DALI_ASSERT_DEBUG((mImpl->shaderSaver != 0) && "shaderSaver should be wired-up during startup.");
942 if(mImpl->shaderSaver)
944 // lock and swap the queues
946 // render might be attempting to send us more binaries at the same time
947 Mutex::ScopedLock lock(mImpl->compiledShaderMutex);
948 mImpl->renderCompiledShaders.swap(mImpl->updateCompiledShaders);
951 if(mImpl->updateCompiledShaders.size() > 0)
953 ShaderSaver& factory = *mImpl->shaderSaver;
954 for(auto&& shader : mImpl->updateCompiledShaders)
956 mImpl->notificationManager.QueueMessage(ShaderCompiledMessage(factory, shader));
958 // we don't need them in update anymore
959 mImpl->updateCompiledShaders.clear();
964 void UpdateManager::UpdateRenderers(PropertyOwnerContainer& postPropertyOwners, BufferIndex bufferIndex)
966 for(const auto& rendererKey : mImpl->renderers)
969 auto renderer = rendererKey.Get();
970 ConstrainPropertyOwner(*renderer, bufferIndex);
971 if(!renderer->GetPostConstraints().Empty())
973 postPropertyOwners.PushBack(renderer);
976 mImpl->renderingRequired = renderer->PrepareRender(bufferIndex) || mImpl->renderingRequired;
980 void UpdateManager::UpdateNodes(PropertyOwnerContainer& postPropertyOwners, BufferIndex bufferIndex)
982 mImpl->nodeDirtyFlags = NodePropertyFlags::NOTHING;
984 for(auto&& scene : mImpl->scenes)
986 if(scene && scene->root)
988 // Prepare resources, update shaders, for each node
989 // And add the renderers to the sorted layers. Start from root, which is also a layer
990 mImpl->nodeDirtyFlags |= UpdateNodeTree(*scene->root,
998 void UpdateManager::UpdateLayers(BufferIndex bufferIndex)
1000 for(auto&& scene : mImpl->scenes)
1002 if(scene && scene->root)
1004 SceneGraph::UpdateLayerTree(*scene->root, bufferIndex);
1009 uint32_t UpdateManager::Update(float elapsedSeconds,
1010 uint32_t lastVSyncTimeMilliseconds,
1011 uint32_t nextVSyncTimeMilliseconds,
1012 bool renderToFboEnabled,
1013 bool isRenderingToFbo,
1016 const BufferIndex bufferIndex = mSceneGraphBuffers.GetUpdateBufferIndex();
1018 // Clear nodes/resources which were previously discarded
1019 mImpl->nodeDiscardQueue.Clear(bufferIndex);
1020 mImpl->shaderDiscardQueue.Clear(bufferIndex);
1021 mImpl->rendererDiscardQueue.Clear(bufferIndex);
1022 mImpl->sceneDiscardQueue.Clear(bufferIndex);
1024 bool isAnimationRunning = IsAnimationRunning();
1026 // Process Touches & Gestures
1027 const bool gestureUpdated = ProcessGestures(bufferIndex, lastVSyncTimeMilliseconds, nextVSyncTimeMilliseconds);
1029 bool updateScene = // The scene-graph requires an update if..
1030 (mImpl->nodeDirtyFlags & RenderableUpdateFlags) || // ..nodes were dirty in previous frame OR
1031 isAnimationRunning || // ..at least one animation is running OR
1032 mImpl->messageQueue.IsSceneUpdateRequired() || // ..a message that modifies the scene graph node tree is queued OR
1033 mImpl->frameCallbackProcessor || // ..a frame callback processor is existed OR
1034 gestureUpdated; // ..a gesture property was updated
1036 uint32_t keepUpdating = 0;
1037 bool keepRendererRendering = false;
1038 mImpl->renderingRequired = false;
1040 // Although the scene-graph may not require an update, we still need to synchronize double-buffered
1041 // values if the scene was updated in the previous frame.
1042 if(updateScene || mImpl->previousUpdateScene)
1044 // Reset properties from the previous update
1045 ResetProperties(bufferIndex);
1046 mImpl->transformManager.ResetToBaseValue();
1049 // Process the queued scene messages. Note, MessageQueue::FlushQueue may be called
1050 // between calling IsSceneUpdateRequired() above and here, so updateScene should
1052 updateScene |= mImpl->messageQueue.ProcessMessages(bufferIndex);
1054 // Forward compiled shader programs to event thread for saving
1055 ForwardCompiledShadersToEventThread();
1057 // Although the scene-graph may not require an update, we still need to synchronize double-buffered
1058 // renderer lists if the scene was updated in the previous frame.
1059 // We should not start skipping update steps or reusing lists until there has been two frames where nothing changes
1060 if(updateScene || mImpl->previousUpdateScene)
1063 bool animationActive = Animate(bufferIndex, elapsedSeconds);
1065 PropertyOwnerContainer postPropertyOwners;
1066 // Constraint custom objects
1067 ConstrainCustomObjects(postPropertyOwners, bufferIndex);
1069 // Clear the lists of renderers from the previous update
1070 for(auto&& scene : mImpl->scenes)
1074 for(auto&& layer : scene->sortedLayerList)
1078 layer->ClearRenderables();
1084 // Call the frame-callback-processor if set
1085 if(mImpl->frameCallbackProcessor)
1087 keepRendererRendering |= mImpl->frameCallbackProcessor->Update(bufferIndex, elapsedSeconds);
1090 // Update node hierarchy, apply constraints,
1091 UpdateNodes(postPropertyOwners, bufferIndex);
1093 // Apply constraints to RenderTasks, shaders
1094 ConstrainRenderTasks(postPropertyOwners, bufferIndex);
1095 ConstrainShaders(postPropertyOwners, bufferIndex);
1097 // Update renderers and apply constraints
1098 UpdateRenderers(postPropertyOwners, bufferIndex);
1100 // Update the transformations of all the nodes
1101 if(mImpl->transformManager.Update())
1103 mImpl->nodeDirtyFlags |= NodePropertyFlags::TRANSFORM;
1106 // Constraint applied after transform manager updated. Only required property owner processed.
1107 for(auto&& propertyOwner : postPropertyOwners)
1109 ConstrainPropertyOwner(*propertyOwner, bufferIndex, false);
1112 // Initialise layer renderable reuse
1113 UpdateLayers(bufferIndex);
1115 // Process Property Notifications
1116 ProcessPropertyNotifications(bufferIndex);
1119 for(auto&& cameraIterator : mImpl->cameras)
1121 cameraIterator->Update(bufferIndex);
1124 // Process the RenderTasks if renderers exist. This creates the instructions for rendering the next frame.
1125 // reset the update buffer index and make sure there is enough room in the instruction container
1126 if(mImpl->renderersAdded)
1128 // Calculate how many render tasks we have in total
1129 std::size_t numberOfRenderTasks = 0;
1130 for(auto&& scene : mImpl->scenes)
1132 if(scene && scene->taskList)
1134 numberOfRenderTasks += scene->taskList->GetTasks().Count();
1138 std::size_t numberOfRenderInstructions = 0;
1139 mImpl->renderInstructionCapacity = 0u;
1140 for(auto&& scene : mImpl->scenes)
1142 if(scene && scene->root && scene->taskList && scene->scene)
1144 scene->scene->GetRenderInstructions().ResetAndReserve(bufferIndex,
1145 static_cast<uint32_t>(scene->taskList->GetTasks().Count()));
1147 bool sceneKeepUpdating = scene->scene->KeepRenderingCheck(elapsedSeconds);
1148 if(sceneKeepUpdating)
1150 keepUpdating |= KeepUpdating::STAGE_KEEP_RENDERING;
1153 // If there are animations running, only add render instruction if at least one animation is currently active (i.e. not delayed)
1154 // or the nodes are dirty
1155 // or keep rendering is requested
1156 if(!isAnimationRunning || animationActive || mImpl->renderingRequired || (mImpl->nodeDirtyFlags & RenderableUpdateFlags) || sceneKeepUpdating)
1158 keepRendererRendering |= mImpl->renderTaskProcessor.Process(bufferIndex,
1161 scene->sortedLayerList,
1162 scene->scene->GetRenderInstructions(),
1166 mImpl->renderInstructionCapacity += scene->scene->GetRenderInstructions().GetCapacity();
1167 scene->scene->SetSkipRendering(false);
1173 DALI_LOG_RELEASE_INFO("Scene skip rendering set as true, during 'uploadOnly' was true.\n");
1175 scene->scene->SetSkipRendering(true);
1178 numberOfRenderInstructions += scene->scene->GetRenderInstructions().Count(bufferIndex);
1182 DALI_LOG_INFO(gLogFilter, Debug::General, "Update: numberOfRenderTasks(%d), Render Instructions(%d)\n", numberOfRenderTasks, numberOfRenderInstructions);
1188 // check the countdown and notify
1189 mImpl->renderTaskWaiting = false;
1191 for(auto&& scene : mImpl->scenes)
1193 if(scene && scene->root && scene->taskList)
1195 RenderTaskList::RenderTaskContainer& tasks = scene->taskList->GetTasks();
1197 CompleteNotificationInterface::ParameterList notifyRequiredRenderTasks;
1199 for(auto&& renderTask : tasks)
1201 renderTask->UpdateState();
1203 if(renderTask->IsWaitingToRender() &&
1204 renderTask->ReadyToRender(bufferIndex) /*avoid updating forever when source actor is off-stage*/)
1206 mImpl->renderTaskWaiting = true; // keep update/render threads alive
1209 if(renderTask->HasRendered())
1211 notifyRequiredRenderTasks.PushBack(renderTask->GetNotifyId());
1215 if(!notifyRequiredRenderTasks.Empty())
1217 DALI_LOG_INFO(gRenderTaskLogFilter, Debug::General, "Notify a render task has finished\n");
1218 mImpl->notificationManager.QueueNotification(scene->taskList->GetCompleteNotificationInterface(), std::move(notifyRequiredRenderTasks));
1224 // Macro is undefined in release build.
1225 SNAPSHOT_NODE_LOGGING;
1227 // A ResetProperties() may be required in the next frame
1228 mImpl->previousUpdateScene = updateScene;
1230 // Check whether further updates are required
1231 keepUpdating |= KeepUpdatingCheck(elapsedSeconds);
1233 if(keepRendererRendering)
1235 keepUpdating |= KeepUpdating::STAGE_KEEP_RENDERING;
1238 if(keepUpdating & KeepUpdating::STAGE_KEEP_RENDERING)
1240 // Set dirty flags for next frame to continue rendering
1241 mImpl->nodeDirtyFlags |= RenderableUpdateFlags;
1244 // tell the update manager that we're done so the queue can be given to event thread
1245 mImpl->notificationManager.UpdateCompleted();
1247 // The update has finished; swap the double-buffering indices
1248 mSceneGraphBuffers.Swap();
1250 return keepUpdating;
1253 void UpdateManager::PostRender()
1256 for(auto&& renderer : mImpl->renderers)
1258 renderer->SetUpdated(false);
1261 for(auto&& shader : mImpl->shaders)
1263 shader->SetUpdated(false);
1266 for(auto&& scene : mImpl->scenes)
1268 scene->root->SetUpdatedTree(false);
1272 uint32_t UpdateManager::KeepUpdatingCheck(float elapsedSeconds) const
1274 uint32_t keepUpdatingRequest = KeepUpdating::NOT_REQUESTED;
1276 // If the rendering behavior is set to continuously render, then continue to render.
1277 // Keep updating until no messages are received and no animations are running.
1278 // If an animation has just finished, update at least once more for Discard end-actions.
1279 // No need to check for renderQueue as there is always a render after update and if that
1280 // render needs another update it will tell the adaptor to call update again
1282 if(mImpl->renderingBehavior == DevelStage::Rendering::CONTINUOUSLY)
1284 keepUpdatingRequest |= KeepUpdating::STAGE_KEEP_RENDERING;
1287 if(IsAnimationRunning() ||
1288 mImpl->animationFinishedDuringUpdate)
1290 keepUpdatingRequest |= KeepUpdating::ANIMATIONS_RUNNING;
1293 if(mImpl->renderTaskWaiting)
1295 keepUpdatingRequest |= KeepUpdating::RENDER_TASK_SYNC;
1298 return keepUpdatingRequest;
1301 void UpdateManager::SurfaceReplaced(Scene* scene)
1303 using DerivedType = MessageValue1<RenderManager, Scene*>;
1305 // Reserve some memory inside the render queue
1306 uint32_t* slot = mImpl->renderQueue.ReserveMessageSlot(mSceneGraphBuffers.GetUpdateBufferIndex(), sizeof(DerivedType));
1308 // Construct message in the render queue memory; note that delete should not be called on the return value
1309 new(slot) DerivedType(&mImpl->renderManager, &RenderManager::SurfaceReplaced, scene);
1312 void UpdateManager::KeepRendering(float durationSeconds)
1314 for(auto&& scene : mImpl->scenes)
1318 scene->scene->KeepRendering(durationSeconds);
1323 void UpdateManager::SetRenderingBehavior(DevelStage::Rendering renderingBehavior)
1325 mImpl->renderingBehavior = renderingBehavior;
1328 void UpdateManager::RequestRendering()
1330 mImpl->renderingRequired = true;
1333 Node* UpdateManager::GetNodePointerById(uint32_t nodeId) const
1335 Node* foundNodePointer = nullptr;
1336 auto iter = mImpl->nodeIdMap.find(nodeId);
1337 if(iter != mImpl->nodeIdMap.end())
1339 foundNodePointer = iter->second;
1341 return foundNodePointer;
1344 void UpdateManager::SetLayerDepths(const SortedLayerPointers& layers, const Layer* rootLayer)
1346 for(auto&& scene : mImpl->scenes)
1348 if(scene && scene->root == rootLayer)
1350 scene->sortedLayerList = layers;
1356 void UpdateManager::SetDepthIndices(OwnerPointer<NodeDepths>& nodeDepths)
1358 // note, this vector is already in depth order.
1359 // So if we reverse iterate, we can assume that
1360 // my descendant node's depth index are updated.
1362 // And also, This API is the last flushed message.
1363 // We can now setup the DESCENDENT_HIERARCHY_CHANGED flag here.
1364 for(auto rIter = nodeDepths->nodeDepths.rbegin(), rEndIter = nodeDepths->nodeDepths.rend(); rIter != rEndIter; rIter++)
1366 auto* node = rIter->node;
1367 node->PropagateDescendentFlags();
1368 node->SetDepthIndex(rIter->sortedDepth);
1369 if(node->IsChildrenReorderRequired())
1371 // Reorder children container only if sibiling order changed.
1372 NodeContainer& container = node->GetChildren();
1373 std::sort(container.Begin(), container.End(), [](Node* a, Node* b) { return a->GetDepthIndex() < b->GetDepthIndex(); });
1378 void UpdateManager::AddFrameCallback(OwnerPointer<FrameCallback>& frameCallback, const Node* rootNode)
1380 mImpl->GetFrameCallbackProcessor(*this).AddFrameCallback(frameCallback, rootNode);
1383 void UpdateManager::RemoveFrameCallback(FrameCallbackInterface* frameCallback)
1385 mImpl->GetFrameCallbackProcessor(*this).RemoveFrameCallback(frameCallback);
1388 void UpdateManager::NotifyFrameCallback(FrameCallbackInterface* frameCallback, Dali::UpdateProxy::NotifySyncPoint syncPoint)
1390 mImpl->GetFrameCallbackProcessor(*this).NotifyFrameCallback(frameCallback, syncPoint);
1393 void UpdateManager::AddSampler(OwnerPointer<Render::Sampler>& sampler)
1395 // Message has ownership of Sampler while in transit from update to render
1396 using DerivedType = MessageValue1<RenderManager, OwnerPointer<Render::Sampler>>;
1398 // Reserve some memory inside the render queue
1399 uint32_t* slot = mImpl->renderQueue.ReserveMessageSlot(mSceneGraphBuffers.GetUpdateBufferIndex(), sizeof(DerivedType));
1401 // Construct message in the render queue memory; note that delete should not be called on the return value
1402 new(slot) DerivedType(&mImpl->renderManager, &RenderManager::AddSampler, sampler);
1405 void UpdateManager::RemoveSampler(Render::Sampler* sampler)
1407 using DerivedType = MessageValue1<RenderManager, Render::Sampler*>;
1409 // Reserve some memory inside the render queue
1410 uint32_t* slot = mImpl->renderQueue.ReserveMessageSlot(mSceneGraphBuffers.GetUpdateBufferIndex(), sizeof(DerivedType));
1412 // Construct message in the render queue memory; note that delete should not be called on the return value
1413 new(slot) DerivedType(&mImpl->renderManager, &RenderManager::RemoveSampler, sampler);
1416 void UpdateManager::SetFilterMode(Render::Sampler* sampler, uint32_t minFilterMode, uint32_t magFilterMode)
1418 using DerivedType = MessageValue3<RenderManager, Render::Sampler*, uint32_t, uint32_t>;
1420 // Reserve some memory inside the render queue
1421 uint32_t* slot = mImpl->renderQueue.ReserveMessageSlot(mSceneGraphBuffers.GetUpdateBufferIndex(), sizeof(DerivedType));
1423 // Construct message in the render queue memory; note that delete should not be called on the return value
1424 new(slot) DerivedType(&mImpl->renderManager, &RenderManager::SetFilterMode, sampler, minFilterMode, magFilterMode);
1427 void UpdateManager::SetWrapMode(Render::Sampler* sampler, uint32_t rWrapMode, uint32_t sWrapMode, uint32_t tWrapMode)
1429 using DerivedType = MessageValue4<RenderManager, Render::Sampler*, uint32_t, uint32_t, uint32_t>;
1431 // Reserve some memory inside the render queue
1432 uint32_t* slot = mImpl->renderQueue.ReserveMessageSlot(mSceneGraphBuffers.GetUpdateBufferIndex(), sizeof(DerivedType));
1434 // Construct message in the render queue memory; note that delete should not be called on the return value
1435 new(slot) DerivedType(&mImpl->renderManager, &RenderManager::SetWrapMode, sampler, rWrapMode, sWrapMode, tWrapMode);
1438 void UpdateManager::AddVertexBuffer(OwnerPointer<Render::VertexBuffer>& vertexBuffer)
1440 // Message has ownership of format while in transit from update -> render
1441 using DerivedType = MessageValue1<RenderManager, OwnerPointer<Render::VertexBuffer>>;
1443 // Reserve some memory inside the render queue
1444 uint32_t* slot = mImpl->renderQueue.ReserveMessageSlot(mSceneGraphBuffers.GetUpdateBufferIndex(), sizeof(DerivedType));
1446 // Construct message in the render queue memory; note that delete should not be called on the return value
1447 new(slot) DerivedType(&mImpl->renderManager, &RenderManager::AddVertexBuffer, vertexBuffer);
1450 void UpdateManager::RemoveVertexBuffer(Render::VertexBuffer* vertexBuffer)
1452 using DerivedType = MessageValue1<RenderManager, Render::VertexBuffer*>;
1454 // Reserve some memory inside the render queue
1455 uint32_t* slot = mImpl->renderQueue.ReserveMessageSlot(mSceneGraphBuffers.GetUpdateBufferIndex(), sizeof(DerivedType));
1457 // Construct message in the render queue memory; note that delete should not be called on the return value
1458 new(slot) DerivedType(&mImpl->renderManager, &RenderManager::RemoveVertexBuffer, vertexBuffer);
1461 void UpdateManager::SetVertexBufferFormat(Render::VertexBuffer* vertexBuffer, OwnerPointer<Render::VertexBuffer::Format>& format)
1463 // Message has ownership of format while in transit from update -> render
1464 using DerivedType = MessageValue2<RenderManager, Render::VertexBuffer*, OwnerPointer<Render::VertexBuffer::Format>>;
1466 // Reserve some memory inside the render queue
1467 uint32_t* slot = mImpl->renderQueue.ReserveMessageSlot(mSceneGraphBuffers.GetUpdateBufferIndex(), sizeof(DerivedType));
1469 // Construct message in the render queue memory; note that delete should not be called on the return value
1470 new(slot) DerivedType(&mImpl->renderManager, &RenderManager::SetVertexBufferFormat, vertexBuffer, format);
1473 void UpdateManager::SetVertexBufferData(Render::VertexBuffer* vertexBuffer, OwnerPointer<Vector<uint8_t>>& data, uint32_t size)
1475 // Message has ownership of format while in transit from update -> render
1476 using DerivedType = MessageValue3<RenderManager, Render::VertexBuffer*, OwnerPointer<Dali::Vector<uint8_t>>, uint32_t>;
1478 // Reserve some memory inside the render queue
1479 uint32_t* slot = mImpl->renderQueue.ReserveMessageSlot(mSceneGraphBuffers.GetUpdateBufferIndex(), sizeof(DerivedType));
1481 // Construct message in the render queue memory; note that delete should not be called on the return value
1482 new(slot) DerivedType(&mImpl->renderManager, &RenderManager::SetVertexBufferData, vertexBuffer, data, size);
1485 void UpdateManager::SetVertexBufferDivisor(Render::VertexBuffer* vertexBuffer, uint32_t divisor)
1487 using LocalType = MessageValue1<Render::VertexBuffer, uint32_t>;
1488 uint32_t* slot = mImpl->renderQueue.ReserveMessageSlot(mSceneGraphBuffers.GetUpdateBufferIndex(), sizeof(LocalType));
1489 new(slot) LocalType(vertexBuffer, &Render::VertexBuffer::SetDivisor, divisor);
1492 void UpdateManager::SetVertexBufferUpdateCallback(Render::VertexBuffer* vertexBuffer, Dali::VertexBufferUpdateCallback* callback)
1494 // Message has ownership of format while in transit from update -> render
1495 using DerivedType = MessageValue2<RenderManager, Render::VertexBuffer*, Dali::VertexBufferUpdateCallback*>;
1497 // Reserve some memory inside the render queue
1498 uint32_t* slot = mImpl->renderQueue.ReserveMessageSlot(mSceneGraphBuffers.GetUpdateBufferIndex(), sizeof(DerivedType));
1500 // Construct message in the render queue memory; note that delete should not be called on the return value
1501 new(slot) DerivedType(&mImpl->renderManager, &RenderManager::SetVertexBufferUpdateCallback, vertexBuffer, callback);
1504 void UpdateManager::AddGeometry(OwnerPointer<Render::Geometry>& geometry)
1506 // Message has ownership of format while in transit from update -> render
1507 using DerivedType = MessageValue1<RenderManager, OwnerPointer<Render::Geometry>>;
1509 // Reserve some memory inside the render queue
1510 uint32_t* slot = mImpl->renderQueue.ReserveMessageSlot(mSceneGraphBuffers.GetUpdateBufferIndex(), sizeof(DerivedType));
1512 // Construct message in the render queue memory; note that delete should not be called on the return value
1513 new(slot) DerivedType(&mImpl->renderManager, &RenderManager::AddGeometry, geometry);
1516 void UpdateManager::RemoveGeometry(Render::Geometry* geometry)
1518 using DerivedType = MessageValue1<RenderManager, Render::Geometry*>;
1520 // Reserve some memory inside the render queue
1521 uint32_t* slot = mImpl->renderQueue.ReserveMessageSlot(mSceneGraphBuffers.GetUpdateBufferIndex(), sizeof(DerivedType));
1523 // Construct message in the render queue memory; note that delete should not be called on the return value
1524 new(slot) DerivedType(&mImpl->renderManager, &RenderManager::RemoveGeometry, geometry);
1527 void UpdateManager::SetGeometryType(Render::Geometry* geometry, uint32_t geometryType)
1529 using DerivedType = MessageValue2<RenderManager, Render::Geometry*, uint32_t>;
1531 // Reserve some memory inside the render queue
1532 uint32_t* slot = mImpl->renderQueue.ReserveMessageSlot(mSceneGraphBuffers.GetUpdateBufferIndex(), sizeof(DerivedType));
1534 // Construct message in the render queue memory; note that delete should not be called on the return value
1535 new(slot) DerivedType(&mImpl->renderManager, &RenderManager::SetGeometryType, geometry, geometryType);
1538 void UpdateManager::SetIndexBuffer(Render::Geometry* geometry, Render::Geometry::Uint16ContainerType& indices)
1540 using DerivedType = IndexBufferMessage<RenderManager, Render::Geometry::Uint16ContainerType>;
1542 // Reserve some memory inside the render queue
1543 uint32_t* slot = mImpl->renderQueue.ReserveMessageSlot(mSceneGraphBuffers.GetUpdateBufferIndex(), sizeof(DerivedType));
1545 // Construct message in the render queue memory; note that delete should not be called on the return value
1546 new(slot) DerivedType(&mImpl->renderManager, geometry, indices);
1549 void UpdateManager::SetIndexBuffer(Render::Geometry* geometry, Render::Geometry::Uint32ContainerType& indices)
1551 using DerivedType = IndexBufferMessage<RenderManager, Render::Geometry::Uint32ContainerType>;
1553 // Reserve some memory inside the render queue
1554 uint32_t* slot = mImpl->renderQueue.ReserveMessageSlot(mSceneGraphBuffers.GetUpdateBufferIndex(), sizeof(DerivedType));
1556 // Construct message in the render queue memory; note that delete should not be called on the return value
1557 new(slot) DerivedType(&mImpl->renderManager, geometry, indices);
1560 void UpdateManager::RemoveVertexBuffer(Render::Geometry* geometry, Render::VertexBuffer* vertexBuffer)
1562 using DerivedType = MessageValue2<RenderManager, Render::Geometry*, Render::VertexBuffer*>;
1564 // Reserve some memory inside the render queue
1565 uint32_t* slot = mImpl->renderQueue.ReserveMessageSlot(mSceneGraphBuffers.GetUpdateBufferIndex(), sizeof(DerivedType));
1567 // Construct message in the render queue memory; note that delete should not be called on the return value
1568 new(slot) DerivedType(&mImpl->renderManager, &RenderManager::RemoveVertexBuffer, geometry, vertexBuffer);
1571 void UpdateManager::AttachVertexBuffer(Render::Geometry* geometry, Render::VertexBuffer* vertexBuffer)
1573 using DerivedType = MessageValue2<RenderManager, Render::Geometry*, Render::VertexBuffer*>;
1575 // Reserve some memory inside the render queue
1576 uint32_t* slot = mImpl->renderQueue.ReserveMessageSlot(mSceneGraphBuffers.GetUpdateBufferIndex(), sizeof(DerivedType));
1578 // Construct message in the render queue memory; note that delete should not be called on the return value
1579 new(slot) DerivedType(&mImpl->renderManager, &RenderManager::AttachVertexBuffer, geometry, vertexBuffer);
1582 void UpdateManager::AddTexture(const Render::TextureKey& texture)
1584 using DerivedType = MessageValue1<RenderManager, Render::TextureKey>;
1586 // Reserve some memory inside the render queue
1587 uint32_t* slot = mImpl->renderQueue.ReserveMessageSlot(mSceneGraphBuffers.GetUpdateBufferIndex(), sizeof(DerivedType));
1589 // Construct message in the render queue memory; note that delete should not be called on the return value
1590 new(slot) DerivedType(&mImpl->renderManager, &RenderManager::AddTexture, texture);
1593 void UpdateManager::RemoveTexture(const Render::TextureKey& texture)
1595 using DerivedType = MessageValue1<RenderManager, Render::TextureKey>;
1597 // Reserve some memory inside the render queue
1598 uint32_t* slot = mImpl->renderQueue.ReserveMessageSlot(mSceneGraphBuffers.GetUpdateBufferIndex(), sizeof(DerivedType));
1600 // Construct message in the render queue memory; note that delete should not be called on the return value
1601 new(slot) DerivedType(&mImpl->renderManager, &RenderManager::RemoveTexture, texture);
1604 void UpdateManager::UploadTexture(const Render::TextureKey& texture, PixelDataPtr pixelData, const Graphics::UploadParams& params)
1606 using DerivedType = MessageValue3<RenderManager, Render::TextureKey, PixelDataPtr, Graphics::UploadParams>;
1608 // Reserve some memory inside the message queue
1609 uint32_t* slot = mImpl->renderQueue.ReserveMessageSlot(mSceneGraphBuffers.GetUpdateBufferIndex(), sizeof(DerivedType));
1611 // Construct message in the message queue memory; note that delete should not be called on the return value
1612 new(slot) DerivedType(&mImpl->renderManager, &RenderManager::UploadTexture, texture, pixelData, params);
1615 void UpdateManager::GenerateMipmaps(const Render::TextureKey& texture)
1617 using DerivedType = MessageValue1<RenderManager, Render::TextureKey>;
1619 // Reserve some memory inside the render queue
1620 uint32_t* slot = mImpl->renderQueue.ReserveMessageSlot(mSceneGraphBuffers.GetUpdateBufferIndex(), sizeof(DerivedType));
1622 // Construct message in the render queue memory; note that delete should not be called on the return value
1623 new(slot) DerivedType(&mImpl->renderManager, &RenderManager::GenerateMipmaps, texture);
1626 void UpdateManager::SetTextureSize(const Render::TextureKey& texture, const Dali::ImageDimensions& size)
1628 using DerivedType = MessageValue2<RenderManager, Render::TextureKey, Dali::ImageDimensions>;
1630 // Reserve some memory inside the render queue
1631 uint32_t* slot = mImpl->renderQueue.ReserveMessageSlot(mSceneGraphBuffers.GetUpdateBufferIndex(), sizeof(DerivedType));
1633 // Construct message in the render queue memory; note that delete should not be called on the return value
1634 new(slot) DerivedType(&mImpl->renderManager, &RenderManager::SetTextureSize, texture, size);
1637 void UpdateManager::SetTextureFormat(const Render::TextureKey& texture, Dali::Pixel::Format pixelFormat)
1639 using DerivedType = MessageValue2<RenderManager, Render::TextureKey, Dali::Pixel::Format>;
1641 // Reserve some memory inside the render queue
1642 uint32_t* slot = mImpl->renderQueue.ReserveMessageSlot(mSceneGraphBuffers.GetUpdateBufferIndex(), sizeof(DerivedType));
1644 // Construct message in the render queue memory; note that delete should not be called on the return value
1645 new(slot) DerivedType(&mImpl->renderManager, &RenderManager::SetTextureFormat, texture, pixelFormat);
1648 void UpdateManager::AddFrameBuffer(OwnerPointer<Render::FrameBuffer>& frameBuffer)
1650 using DerivedType = MessageValue1<RenderManager, OwnerPointer<Render::FrameBuffer>>;
1652 // Reserve some memory inside the render queue
1653 uint32_t* slot = mImpl->renderQueue.ReserveMessageSlot(mSceneGraphBuffers.GetUpdateBufferIndex(), sizeof(DerivedType));
1655 // Construct message in the render queue memory; note that delete should not be called on the return value
1656 new(slot) DerivedType(&mImpl->renderManager, &RenderManager::AddFrameBuffer, frameBuffer);
1659 void UpdateManager::RemoveFrameBuffer(Render::FrameBuffer* frameBuffer)
1661 using DerivedType = MessageValue1<RenderManager, Render::FrameBuffer*>;
1663 // Reserve some memory inside the render queue
1664 uint32_t* slot = mImpl->renderQueue.ReserveMessageSlot(mSceneGraphBuffers.GetUpdateBufferIndex(), sizeof(DerivedType));
1666 // Construct message in the render queue memory; note that delete should not be called on the return value
1667 new(slot) DerivedType(&mImpl->renderManager, &RenderManager::RemoveFrameBuffer, frameBuffer);
1670 void UpdateManager::AttachColorTextureToFrameBuffer(Render::FrameBuffer* frameBuffer, Render::Texture* texture, uint32_t mipmapLevel, uint32_t layer)
1672 using DerivedType = MessageValue4<RenderManager, Render::FrameBuffer*, Render::Texture*, uint32_t, uint32_t>;
1674 // Reserve some memory inside the render queue
1675 uint32_t* slot = mImpl->renderQueue.ReserveMessageSlot(mSceneGraphBuffers.GetUpdateBufferIndex(), sizeof(DerivedType));
1677 // Construct message in the render queue memory; note that delete should not be called on the return value
1678 new(slot) DerivedType(&mImpl->renderManager, &RenderManager::AttachColorTextureToFrameBuffer, frameBuffer, texture, mipmapLevel, layer);
1681 void UpdateManager::AttachDepthTextureToFrameBuffer(Render::FrameBuffer* frameBuffer, Render::Texture* texture, uint32_t mipmapLevel)
1683 using DerivedType = MessageValue3<RenderManager, Render::FrameBuffer*, Render::Texture*, uint32_t>;
1685 // Reserve some memory inside the render queue
1686 uint32_t* slot = mImpl->renderQueue.ReserveMessageSlot(mSceneGraphBuffers.GetUpdateBufferIndex(), sizeof(DerivedType));
1688 // Construct message in the render queue memory; note that delete should not be called on the return value
1689 new(slot) DerivedType(&mImpl->renderManager, &RenderManager::AttachDepthTextureToFrameBuffer, frameBuffer, texture, mipmapLevel);
1692 void UpdateManager::AttachDepthStencilTextureToFrameBuffer(Render::FrameBuffer* frameBuffer, Render::Texture* texture, uint32_t mipmapLevel)
1694 using DerivedType = MessageValue3<RenderManager, Render::FrameBuffer*, Render::Texture*, uint32_t>;
1696 // Reserve some memory inside the render queue
1697 uint32_t* slot = mImpl->renderQueue.ReserveMessageSlot(mSceneGraphBuffers.GetUpdateBufferIndex(), sizeof(DerivedType));
1699 // Construct message in the render queue memory; note that delete should not be called on the return value
1700 new(slot) DerivedType(&mImpl->renderManager, &RenderManager::AttachDepthStencilTextureToFrameBuffer, frameBuffer, texture, mipmapLevel);
1703 void UpdateManager::SetMultiSamplingLevelToFrameBuffer(Render::FrameBuffer* frameBuffer, uint8_t multiSamplingLevel)
1705 using DerivedType = MessageValue2<RenderManager, Render::FrameBuffer*, uint8_t>;
1707 // Reserve some memory inside the render queue
1708 uint32_t* slot = mImpl->renderQueue.ReserveMessageSlot(mSceneGraphBuffers.GetUpdateBufferIndex(), sizeof(DerivedType));
1710 // Construct message in the render queue memory; note that delete should not be called on the return value
1711 new(slot) DerivedType(&mImpl->renderManager, &RenderManager::SetMultiSamplingLevelToFrameBuffer, frameBuffer, multiSamplingLevel);
1714 } // namespace SceneGraph
1716 } // namespace Internal