dali/internal/event/animation/constraint-impl.h

   1 #ifndef __DALI_INTERNAL_CONSTRAINT_H__
   2 #define __DALI_INTERNAL_CONSTRAINT_H__
   3
   4 /*
   5  * Copyright (c) 2014 Samsung Electronics Co., Ltd.
   6  *
   7  * Licensed under the Apache License, Version 2.0 (the "License");
   8  * you may not use this file except in compliance with the License.
   9  * You may obtain a copy of the License at
  10  *
  11  * http://www.apache.org/licenses/LICENSE-2.0
  12  *
  13  * Unless required by applicable law or agreed to in writing, software
  14  * distributed under the License is distributed on an "AS IS" BASIS,
  15  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  16  * See the License for the specific language governing permissions and
  17  * limitations under the License.
  18  *
  19  */
  20
  21 // INTERNAL INCLUDES
  22 #include <dali/public-api/animation/active-constraint.h>
  23 #include <dali/public-api/animation/alpha-functions.h>
  24 #include <dali/public-api/animation/constraint.h>
  25 #include <dali/public-api/animation/time-period.h>
  26 #include <dali/public-api/object/base-object.h>
  27 #include <dali/internal/event/animation/constraint-source-impl.h>
  28
  29 namespace Dali
  30 {
  31
  32 namespace Internal
  33 {
  34
  35 class ActiveConstraintBase;
  36 class Object;
  37
  38 /**
  39  * Constraints are used to constrain a property of an object, after animations have been applied.
  40  */
  41 class Constraint : public BaseObject
  42 {
  43 public:
  44
  45   typedef Any AnyFunction;
  46
  47   /**
  48    * Construct a new constraint which targets a property.
  49    * @param [in] target The index of the property to constrain.
  50    * @param [in] targetType The type of the constrained property.
  51    * @param [in] sources The objects which provide parameters for func.
  52    * @param [in] func The constraint function.
  53    * @param [in] interpolator A function used to interpolate between the start value, and the value returned by func.
  54    */
  55   Constraint( Property::Index target,
  56               Property::Type targetType,
  57               SourceContainer& sources,
  58               AnyFunction& func,
  59               AnyFunction& interpolator );
  60
  61   /**
  62    * @copydoc Dali::Constraint::SetApplyTime()
  63    */
  64   void SetApplyTime( TimePeriod timePeriod );
  65
  66   /**
  67    * @copydoc Dali::Constraint::GetApplyTime()
  68    */
  69   TimePeriod GetApplyTime() const;
  70
  71   /**
  72    * @copydoc Dali::Constraint::SetAlphaFunction( AlphaFunction func )
  73    */
  74   void SetAlphaFunction( AlphaFunction func );
  75
  76   /**
  77    * @copydoc Dali::Constraint::GetAlphaFunction()
  78    */
  79   AlphaFunction GetAlphaFunction() const;
  80
  81   /**
  82    * @copydoc Dali::Constraint::SetRemoveAction()
  83    */
  84   void SetRemoveAction(Dali::Constraint::RemoveAction action);
  85
  86   /**
  87    * @copydoc Dali::Constraint::GetRemoveAction()
  88    */
  89   Dali::Constraint::RemoveAction GetRemoveAction() const;
  90
  91   /**
  92    * @copydoc Dali::Constraint::SetTag()
  93    */
  94   void SetTag( const unsigned int tag);
  95
  96   /**
  97    * @copydoc Dali::Constraint::GetTag()
  98    */
  99   unsigned int GetTag() const;
 100
 101
 102
 103
 104   /**
 105    * Create an active constraint.
 106    * An active constraint is created each time the constraint is applied to an object.
 107    * @return A newly allocated active-constraint.
 108    */
 109   ActiveConstraintBase* CreateActiveConstraint();
 110
 111 protected:
 112
 113   /**
 114    * A reference counted object may only be deleted by calling Unreference()
 115    */
 116   virtual ~Constraint();
 117
 118 private:
 119
 120   // Undefined
 121   Constraint(const Constraint&);
 122
 123   // Undefined
 124   Constraint& operator=(const Constraint& rhs);
 125
 126 protected:
 127
 128   Dali::ActiveConstraint mActiveConstraintTemplate; ///< Used to create active constraints
 129
 130   TimePeriod mApplyTime;
 131 };
 132
 133 } // namespace Internal
 134
 135 // Helpers for public-api forwarding methods
 136
 137 inline Internal::Constraint& GetImplementation(Dali::Constraint& constraint)
 138 {
 139   DALI_ASSERT_ALWAYS( constraint && "Constraint handle is empty" );
 140
 141   BaseObject& handle = constraint.GetBaseObject();
 142
 143   return static_cast<Internal::Constraint&>(handle);
 144 }
 145
 146 inline const Internal::Constraint& GetImplementation(const Dali::Constraint& constraint)
 147 {
 148   DALI_ASSERT_ALWAYS( constraint && "Constraint handle is empty" );
 149
 150   const BaseObject& handle = constraint.GetBaseObject();
 151
 152   return static_cast<const Internal::Constraint&>(handle);
 153 }
 154
 155 } // namespace Dali
 156
 157 #endif // __DALI_INTERNAL_CONSTRAINT_H__