1 #ifndef DALI_INTERNAL_EVENT_THREAD_SERVICES_H
2 #define DALI_INTERNAL_EVENT_THREAD_SERVICES_H
5 * Copyright (c) 2019 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.
25 #include <dali/internal/common/buffer-index.h>
34 class RenderController;
46 * Abstract interface of services for event-thread objects.
47 * Used for registering objects, queueing messages during the event-thread for the next update.
48 * Allows the event-thread to read double-buffered property values.
50 class EventThreadServices
57 virtual ~EventThreadServices() = default;
60 * Get the EventThreadServices
61 * @return reference to the EventThreadServices
63 static EventThreadServices& Get();
66 * @brief Registers the object as created with the Object registry.
68 * @param[in] object to register
70 virtual void RegisterObject( BaseObject* object) = 0;
73 * @brief Unregisters the object from Object registry.
75 * @param[in] object to unregister
77 virtual void UnregisterObject( BaseObject* object) = 0;
80 * @brief Get a reference to the UpdateManager
82 * @return the update manager
84 virtual SceneGraph::UpdateManager& GetUpdateManager() = 0;
87 * @brief Get a reference to the RenderController
89 * @return the render controller
91 virtual Integration::RenderController& GetRenderController() = 0;
94 * Reserve space for another message in the queue; this must then be initialized by the caller.
95 * The message will be read from the update-thread after the next FlushMessages is called.
96 * @post Calling this method may invalidate any previously returned slots.
97 * @param[in] size The message size with respect to the size of type "char".
98 * @param[in] updateScene A flag, when true denotes that the message will cause the scene-graph node tree to require an update.
99 * @return A pointer to the first char allocated for the message.
101 virtual uint32_t* ReserveMessageSlot( uint32_t size, bool updateScene = true ) = 0;
104 * @return the current event-buffer index.
106 virtual BufferIndex GetEventBufferIndex() const = 0;
109 * @brief Indicate that the next rendering is really required.
111 virtual void ForceNextUpdate() = 0;
114 * @brief Check if the next rendering is really required.
116 * @return true if the next rendering is really required.
118 virtual bool IsNextUpdateForced() = 0;
121 * @return true if core is still running and we can send messages
123 static bool IsCoreRunning();
126 } // namespace Internal
130 #endif // DALI_INTERNAL_EVENT_THREAD_SERVICES_H