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) 2020 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 namespace Integration
  24 {
  25 /**
  26  * Abstract interface for an object which controls rendering.
  27  * This will be informed when Dali has new content to render.
  28  */
  29 class RenderController
  30 {
  31 protected:
  32   /**
  33    * Virtual protected destructor, no deletion through this interface
  34    */
  35   virtual ~RenderController() = default;
  36
  37 public:
  38   /**
  39    * Requests a future call to Dali::Integration::Core::Update().
  40    * This is called when Dali has new content, typically in response to Actors/Animations being added.
  41    * Multi-threading note: this method will be called from the main thread only.
  42    * @param[in] forceUpdate true to update forcely.
  43    */
  44   virtual void RequestUpdate(bool forceUpdate) = 0;
  45
  46   /**
  47    * Requests a future call to Dali::Integration::Core::ProcessEvents(), when the application is idle.
  48    * Multi-threading note: this method will be called from the main thread only.
  49    * @param[in] forceProcess true to process events forcely.
  50    */
  51   virtual void RequestProcessEventsOnIdle(bool forceProcess) = 0;
  52 };
  53
  54 } // namespace Integration
  55
  56 } // namespace Dali
  57
  58 #endif // DALI_INTEGRATION_RENDER_CONTROLLER_H