1 #ifndef __DALI_INTERNAL_EVENT_THREAD_SERVICES_H__
2 #define __DALI_INTERNAL_EVENT_THREAD_SERVICES_H__
5 * Copyright (c) 2017 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 * @brief Registers the object as created with the Object registry.
63 * @param[in] object to register
65 virtual void RegisterObject( BaseObject* object) = 0;
68 * @brief Unregisters the object from Object registry.
70 * @param[in] object to unregister
72 virtual void UnregisterObject( BaseObject* object) = 0;
75 * @brief Get a reference to the UpdateManager
77 * @return the update manager
79 virtual SceneGraph::UpdateManager& GetUpdateManager() = 0;
82 * @brief Get a reference to the RenderController
84 * @return the render controller
86 virtual Integration::RenderController& GetRenderController() = 0;
89 * Reserve space for another message in the queue; this must then be initialized by the caller.
90 * The message will be read from the update-thread after the next FlushMessages is called.
91 * @post Calling this method may invalidate any previously returned slots.
92 * @param[in] size The message size with respect to the size of type "char".
93 * @param[in] updateScene A flag, when true denotes that the message will cause the scene-graph node tree to require an update.
94 * @return A pointer to the first char allocated for the message.
96 virtual unsigned int* ReserveMessageSlot( std::size_t size, bool updateScene = true ) = 0;
99 * @return the current event-buffer index.
101 virtual BufferIndex GetEventBufferIndex() const = 0;
104 * @brief Indicate that the next rendering is really required.
106 virtual void ForceNextUpdate() = 0;
109 * @brief Check if the next rendering is really required.
111 * @return true if the next rendering is really required.
113 virtual bool IsNextUpdateForced() = 0;
116 * @return true if core is still running and we can send messages
118 static bool IsCoreRunning();
121 } // namespace Internal
125 #endif // __DALI_INTERNAL_EVENT_THREAD_SERVICES_H__