Change to process events when the application is paused
[platform/core/uifw/dali-core.git] / dali / integration-api / render-controller.h
1 #ifndef __DALI_INTEGRATION_RENDER_CONTROLLER_H__
2 #define __DALI_INTEGRATION_RENDER_CONTROLLER_H__
3
4 /*
5  * Copyright (c) 2017 Samsung Electronics Co., Ltd.
6  *
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
10  *
11  * http://www.apache.org/licenses/LICENSE-2.0
12  *
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.
18  *
19  */
20
21 namespace Dali
22 {
23
24 namespace Integration
25 {
26
27 /**
28  * Abstract interface for an object which controls rendering.
29  * This will be informed when Dali has new content to render.
30  */
31 class RenderController
32 {
33 protected:
34
35   /**
36    * Virtual protected destructor, no deletion through this interface
37    */
38   virtual ~RenderController() {}
39
40 public:
41
42   /**
43    * Requests a future call to Dali::Integration::Core::Update().
44    * This is called when Dali has new content, typically in response to Actors/Animations being added.
45    * Multi-threading note: this method will be called from the main thread only.
46    * @param[in] forceUpdate true to update forcely.
47    */
48   virtual void RequestUpdate( bool forceUpdate ) = 0;
49
50   /**
51    * Requests a future call to Dali::Integration::Core::ProcessEvents(), when the application is idle.
52    * Multi-threading note: this method will be called from the main thread only.
53    * @param[in] forceProcess true to process events forcely.
54    */
55   virtual void RequestProcessEventsOnIdle( bool forceProcess ) = 0;
56
57 };
58
59 } // namespace Integration
60
61 } // namespace Dali
62
63 #endif // __DALI_INTEGRATION_RENDER_CONTROLLER_H__