2 * Copyright (c) 2016 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/render-task-processor.h>
22 #include <dali/internal/update/manager/sorted-layers.h>
23 #include <dali/internal/update/render-tasks/scene-graph-render-task.h>
24 #include <dali/internal/update/render-tasks/scene-graph-render-task-list.h>
25 #include <dali/internal/update/nodes/scene-graph-layer.h>
26 #include <dali/internal/render/common/render-item.h>
27 #include <dali/internal/render/common/render-tracker.h>
28 #include <dali/internal/render/common/render-instruction.h>
29 #include <dali/internal/render/common/render-instruction-container.h>
30 #include <dali/internal/render/renderers/render-renderer.h>
31 #include <dali/integration-api/debug.h>
33 #if defined(DEBUG_ENABLED)
34 extern Debug::Filter* gRenderTaskLogFilter;
47 namespace //Unnamed namespace
50 // Return false if the node or it's parents are exclusive to another render-task.
51 bool CheckExclusivity( const Node& node, const RenderTask& task )
53 const RenderTask* exclusiveTo = node.GetExclusiveRenderTask();
56 return ( exclusiveTo == &task );
59 const Node* parent = node.GetParent();
62 return CheckExclusivity( *parent, task );
65 // No exclusive flags set.
69 Layer* FindLayer( Node& node )
71 Node* currentNode( &node );
75 if( ( layer = currentNode->GetLayer() ) != NULL )
80 currentNode = currentNode->GetParent();
87 * Rebuild the Layer::colorRenderables and overlayRenderables members,
88 * including only renderers which are included in the current render-task.
89 * Returns true if all renderers have finished acquiring resources.
91 * @param[in] updateBufferIndex The current update buffer index.
92 * @param[in] node The current node of the scene-graph.
93 * @param[in] currentLayer The current layer containing lists of opaque/transparent renderables.
94 * @param[in] renderTask The current render-task.
95 * @param[in] inheritedDrawMode The draw mode of the parent
96 * @param[in] parentDepthIndex The inherited parent node depth index
97 * @param[in] currentClippingId The current Clipping Id
98 * Note: ClippingId is passed by reference, so it is permanently modified when traversing back up the tree for uniqueness.
99 * @param[in] clippingDepth The current clipping depth
101 bool AddRenderablesForTask( BufferIndex updateBufferIndex,
104 RenderTask& renderTask,
105 int inheritedDrawMode,
106 uint32_t& currentClippingId,
107 uint32_t clippingDepth )
109 bool resourcesFinished = true;
111 // Short-circuit for invisible nodes
112 if( !node.IsVisible( updateBufferIndex ) )
114 return resourcesFinished;
117 // Check whether node is exclusive to a different render-task
118 const RenderTask* exclusiveTo = node.GetExclusiveRenderTask();
119 if( exclusiveTo && ( exclusiveTo != &renderTask ) )
121 return resourcesFinished;
124 // Assume all children go to this layer (if this node is a layer).
125 Layer* layer = node.GetLayer();
128 // Layers do not inherit the DrawMode from their parents
129 inheritedDrawMode = node.GetDrawMode();
133 // This node is not a layer.
134 layer = ¤tLayer;
135 inheritedDrawMode |= node.GetDrawMode();
138 DALI_ASSERT_DEBUG( NULL != layer );
140 // Update the clipping Id and depth for this node (if clipping is enabled).
141 if( DALI_UNLIKELY( node.GetClippingMode() != ClippingMode::DISABLED ) )
143 ++currentClippingId; // This modifies the reference passed in as well as the local value, causing the value to be global to the recursion.
144 ++clippingDepth; // This only modifies the local value (which is passed in when the method recurses).
146 // Set the information in the node.
147 node.SetClippingInformation( currentClippingId, clippingDepth );
149 const unsigned int count = node.GetRendererCount();
150 for( unsigned int i = 0; i < count; ++i )
152 SceneGraph::Renderer* renderer = node.GetRendererAt( i );
154 bool complete = false;
155 renderer->GetReadyAndComplete( ready, complete );
157 DALI_LOG_INFO( gRenderTaskLogFilter, Debug::General, "Testing renderable:%p ready:%s complete:%s\n", renderer, ready ? "T" : "F", complete ? "T" : "F" );
159 resourcesFinished &= complete;
161 if( ready ) // IE. should be rendered (all resources are available)
163 // Normal is the more-likely draw mode to occur.
164 if( DALI_LIKELY( inheritedDrawMode == DrawMode::NORMAL ) )
166 layer->colorRenderables.PushBack( Renderable( &node, renderer ) );
170 layer->overlayRenderables.PushBack( Renderable( &node, renderer ) );
176 NodeContainer& children = node.GetChildren();
177 const NodeIter endIter = children.End();
178 for( NodeIter iter = children.Begin(); iter != endIter; ++iter )
180 Node& child = **iter;
181 bool childResourcesComplete = AddRenderablesForTask( updateBufferIndex, child, *layer, renderTask, inheritedDrawMode, currentClippingId, clippingDepth );
182 resourcesFinished &= childResourcesComplete;
185 return resourcesFinished;
188 } // Anonymous namespace.
191 RenderTaskProcessor::RenderTaskProcessor()
195 RenderTaskProcessor::~RenderTaskProcessor()
199 void RenderTaskProcessor::Process( BufferIndex updateBufferIndex,
200 RenderTaskList& renderTasks,
202 SortedLayerPointers& sortedLayers,
203 RenderInstructionContainer& instructions )
205 RenderTaskList::RenderTaskContainer& taskContainer = renderTasks.GetTasks();
207 if( taskContainer.IsEmpty() )
209 // Early-exit if there are no tasks to process
213 // For each render-task:
214 // 1) Prepare the render-task
215 // 2) Clear the layer-stored lists of renderers (TODO check if the layer is not changed and don't clear in this case)
216 // 3) Traverse the scene-graph, filling the lists for the current render-task
217 // 4) Prepare render-instructions
219 DALI_LOG_INFO( gRenderTaskLogFilter, Debug::General, "RenderTaskProcessor::Process() Offscreens first\n" );
221 // First process off screen render tasks - we may need the results of these for the on screen renders
222 uint32_t clippingId = 0u;
223 bool hasClippingNodes = false;
225 RenderTaskList::RenderTaskContainer::ConstIterator endIter = taskContainer.End();
226 for( RenderTaskList::RenderTaskContainer::Iterator iter = taskContainer.Begin(); endIter != iter; ++iter )
228 RenderTask& renderTask = **iter;
231 if( ( renderTask.GetFrameBuffer() == 0 ) || ( !renderTask.ReadyToRender( updateBufferIndex ) ) )
233 // Skip to next task.
237 Node* sourceNode = renderTask.GetSourceNode();
238 DALI_ASSERT_DEBUG( NULL != sourceNode ); // Otherwise Prepare() should return false
240 // Check that the source node is not exclusive to another task.
241 if( ! CheckExclusivity( *sourceNode, renderTask ) )
246 Layer* layer = FindLayer( *sourceNode );
249 // Skip to next task as no layer.
253 bool resourcesFinished = false;
254 if( renderTask.IsRenderRequired() )
256 size_t layerCount( sortedLayers.size() );
257 for( size_t i(0); i<layerCount; ++i )
259 sortedLayers[i]->ClearRenderables();
262 resourcesFinished = AddRenderablesForTask( updateBufferIndex,
266 sourceNode->GetDrawMode(),
270 renderTask.SetResourcesFinished( resourcesFinished );
272 // If the clipping Id is still 0 after adding all Renderables, there is no clipping required for this RenderTaskList.
273 hasClippingNodes = clippingId != 0u;
275 mRenderInstructionProcessor.Prepare( updateBufferIndex,
278 renderTask.GetCullMode(),
284 renderTask.SetResourcesFinished( resourcesFinished );
288 DALI_LOG_INFO( gRenderTaskLogFilter, Debug::General, "RenderTaskProcessor::Process() Onscreen\n" );
290 // Now that the off screen renders are done we can process on screen render tasks.
291 // Reset the clipping Id for the OnScreen render tasks.
293 for ( RenderTaskList::RenderTaskContainer::Iterator iter = taskContainer.Begin(); endIter != iter; ++iter )
295 RenderTask& renderTask = **iter;
298 if( ( renderTask.GetFrameBuffer() != 0 ) || ( !renderTask.ReadyToRender( updateBufferIndex ) ) )
300 // Skip to next task.
304 Node* sourceNode = renderTask.GetSourceNode();
305 DALI_ASSERT_DEBUG( NULL != sourceNode ); // Otherwise Prepare() should return false.
307 // Check that the source node is not exclusive to another task.
308 if( ! CheckExclusivity( *sourceNode, renderTask ) )
313 Layer* layer = FindLayer( *sourceNode );
316 // Skip to next task as no layer.
320 bool resourcesFinished = false;
321 if( renderTask.IsRenderRequired() )
323 size_t layerCount( sortedLayers.size() );
324 for( size_t i(0); i < layerCount; ++i )
326 sortedLayers[i]->ClearRenderables();
329 resourcesFinished = AddRenderablesForTask( updateBufferIndex,
333 sourceNode->GetDrawMode(),
337 // If the clipping Id is still 0 after adding all Renderables, there is no clipping required for this RenderTaskList.
338 hasClippingNodes = clippingId != 0;
340 mRenderInstructionProcessor.Prepare( updateBufferIndex,
343 renderTask.GetCullMode(),
348 renderTask.SetResourcesFinished( resourcesFinished );