Cleaning up the property framework; removal of duplicate methods and incorrect assers
[platform/core/uifw/dali-core.git] / dali / internal / event / common / proxy-object.h
index fcc658d..0ae1e31 100644 (file)
 #include <string>
 
 // INTERNAL INCLUDES
-#include <dali/public-api/common/dali-vector.h>
-#include <dali/public-api/common/vector-wrapper.h>
 #include <dali/public-api/animation/active-constraint.h>
-#include <dali/public-api/animation/animation.h>
 #include <dali/public-api/animation/constraint.h>
+#include <dali/public-api/common/dali-vector.h>
+#include <dali/public-api/common/vector-wrapper.h>
 #include <dali/public-api/object/constrainable.h>
+#include <dali/public-api/object/property-index.h>
 #include <dali/public-api/object/property-input.h>
 #include <dali/public-api/object/property-notification.h>
+#include <dali/internal/common/owner-container.h>
 #include <dali/internal/event/common/object-impl.h>
 #include <dali/internal/event/common/custom-property.h>
 #include <dali/internal/event/common/property-input-impl.h>
@@ -47,6 +48,18 @@ class ProxyObject;
 class Constraint;
 class TypeInfo;
 
+/**
+ * @brief Structure for setting up default properties and their details.
+ */
+struct PropertyDetails
+{
+  const char* name;         ///< The name of the property.
+  Property::Type type;      ///< The property type.
+  bool writable:1;          ///< Whether the property is writable
+  bool animatable:1;        ///< Whether the property is animatable.
+  bool constraintInput:1;   ///< Whether the property can be used as an input to a constraint.
+};
+
 namespace SceneGraph
 {
 class PropertyBase;
@@ -107,24 +120,17 @@ public:
   ProxyObject();
 
   /**
-   * Query whether the proxy object removes (& re-adds) its associated scene-object.
-   * Otherwise the scene-object lifetime is expected to match that of the proxy.
-   * @return True if scene-objects are removed.
-   */
-  virtual bool IsSceneObjectRemovable() const = 0;
-
-  /**
    * Add an observer to the proxy.
    * @param[in] observer The observer to add.
    */
-  virtual void AddObserver(Observer& observer);
+  virtual void AddObserver( Observer& observer );
 
   /**
    * Remove an observer from the proxy
    * @pre The observer has already been added.
    * @param[in] observer The observer to remove.
    */
-  virtual void RemoveObserver(Observer& observer);
+  virtual void RemoveObserver( Observer& observer );
 
   /**
    * Retrieve the scene-graph object added by this proxy.
@@ -171,42 +177,42 @@ public: // Property system interface from Internal::Object
   /**
    * @copydoc Dali::Internal::Object::GetPropertyName()
    */
-  virtual const std::string& GetPropertyName( Property::Index index ) const;
+  virtual std::string GetPropertyName( Property::Index index ) const;
 
   /**
    * @copydoc Dali::Internal::Object::GetPropertyIndex()
    */
-  virtual Property::Index GetPropertyIndex(const std::string& name) const;
+  virtual Property::Index GetPropertyIndex( const std::string& name ) const;
 
   /**
    * @copydoc Dali::Internal::Object::IsPropertyWritable()
    */
-  virtual bool IsPropertyWritable(Property::Index index) const;
+  virtual bool IsPropertyWritable( Property::Index index ) const;
 
   /**
    * @copydoc Dali::Internal::Object::IsPropertyAnimatable()
    */
-  virtual bool IsPropertyAnimatable(Property::Index index) const;
+  virtual bool IsPropertyAnimatable( Property::Index index ) const;
 
   /**
    * @copydoc Dali::Internal::Object::IsPropertyAConstraintInput()
    */
-  virtual bool IsPropertyAConstraintInput(Property::Index index) const;
+  virtual bool IsPropertyAConstraintInput( Property::Index index ) const;
 
   /**
    * @copydoc Dali::Internal::Object::GetPropertyType()
    */
-  virtual Property::Type GetPropertyType(Property::Index index) const;
+  virtual Property::Type GetPropertyType( Property::Index index ) const;
 
   /**
    * @copydoc Dali::Internal::Object::SetProperty()
    */
-  virtual void SetProperty(Property::Index index, const Property::Value& propertyValue);
+  virtual void SetProperty( Property::Index index, const Property::Value& propertyValue );
 
   /**
    * @copydoc Dali::Internal::Object::GetProperty()
    */
-  virtual Property::Value GetProperty(Property::Index index) const;
+  virtual Property::Value GetProperty( Property::Index index ) const;
 
   /**
    * @copydoc Dali::Handle::GetPropertyIndices()
@@ -216,31 +222,32 @@ public: // Property system interface from Internal::Object
   /**
    * @copydoc Dali::Internal::Object::RegisterProperty()
    */
-  virtual Property::Index RegisterProperty(std::string name, const Property::Value& propertyValue);
+  virtual Property::Index RegisterProperty( const std::string& name, const Property::Value& propertyValue );
 
   /**
-   * @copydoc Dali::Handle::RegisterProperty(std::string name, Property::Value propertyValue, Property::AccessMode accessMode)
+   * @copydoc Dali::Internal::Object::RegisterProperty(std::string name, Property::Value propertyValue, Property::AccessMode accessMode)
    */
-  virtual Property::Index RegisterProperty(std::string name, const Property::Value& propertyValue, Property::AccessMode accessMode);
+  virtual Property::Index RegisterProperty( const std::string& name, const Property::Value& propertyValue, Property::AccessMode accessMode );
 
   /**
-   * @copydoc Dali::Handle::AddPropertyNotification()
+   * @copydoc Dali::Internal::Object::AddPropertyNotification()
    */
-  virtual Dali::PropertyNotification AddPropertyNotification(Property::Index index,
-                                                             int componentIndex,
-                                                             const Dali::PropertyCondition& condition);
+  virtual Dali::PropertyNotification AddPropertyNotification( Property::Index index,
+                                                              int componentIndex,
+                                                              const Dali::PropertyCondition& condition );
 
   /**
-   * @copydoc Dali::Handle::RemovePropertyNotification()
+   * @copydoc Dali::Internal::Object::RemovePropertyNotification()
    */
-  virtual void RemovePropertyNotification(Dali::PropertyNotification propertyNotification);
+  virtual void RemovePropertyNotification( Dali::PropertyNotification propertyNotification );
 
   /**
-   * @copydoc Dali::Handle::RemovePropertyNotifications()
+   * @copydoc Dali::Internal::Object::RemovePropertyNotifications()
    */
   void RemovePropertyNotifications();
 
 private:
+
   /**
    * Enable property notifications in scene graph
    */
@@ -282,7 +289,7 @@ public: // Constraints
    */
   void RemoveConstraints( unsigned int tag );
 
-public: // Called by TypeInfo
+public:
 
   /**
    * Called by TypeInfo to set the type-info that this proxy-object is created by.
@@ -290,6 +297,14 @@ public: // Called by TypeInfo
    */
   void SetTypeInfo( const TypeInfo* typeInfo );
 
+  /**
+   * @return the index from which custom properties start
+   */
+  unsigned int CustomPropertyStartIndex()
+  {
+    return PROPERTY_CUSTOM_START_INDEX;
+  }
+
 protected:
 
   /**
@@ -310,10 +325,10 @@ protected:
 private:
 
   // Undefined
-  ProxyObject(const ProxyObject&);
+  ProxyObject( const ProxyObject& );
 
   // Undefined
-  ProxyObject& operator=(const ProxyObject& rhs);
+  ProxyObject& operator=( const ProxyObject& rhs );
 
   /**
    * Helper for ApplyConstraint overloads.
@@ -328,6 +343,13 @@ private:
    */
   void RemoveConstraint( ActiveConstraint& constraint, bool isInScenegraph );
 
+  /**
+   * Set the value of scene graph property.
+   * @param [in] index The index of the property.
+   * @param [in] entry An entry from the CustomPropertyLookup.
+   * @param [in] value The new value of the property.
+   */
+  virtual void SetSceneGraphProperty( Property::Index index, const CustomProperty& entry, const Property::Value& value );
 
 private: // Default property extensions for derived classes
 
@@ -348,7 +370,7 @@ private: // Default property extensions for derived classes
    * Query how many default properties the derived class supports.
    * @return The number of default properties.
    */
-  virtual const std::string& GetDefaultPropertyName( Property::Index index ) const = 0;
+  virtual const char* GetDefaultPropertyName( Property::Index index ) const = 0;
 
   /**
    * Query the index of a default property.
@@ -396,14 +418,6 @@ private: // Default property extensions for derived classes
   virtual void SetDefaultProperty( Property::Index index, const Property::Value& propertyValue ) = 0;
 
   /**
-   * Set the value of custom property.
-   * @param [in] index The index of the property.
-   * @param [in] entry An entry from the CustomPropertyLookup.
-   * @param [in] value The new value of the property.
-   */
-  virtual void SetCustomProperty( Property::Index index, const CustomProperty& entry, const Property::Value& value );
-
-  /**
    * Retrieve a default property value.
    * @param [in] index The index of the property.
    * @return The property value.
@@ -411,21 +425,35 @@ private: // Default property extensions for derived classes
   virtual Property::Value GetDefaultProperty( Property::Index index ) const = 0;
 
   /**
-   * Install a newly allocated scene-object property.
-   * The derived class is responsible for this, since the type of scene-object is not known to this base class.
-   * @param [in] newProperty A newly allocated scene-object property.
+   * @todo this is virtual so that for now actor can override it,
+   * it needs to be removed and only have GetSceneObject but that requires changing actor and constraint logic
+   * Retrieve the scene-graph object added by this proxy.
+   * @return A pointer to the object, or NULL if no object has been added to the scene-graph.
+   */
+  virtual const SceneGraph::PropertyOwner* GetPropertyOwner() const
+  {
+    return GetSceneObject();
+  }
+
+  /**
+   * Notify derived class of installation of a new scene-object property.
+   * This method is called after the message is to sent to install the property
+   * @param [in] newProperty A newly allocated scene-object property. Ownership is obviously not passed.
    * @param [in] name The name allocated to this custom property.
    * @param [in] index The index allocated to this custom property.
    */
-  virtual void InstallSceneObjectProperty( SceneGraph::PropertyBase& newProperty, const std::string& name, unsigned int index ) = 0;
+  virtual void NotifyScenePropertyInstalled( const SceneGraph::PropertyBase& newProperty, const std::string& name, unsigned int index )
+  { }
 
 protected:
 
   /**
-   * Not all proxy objects will have custom properties so we want to only create the lookup when its actually needed
-   * @return the custom property lookup
+   * For use in derived classes.
+   * This is called after a non animatable custom property is set.
+   * @param [in] index The index of the property.
+   * @param [in] propertyValue The value of the property.
    */
-  CustomPropertyLookup& GetCustomPropertyLookup() const;
+  virtual void OnPropertySet( Property::Index index, Property::Value propertyValue ) {}
 
   /**
    * Retrieves the TypeInfo for this object. Only retrieves it from the type-registry once and then stores a pointer
@@ -434,11 +462,17 @@ protected:
    */
   const TypeInfo* GetTypeInfo() const;
 
-private:
+  /**
+   * Helper to find custom property
+   * @param index
+   * @return pointer to the property
+   */
+  CustomProperty* FindCustomProperty( Property::Index index ) const;
 
-  Property::Index mNextCustomPropertyIndex; ///< The ID of the next custom property to be registered
+private:
 
-  mutable CustomPropertyLookup* mCustomProperties; ///< Used for accessing custom Node properties, mutable so it can be lazy initialized from const function
+  typedef OwnerContainer<CustomProperty*> CustomPropertyLookup;
+  CustomPropertyLookup mCustomProperties; ///< Used for accessing custom Node properties
   mutable TypeInfo const *  mTypeInfo; ///< The type-info for this object, mutable so it can be lazy initialized from const method if it is required
 
   Dali::Vector<Observer*> mObservers;