Merge branch 'devel/master' into tizen
[platform/core/uifw/dali-core.git] / dali / internal / update / common / property-owner.h
index 843a19b..769dc35 100644 (file)
@@ -2,7 +2,7 @@
 #define DALI_INTERNAL_SCENE_GRAPH_PROPERTY_OWNER_H
 
 /*
- * Copyright (c) 2019 Samsung Electronics Co., Ltd.
+ * Copyright (c) 2023 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.
  */
 
 // INTERNAL INCLUDES
-#include <dali/public-api/common/dali-vector.h>
 #include <dali/devel-api/common/owner-container.h>
+#include <dali/internal/common/const-string.h>
 #include <dali/internal/common/message.h>
+#include <dali/internal/update/animation/scene-graph-constraint-declarations.h>
 #include <dali/internal/update/common/property-base.h>
 #include <dali/internal/update/common/scene-graph-buffers.h>
 #include <dali/internal/update/common/uniform-map.h>
-#include <dali/internal/update/animation/scene-graph-constraint-declarations.h>
-
+#include <dali/public-api/common/dali-vector.h>
 
 namespace Dali
 {
-
 namespace Internal
 {
-
 namespace SceneGraph
 {
-
 class PropertyOwner;
+class ResetterManager;
 
-typedef OwnerContainer< PropertyBase* > OwnedPropertyContainer;
-typedef OwnedPropertyContainer::Iterator  OwnedPropertyIter;
+using OwnedPropertyContainer = OwnerContainer<PropertyBase*>;
+using OwnedPropertyIter      = OwnedPropertyContainer::Iterator;
 
 /**
  * An update-thread object which own properties.
@@ -49,23 +47,21 @@ typedef OwnedPropertyContainer::Iterator  OwnedPropertyIter;
 class PropertyOwner
 {
 public:
-
   class Observer
   {
   public:
-
     /**
      * Called when the observable object is connected to the scene graph.
      * @param[in] owner A reference to the connected PropertyOwner
      */
-    virtual void PropertyOwnerConnected( PropertyOwner& owner ) = 0;
+    virtual void PropertyOwnerConnected(PropertyOwner& owner) = 0;
 
     /**
      * Called when the observable object is disconnected from the scene graph.
      * @param[in] currentBufferIndex The buffer to reset.
      * @param[in] owner A reference to the disconnected PropertyOwner
      */
-    virtual void PropertyOwnerDisconnected( BufferIndex updateBufferIndex, PropertyOwner& owner ) = 0;
+    virtual void PropertyOwnerDisconnected(BufferIndex updateBufferIndex, PropertyOwner& owner) = 0;
 
     /**
      * Called shortly before the observable object is destroyed.
@@ -73,15 +69,13 @@ public:
      * @note Cleanup should be done in both this and PropertyOwnerDisconnected as PropertyOwnerDisconnected
      * may not be called (i.e. when shutting down).
      */
-    virtual void PropertyOwnerDestroyed( PropertyOwner& owner ) = 0;
+    virtual void PropertyOwnerDestroyed(PropertyOwner& owner) = 0;
 
   protected:
-
     /**
      * Virtual destructor, no deletion through this interface
      */
-    virtual ~Observer() {}
-
+    virtual ~Observer() = default;
   };
 
   /**
@@ -133,14 +127,19 @@ public:
    * This occurs when the object is disconnected from the scene-graph during UpdateManager::Update().
    * @param[in] currentBufferIndex The current update buffer.
    */
-  void DisconnectFromSceneGraph( BufferIndex updateBufferIndex );
+  void DisconnectFromSceneGraph(BufferIndex updateBufferIndex);
+
+  /**
+   * Reserve the given number of properties
+   */
+  void ReserveProperties(int propertyCount);
 
   /**
    * Install a custom property.
    * @post The PropertyOwner takes ownership of the property.
    * @param[in] property A pointer to a newly allocated property.
    */
-  void InstallCustomProperty( OwnerPointer<PropertyBase>& property );
+  void InstallCustomProperty(OwnerPointer<PropertyBase>& property);
 
   /**
    * Retrieve the custom properties owned by the object.
@@ -160,6 +159,23 @@ public:
     return mCustomProperties;
   }
 
+  /**
+   * Mark an property owner with the updated flag.
+   * @param[in] updated The updated flag
+   */
+  void SetUpdated(bool updated)
+  {
+    mUpdated = updated;
+  }
+
+  /**
+   * Retrieve if the property owner is updated due to the property is being animating.
+   * @return An updated flag
+   */
+  bool Updated() const
+  {
+    return mUpdated;
+  }
 
   // Constraints
 
@@ -167,13 +183,13 @@ public:
    * Apply a constraint.
    * @param[in] constraint The constraint to apply.
    */
-  void ApplyConstraint( OwnerPointer<ConstraintBase>& constraint );
+  void ApplyConstraint(OwnerPointer<ConstraintBase>& constraint);
 
   /**
    * Begin removal of constraints.
    * @param[in] constraint The constraint to remove.
    */
-  void RemoveConstraint( ConstraintBase* constraint );
+  void RemoveConstraint(ConstraintBase* constraint);
 
   /**
    * Retrieve the constraints that are currently applied.
@@ -184,12 +200,12 @@ public:
   /**
    * @copydoc UniformMap::Add
    */
-  virtual void AddUniformMapping( OwnerPointer< UniformPropertyMapping >& map );
+  virtual void AddUniformMapping(const UniformPropertyMapping& map);
 
   /**
    * @copydoc UniformMap::Remove
    */
-  virtual void RemoveUniformMapping( const std::string& uniformName );
+  virtual void RemoveUniformMapping(const ConstString& uniformName);
 
   /**
    * Get the mappings table
@@ -197,25 +213,40 @@ public:
   const UniformMap& GetUniformMap() const;
 
   /**
-   * @copydoc UniformMap::AddUniformMapObserver
+   * Query whether playing an animation is possible or not.
+   * @return true if playing an animation is possible.
    */
-  void AddUniformMapObserver( UniformMap::Observer& observer );
+  virtual bool IsAnimationPossible() const
+  {
+    return true;
+  }
 
   /**
-   * @copydoc UniformMap::RemoveUniformMapObserver
+   * @brief Install custom resetter messages to resetter manager.
+   * @pre ConnectToSceneGraph() Should be called before this API.
+   *
+   * @param[in] manager ResetterManager to add resetter.
    */
-  void RemoveUniformMapObserver( UniformMap::Observer& observer );
-
+  virtual void AddInitializeResetter(ResetterManager& manager) const
+  {
+    // Do nothing
+  }
 
 protected:
-
   /**
    * Protected constructor.
    */
   PropertyOwner();
 
-private:
+  /**
+   * Method to inform derived classes when property maps have been modified.
+   */
+  virtual void OnMappingChanged()
+  {
+    // Default behaviour is to do nothing
+  }
 
+private:
   // Undefined
   PropertyOwner(const PropertyOwner&);
 
@@ -223,15 +254,15 @@ private:
   PropertyOwner& operator=(const PropertyOwner& rhs);
 
 protected:
-
   OwnedPropertyContainer mCustomProperties; ///< Properties provided with InstallCustomProperty()
-  UniformMap mUniformMaps; ///< Container of owned uniform maps
+  UniformMap             mUniformMaps;      ///< Container of owned uniform maps
+  bool                   mUpdated;
+  bool                   mIsConnectedToSceneGraph;
 
 private:
-
-  typedef Dali::Vector<PropertyOwner::Observer*> ObserverContainer;
-  typedef ObserverContainer::Iterator ObserverIter;
-  typedef ObserverContainer::ConstIterator ConstObserverIter;
+  using ObserverContainer = Dali::Vector<PropertyOwner::Observer*>;
+  using ObserverIter      = ObserverContainer::Iterator;
+  using ConstObserverIter = ObserverContainer::ConstIterator;
 
   ObserverContainer mObservers; ///< Container of observer raw-pointers (not owned)