Tizen Native API  5.0

An abstract base class for Constraints. More...

Inheritance diagram for Dali::Constraint:
Dali::BaseHandle

Classes

class  Function
 Template for the Function that is called by the Constraint system. More...

Public Types

enum  RemoveAction
 Enumeration for the action that will happen when the constraint is removed. More...

Public Member Functions

 Constraint ()
 Creates an uninitialized Constraint; this can be initialized with Constraint::New().
Constraint Clone (Handle handle)
 Creates a clone of this constraint for another object.
 ~Constraint ()
 Destructor.
 Constraint (const Constraint &constraint)
 This copy constructor is required for (smart) pointer semantics.
Constraintoperator= (const Constraint &rhs)
 This assignment operator is required for (smart) pointer semantics.
void AddSource (ConstraintSource source)
 Adds a constraint source to the constraint.
void Apply ()
 Applies this constraint.
void Remove ()
 Removes this constraint.
Handle GetTargetObject ()
 Retrieves the object which this constraint is targeting.
Dali::Property::Index GetTargetProperty ()
 Retrieves the property which this constraint is targeting.
void SetRemoveAction (RemoveAction action)
 Sets the remove action. Constraint::Bake will "bake" a value when fully-applied.
RemoveAction GetRemoveAction () const
 Retrieves the remove action that will happen when the constraint is removed.
void SetTag (const uint32_t tag)
 Sets a tag for the constraint so it can be identified later.
uint32_t GetTag () const
 Gets the tag.

Static Public Member Functions

template<class P >
static Constraint New (Handle handle, Property::Index targetIndex, void(*function)(P &, const PropertyInputContainer &))
 Creates a constraint which targets a property using a function or a static class member.
template<class P , class T >
static Constraint New (Handle handle, Property::Index targetIndex, const T &object)
 Creates a constraint which targets a property using a functor object.
template<class P , class T >
static Constraint New (Handle handle, Property::Index targetIndex, const T &object, void(T::*memberFunction)(P &, const PropertyInputContainer &))
 Creates a constraint which targets a property using an object method.
static Constraint DownCast (BaseHandle baseHandle)
 Downcasts a handle to Constraint handle.

Static Public Attributes

static const RemoveAction DEFAULT_REMOVE_ACTION
 Bake.

Detailed Description

An abstract base class for Constraints.

This can be used to constrain a property of an object, after animations have been applied. Constraints are applied in the following order:

  • Constraints are applied to on-stage actors in a depth-first traversal.
  • For each actor, the constraints are applied in the same order as the calls to Apply().
  • Constraints are not applied to off-stage actors.

Create a constraint using one of the New methods depending on the type of callback function used. Try to use a C function unless some data needs to be stored, otherwise functors and class methods are also supported.

A constraint can be applied to an object in the following manner:

 Handle handle = CreateMyObject();
 Constraint constraint = Constraint::New< Vector3 >( handle, CONSTRAINING_PROPERTY_INDEX, &MyFunction );
 constraint.AddSource( LocalSource( INPUT_PROPERTY_INDEX ) );
 constraint.Apply();
Since:
2.4, DALi version 1.0.0

Member Enumeration Documentation

Enumeration for the action that will happen when the constraint is removed.

The final value may be "baked" i.e. saved permanently. Alternatively the constrained value may be discarded when the constraint is removed.

Since:
2.4, DALi version 1.0.0
Enumerator:
Bake 

When the constraint is fully-applied, the constrained value is saved.

Since:
2.4, DALi version 1.0.0
Discard 

When the constraint is removed, the constrained value is discarded.

Since:
2.4, DALi version 1.0.0

Constructor & Destructor Documentation

Creates an uninitialized Constraint; this can be initialized with Constraint::New().

Calling member functions with an uninitialized Constraint handle is not allowed.

Since:
2.4, DALi version 1.0.0

Destructor.

This is non-virtual since derived Handle types must not contain data or virtual methods.

Since:
2.4, DALi version 1.0.0
Dali::Constraint::Constraint ( const Constraint constraint)

This copy constructor is required for (smart) pointer semantics.

Since:
2.4, DALi version 1.0.0
Parameters:
[in]constraintA reference to the copied handle

Member Function Documentation

Adds a constraint source to the constraint.

Since:
2.4, DALi version 1.0.0
Parameters:
[in]sourceThe constraint source input to add

Applies this constraint.

Since:
2.4, DALi version 1.0.0
Precondition:
The constraint must be initialized.
The target object must still be alive.
The source inputs should not have been destroyed.

Creates a clone of this constraint for another object.

Since:
2.4, DALi version 1.0.0
Parameters:
[in]handleThe handle to the property-owning object this constraint is to be cloned for
Returns:
The new constraint
static Constraint Dali::Constraint::DownCast ( BaseHandle  baseHandle) [static]

Downcasts a handle to Constraint handle.

If handle points to a Constraint object, the downcast produces valid handle. If not, the returned handle is left uninitialized.

Since:
2.4, DALi version 1.0.0
Parameters:
[in]baseHandleBaseHandle to an object
Returns:
Handle to a Constraint object or an uninitialized handle

Retrieves the remove action that will happen when the constraint is removed.

Since:
2.4, DALi version 1.0.0
Returns:
The remove-action
uint32_t Dali::Constraint::GetTag ( ) const

Gets the tag.

Since:
2.4, DALi version 1.0.0
Returns:
The tag

Retrieves the object which this constraint is targeting.

Since:
2.4, DALi version 1.0.0
Returns:
The target object

Retrieves the property which this constraint is targeting.

Since:
2.4, DALi version 1.0.0
Returns:
The target property
template<class P >
static Constraint Dali::Constraint::New ( Handle  handle,
Property::Index  targetIndex,
void(*)(P &, const PropertyInputContainer &)  function 
) [static]

Creates a constraint which targets a property using a function or a static class member.

The expected signature, for a Vector3 type for example, of the function is:

   void MyFunction( Vector3&, const PropertyInputContainer& );

Create the constraint with this function as follows:

   Constraint constraint = Constraint::New< Vector3 >( handle, CONSTRAINING_PROPERTY_INDEX, &MyFunction );
Since:
2.4, DALi version 1.0.0
Parameters:
[in]handleThe handle to the property-owning object
[in]targetIndexThe index of the property to constrain
[in]functionThe function to call to set the constrained property value
Template Parameters:
PThe type of the property to constrain
Returns:
The new constraint
template<class P , class T >
static Constraint Dali::Constraint::New ( Handle  handle,
Property::Index  targetIndex,
const T &  object 
) [static]

Creates a constraint which targets a property using a functor object.

The expected structure, for a Vector3 type for example, of the functor object is:

   struct MyObject
   {
     void operator() ( Vector3&, const PropertyInputContainer& );
   };

Create the constraint with this object as follows:

   Constraint constraint = Constraint::New< Vector3 >( handle, CONSTRAINING_PROPERTY_INDEX, MyObject() );
Since:
2.4, DALi version 1.0.0
Parameters:
[in]handleThe handle to the property-owning object
[in]targetIndexThe index of the property to constraint
[in]objectThe functor object whose functor is called to set the constrained property value
Template Parameters:
PThe type of the property to constrain
TThe type of the object
Returns:
The new constraint
template<class P , class T >
static Constraint Dali::Constraint::New ( Handle  handle,
Property::Index  targetIndex,
const T &  object,
void(T::*)(P &, const PropertyInputContainer &)  memberFunction 
) [static]

Creates a constraint which targets a property using an object method.

The expected structure, for a Vector3 type for example, of the object is:

   struct MyObject
   {
     void MyMethod( Vector3&, const PropertyInputContainer& );
   };

Create the constraint with this object as follows:

   Constraint constraint = Constraint::New< Vector3 >( handle, CONSTRAINING_PROPERTY_INDEX, MyObject(), &MyObject::MyMethod );
Since:
2.4, DALi version 1.0.0
Parameters:
[in]handleThe handle to the property-owning object
[in]targetIndexThe index of the property to constraint
[in]objectThe object whose member function is called to set the constrained property value
[in]memberFunctionThe member function to call to set the constrained property value
Returns:
The new constraint
Template Parameters:
PThe type of the property to constrain
TThe type of the object
Constraint& Dali::Constraint::operator= ( const Constraint rhs)

This assignment operator is required for (smart) pointer semantics.

Since:
2.4, DALi version 1.0.0
Parameters:
[in]rhsA reference to the copied handle
Returns:
A reference to this

Removes this constraint.

Since:
2.4, DALi version 1.0.0

Sets the remove action. Constraint::Bake will "bake" a value when fully-applied.

In case of Constraint::Discard, the constrained value will be discarded, when the constraint is removed. The default value is Constraint::Bake.

Since:
2.4, DALi version 1.0.0
Parameters:
[in]actionThe remove-action
void Dali::Constraint::SetTag ( const uint32_t  tag)

Sets a tag for the constraint so it can be identified later.

Since:
2.4, DALi version 1.0.0
Parameters:
[in]tagAn integer to identify the constraint