1 #ifndef DALI_INTERNAL_THREAD_CONTROLLER_H
2 #define DALI_INTERNAL_THREAD_CONTROLLER_H
5 * Copyright (c) 2020 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.
20 #include <dali/public-api/signals/callback.h>
23 #include <dali/internal/window-system/common/display-connection.h>
28 class RenderSurfaceInterface;
36 enum class UpdateMode;
37 enum class ThreadMode;
39 class AdaptorInternalServices;
40 class EnvironmentOptions;
41 class ThreadControllerInterface;
44 * Class to control all the threads.
46 class ThreadController
53 ThreadController( AdaptorInternalServices& adaptorInterfaces, const EnvironmentOptions& environmentOptions, ThreadMode threadMode );
56 * Non virtual destructor. Not intended as base class.
61 * @brief Initializes the thread controller
63 * Will do any required initialiszation, e.g. initialize EGL, create threads (if required), etc.
65 * @note When this function returns, the application Init signal should be emitted
70 * @brief Called AFTER the Init signal has been emitted.
72 * In other words, should be called AFTER the Init signal has been emitted and all messages for the first scene
73 * have been queued for update to process.
78 * @brief When called, update and rendering is paused.
83 * @brief Resumes update/rendering after a previous pause.
88 * @brief Stops update/rendering altogether.
90 * Will shutdown EGL, destroy threads (if required) etc.
95 * @brief Called by the adaptor when core requires another update
100 * @brief Called by the adaptor when core requires one update
102 * @note If Adaptor is paused, we do one update/render only
104 * @param updateMode The update mode (i.e. either update and render, or update and upload without rendering)
106 void RequestUpdateOnce( UpdateMode updateMode );
109 * @brief Replaces the surface.
111 * @param surface new surface
113 void ReplaceSurface( Dali::RenderSurfaceInterface* surface );
116 * Deletes the surface.
117 * @param surface The surface to be deleted
119 void DeleteSurface( Dali::RenderSurfaceInterface* surface );
122 * Resize the surface.
124 void ResizeSurface();
127 * Wait until the graphics is initialised.
129 void WaitForGraphicsInitialization();
132 * @copydoc Dali::Adaptor::SetRenderRefreshRate()
134 void SetRenderRefreshRate( unsigned int numberOfVSyncsPerRender );
137 * @copydoc Dali::Adaptor::SetPreRenderCallback
139 void SetPreRenderCallback( CallbackBase* callback );
142 * @brief Adds the new surface.
144 * @param surface new surface
146 void AddSurface( Dali::RenderSurfaceInterface* surface );
150 // Undefined copy constructor.
151 ThreadController( const ThreadController& ) = delete;
153 // Undefined assignment operator.
154 ThreadController& operator=( const ThreadController& ) = delete;
158 ThreadControllerInterface* mThreadControllerInterface;
161 } // namespace Adaptor
163 } // namespace Internal
167 #endif // DALI_INTERNAL_THREAD_CONTROLLER_H