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()
61 * Get the EventThreadServices
62 * @return reference to the EventThreadServices
64 static EventThreadServices& Get();
67 * @brief Registers the object as created with the Object registry.
69 * @param[in] object to register
71 virtual void RegisterObject( BaseObject* object) = 0;
74 * @brief Unregisters the object from Object registry.
76 * @param[in] object to unregister
78 virtual void UnregisterObject( BaseObject* object) = 0;
81 * @brief Get a reference to the UpdateManager
83 * @return the update manager
85 virtual SceneGraph::UpdateManager& GetUpdateManager() = 0;
88 * @brief Get a reference to the RenderController
90 * @return the render controller
92 virtual Integration::RenderController& GetRenderController() = 0;
95 * Reserve space for another message in the queue; this must then be initialized by the caller.
96 * The message will be read from the update-thread after the next FlushMessages is called.
97 * @post Calling this method may invalidate any previously returned slots.
98 * @param[in] size The message size with respect to the size of type "char".
99 * @param[in] updateScene A flag, when true denotes that the message will cause the scene-graph node tree to require an update.
100 * @return A pointer to the first char allocated for the message.
102 virtual uint32_t* ReserveMessageSlot( uint32_t size, bool updateScene = true ) = 0;
105 * @return the current event-buffer index.
107 virtual BufferIndex GetEventBufferIndex() const = 0;
110 * @brief Indicate that the next rendering is really required.
112 virtual void ForceNextUpdate() = 0;
115 * @brief Check if the next rendering is really required.
117 * @return true if the next rendering is really required.
119 virtual bool IsNextUpdateForced() = 0;
122 * @return true if core is still running and we can send messages
124 static bool IsCoreRunning();
127 } // namespace Internal
131 #endif // DALI_INTERNAL_EVENT_THREAD_SERVICES_H