[dali_2.3.39] Merge branch 'devel/master'
[platform/core/uifw/dali-core.git] / dali / public-api / render-tasks / render-task.h
index 6eab3d4..1835d06 100644 (file)
@@ -2,7 +2,7 @@
 #define DALI_RENDER_TASK_H
 
 /*
 #define DALI_RENDER_TASK_H
 
 /*
- * Copyright (c) 2020 Samsung Electronics Co., Ltd.
+ * Copyright (c) 2024 Samsung Electronics Co., Ltd.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -257,6 +257,13 @@ public:
   Actor GetSourceActor() const;
 
   /**
   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
    * @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
@@ -579,6 +586,14 @@ public:
    */
   uint32_t GetRenderTaskId() const;
 
    */
   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.
+   * If actor is an empty handle, or stopperActor is not a child of sourceActor, then full scene will be rendered
+   */
+  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.
 public: // Signals
   /**
    * @brief If the refresh rate is REFRESH_ONCE, connect to this signal to be notified when a RenderTask has finished.