1 #ifndef DALI_INTERNAL_SCENE_GRAPH_RENDER_QUEUE_H
2 #define DALI_INTERNAL_SCENE_GRAPH_RENDER_QUEUE_H
5 * Copyright (c) 2021 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/internal/common/buffer-index.h>
23 #include <dali/internal/common/message-buffer.h>
34 * Allows messages to be queued for RenderManager, during the scene-graph Update.
40 * Create a new RenderQueue.
45 * Non-virtual destructor; RenderQueue is not suitable as a base class.
50 * Reserve space for another message in the queue; this must then be initialized by the caller.
51 * The message will be read from the next render-thread tick.
52 * @post Calling this method may invalidate any previously returned slots.
53 * @param[in] updateBufferIndex The current update buffer index.
54 * @param[in] size The message size with respect to the size of type "char".
55 * @return A pointer to the first char allocated for the message.
57 uint32_t* ReserveMessageSlot(BufferIndex updateBufferIndex, std::size_t size);
60 * Process the batch of messages, which were queued in the previous update.
61 * @pre This message should only be called by RenderManager from within the render-thread.
62 * @param[in] bufferIndex The previous update buffer index.
64 void ProcessMessages(BufferIndex bufferIndex);
68 * Helper to retrieve the current container.
69 * The update-thread queues messages with one container, whilst the render-thread is processing the other.
70 * @param[in] bufferIndex The current buffer index.
71 * @return The container.
73 MessageBuffer* GetCurrentContainer(BufferIndex bufferIndex);
76 * Helper to limit the buffer capacity i.e. after a frame when an extreme number of messages have been sent.
77 * @param[in] bufferIndex The current buffer index.
79 void LimitBufferCapacity(BufferIndex bufferIndex);
82 RenderQueue(const RenderQueue&);
85 RenderQueue& operator=(const RenderQueue& rhs);
88 MessageBuffer* container0; ///< Messages are queued here when the update buffer index == 0
89 MessageBuffer* container1; ///< Messages are queued here when the update buffer index == 1
92 } // namespace SceneGraph
94 } // namespace Internal
98 #endif // DALI_INTERNAL_SCENE_GRAPH_RENDER_QUEUE_H