[dali_2.3.37] Merge branch 'devel/master'

[platform/core/uifw/dali-core.git] / dali / public-api / render-tasks / render-task.h

diff --git a/dali/public-api/render-tasks/render-task.h b/dali/public-api/render-tasks/render-task.h
index 9e95672..e00eea8 100644 (file)
--- a/dali/public-api/render-tasks/render-task.h
+++ b/dali/public-api/render-tasks/render-task.h
@@ -230,7 +230,7 @@ public:
    * @SINCE_1_9.22
    * @param[in] rhs A reference to the moved handle
    */
-  RenderTask(RenderTask&& rhs);
+  RenderTask(RenderTask&& rhs) noexcept;
 
   /**
    * @brief Move assignment operator.
@@ -239,7 +239,7 @@ public:
    * @param[in] rhs A reference to the moved handle
    * @return A reference to this
    */
-  RenderTask& operator=(RenderTask&& rhs);
+  RenderTask& operator=(RenderTask&& rhs) noexcept;
 
   /**
    * @brief Sets the actors to be rendered.
@@ -257,6 +257,13 @@ public:
   Actor GetSourceActor() const;
 
   /**
+   * @brief Retrives stopper actor.
+   * @SINCE_2_3.23
+   * @return The actor that marks where to stop rendering.
+   */
+  Actor GetStopperActor() const;
+
+  /**
    * @brief Sets whether the RenderTask has exclusive access to the source actors; the default is false.
    * @SINCE_1_0.0
    * @param[in] exclusive True if the source actors will only be rendered by this render-task
@@ -352,6 +359,30 @@ public:
   Actor GetScreenToFrameBufferMappingActor() const;
 
   /**
+   * @brief Sets the actor to compute viewport of this render task.
+   * Actor should be added on Scene.
+   * @SINCE_2_1.36
+   * @param[in] actor This actor is used to compute viewport of the render task.
+   * @note If window default camera is rotated and the actor is no longer a rectangle on the screen, Viewport may be computed incorrectly.
+   * The Viewport properties VIEWPORT_POSITION and VIEWPORT_SIZE is kept during using ViewportGuideActor, but only current value is changed.
+   */
+  void SetViewportGuideActor(Actor actor);
+
+  /**
+   * @brief Retrieves the actor to compute viewport of this render task.
+   * @SINCE_2_1.36
+   * @return This actor is used to compute viewport of the render task.
+   */
+  Actor GetViewportGuideActor() const;
+
+  /**
+   * @brief Resets the actor to compute viewport of this render task.
+   * @SINCE_2_1.36
+   * @note The Viewport properties VIEWPORT_POSITION and VIEWPORT_SIZE is still kept.
+   */
+  void ResetViewportGuideActor();
+
+  /**
    * @brief Sets the GL viewport position used when rendering.
    *
    * This specifies the transformation between normalized device coordinates and target window (or frame-buffer) coordinates.
@@ -511,6 +542,57 @@ public:
    */
   bool ViewportToLocal(Actor actor, float viewportX, float viewportY, float& localX, float& localY) const;
 
+  /**
+   * Sets Render Pass key for this RenderTask.
+   * Shader code that matches this render pass is used for rendering.
+   * If no matching shader is found, the code with a render pass of 0 is used.
+   * In other cases, operation is not guaranteed.
+   * @param[in] renderPassTag RenderPassTag value for this render task.
+   * @note RenderPassTag of default RenderTask is 0u.
+   */
+  void SetRenderPassTag(uint32_t renderPassTag);
+
+  /**
+   * Gets Render Pass key for this RenderTask.
+   * @return RenderPassTag value for this render task.
+   */
+  uint32_t GetRenderPassTag() const;
+
+  /**
+   * Sets Order Index to define rendering order for this RenderTask.
+   * In the DALi, offscreen renderTasks are rendered earlier than onscreen renderTask.
+   * In each category of OffScreen RenderTask and OnScreen RenderTask,
+   * a RenderTask with a smaller orderIndex is rendered first.
+   * The RenderTasks in RenderTaskList is always sorted as acending order of the OrderIndex.
+   * The OrderIndex value is needed to be set between [-1000, 1000].
+   * Default orderIndex is 0.
+   * @param[in] orderIndex the order index for this render task.
+   * @note The order among RenderTasks whose OrderIndex has not changed follows the order in which they were created.
+   * @note Rendering order among RenderTasks those have same OrderIndex cannot be guaranteed after the OrderIndex is changed
+   */
+  void SetOrderIndex(int32_t orderIndex);
+
+  /**
+   * Gets Order Index for this RenderTask.
+   * @return OrderIndex value for this render task.
+   */
+  int32_t GetOrderIndex() const;
+
+  /**
+   * @brief Get the unique id of RenderTask. It could be 0 given render task is invalid.
+   *
+   * @SINCE_2_3.10
+   * @return The unique id of RenderTask, or 0 if invalid.
+   */
+  uint32_t GetRenderTaskId() const;
+
+  /**
+   * @brief Stop rendering from given actor. The actor is not included.
+   * @SINCE_2_3.23
+   * @param[in] stopperActor A marker to stop rendering.
+   */
+  void RenderUntil(Actor stopperActor);
+
 public: // Signals
   /**
    * @brief If the refresh rate is REFRESH_ONCE, connect to this signal to be notified when a RenderTask has finished.