1 #ifndef __DALI_INTERNAL_SCENE_GRAPH_ANIMATOR_H__
2 #define __DALI_INTERNAL_SCENE_GRAPH_ANIMATOR_H__
5 * Copyright (c) 2014 Samsung Electronics Co., Ltd.
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
11 * http://www.apache.org/licenses/LICENSE-2.0
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.
22 #include <dali/internal/common/owner-container.h>
23 #include <dali/internal/event/animation/key-frames-impl.h>
24 #include <dali/internal/event/animation/path-impl.h>
25 #include <dali/internal/update/nodes/node.h>
26 #include <dali/internal/update/common/property-base.h>
27 #include <dali/public-api/animation/alpha-function.h>
28 #include <dali/public-api/animation/animation.h>
29 #include <dali/public-api/animation/time-period.h>
30 #include <dali/public-api/common/constants.h>
31 #include <dali/public-api/common/dali-common.h>
32 #include <dali/public-api/math/quaternion.h>
33 #include <dali/public-api/math/radian.h>
41 typedef Dali::Animation::Interpolation Interpolation;
43 struct AnimatorFunctionBase;
50 typedef OwnerContainer< AnimatorBase* > AnimatorContainer;
52 typedef AnimatorContainer::Iterator AnimatorIter;
53 typedef AnimatorContainer::ConstIterator AnimatorConstIter;
56 * An abstract base class for Animators, which can be added to scene graph animations.
57 * Each animator changes a single property of an object in the scene graph.
63 typedef float (*AlphaFunc)(float progress); ///< Definition of an alpha function
69 : mDurationSeconds(1.0f),
70 mInitialDelaySeconds(0.0f),
71 mAlphaFunction(AlphaFunction::DEFAULT),
72 mDisconnectAction(Dali::Animation::BakeFinal),
81 virtual ~AnimatorBase()
86 * Set the duration of the animator.
87 * @pre durationSeconds must be zero or greater; zero is useful when animating boolean values.
88 * @param [in] seconds Duration in seconds.
90 void SetDuration(float seconds)
92 DALI_ASSERT_DEBUG(seconds >= 0.0f);
94 mDurationSeconds = seconds;
98 * Retrieve the duration of the animator.
99 * @return The duration in seconds.
103 return mDurationSeconds;
107 * Set the delay before the animator should take effect.
108 * The default is zero i.e. no delay.
109 * @param [in] seconds The delay in seconds.
111 void SetInitialDelay(float seconds)
113 mInitialDelaySeconds = seconds;
117 * Retrieve the initial delay of the animator.
118 * @return The delay in seconds.
120 float GetInitialDelay()
122 return mInitialDelaySeconds;
126 * Set the alpha function for an animator.
127 * @param [in] alphaFunc The alpha function to apply to the animation progress.
129 void SetAlphaFunction(const AlphaFunction& alphaFunction)
131 mAlphaFunction = alphaFunction;
135 * Retrieve the alpha function of an animator.
136 * @return The function.
138 AlphaFunction GetAlphaFunction() const
140 return mAlphaFunction;
144 * Applies the alpha function to the specified progress
145 * @param[in] Current progress
146 * @return The progress after the alpha function has been aplied
148 float ApplyAlphaFunction( float progress ) const
150 float result = progress;
152 AlphaFunction::Mode alphaFunctionMode( mAlphaFunction.GetMode() );
153 if( alphaFunctionMode == AlphaFunction::BUILTIN_FUNCTION )
155 switch(mAlphaFunction.GetBuiltinFunction())
157 case AlphaFunction::DEFAULT:
158 case AlphaFunction::LINEAR:
162 case AlphaFunction::REVERSE:
164 result = 1.0f-progress;
167 case AlphaFunction::EASE_IN_SQUARE:
169 result = progress * progress;
172 case AlphaFunction::EASE_OUT_SQUARE:
174 result = 1.0f - (1.0f-progress) * (1.0f-progress);
177 case AlphaFunction::EASE_IN:
179 result = progress * progress * progress;
182 case AlphaFunction::EASE_OUT:
184 result = (progress-1.0f) * (progress-1.0f) * (progress-1.0f) + 1.0f;
187 case AlphaFunction::EASE_IN_OUT:
189 result = progress*progress*(3.0f-2.0f*progress);
192 case AlphaFunction::EASE_IN_SINE:
194 result = -1.0f * cosf(progress * Math::PI_2) + 1.0f;
197 case AlphaFunction::EASE_OUT_SINE:
199 result = sinf(progress * Math::PI_2);
202 case AlphaFunction::EASE_IN_OUT_SINE:
204 result = -0.5f * (cosf(Math::PI * progress) - 1.0f);
207 case AlphaFunction::BOUNCE:
209 result = sinf(progress * Math::PI);
212 case AlphaFunction::SIN:
214 result = 0.5f - cosf(progress * 2.0f * Math::PI) * 0.5f;
217 case AlphaFunction::EASE_OUT_BACK:
219 const float sqrt2 = 1.70158f;
221 result = 1.0f + progress * progress * ( ( sqrt2 + 1.0f ) * progress + sqrt2 );
228 else if( alphaFunctionMode == AlphaFunction::CUSTOM_FUNCTION )
230 AlphaFunctionPrototype customFunction = mAlphaFunction.GetCustomFunction();
233 result = customFunction(progress);
238 //If progress is very close to 0 or very close to 1 we don't need to evaluate the curve as the result will
239 //be almost 0 or almost 1 respectively
240 if( ( progress > Math::MACHINE_EPSILON_1 ) && ((1.0f - progress) > Math::MACHINE_EPSILON_1) )
242 Dali::Vector4 controlPoints = mAlphaFunction.GetBezierControlPoints();
244 static const float tolerance = 0.001f; //10 iteration max
246 //Perform a binary search on the curve
247 float lowerBound(0.0f);
248 float upperBound(1.0f);
249 float currentT(0.5f);
250 float currentX = EvaluateCubicBezier( controlPoints.x, controlPoints.z, currentT);
251 while( fabs( progress - currentX ) > tolerance )
253 if( progress > currentX )
255 lowerBound = currentT;
259 upperBound = currentT;
261 currentT = (upperBound+lowerBound)*0.5f;
262 currentX = EvaluateCubicBezier( controlPoints.x, controlPoints.z, currentT);
264 result = EvaluateCubicBezier( controlPoints.y, controlPoints.w, currentT);
272 * Whether to bake the animation if attached property owner is disconnected.
273 * Property is only baked if the animator is active.
274 * @param [in] action The disconnect action.
276 void SetDisconnectAction( Dali::Animation::EndAction action )
278 mDisconnectAction = action;
282 * Retrieve the disconnect action of an animator.
283 * @return The disconnect action.
285 Dali::Animation::EndAction GetDisconnectAction() const
287 return mDisconnectAction;
291 * Whether the animator is active or not.
292 * @param [in] active The new active state.
293 * @post When the animator becomes active, it applies the disconnect-action if the property owner is then disconnected.
294 * @note When the property owner is disconnected, the active state is set to false.
296 void SetActive( bool active )
302 * Retrieve whether the animator has been set to active or not.
303 * @return The active state.
305 bool GetActive() const
311 * Retrive wheter the animator's target object is valid and on the stage.
312 * @return The enabled state.
314 bool IsEnabled() const
319 * Returns wheter the target object of the animator is still valid
320 * or has been destroyed.
321 * @return True if animator is orphan, false otherwise *
322 * @note The SceneGraph::Animation will delete any orphan animator in its Update method.
324 virtual bool Orphan() = 0;
327 * Update the scene object attached to the animator.
328 * @param[in] bufferIndex The buffer to animate.
329 * @param[in] progress A value from 0 to 1, where 0 is the start of the animation, and 1 is the end point.
330 * @param[in] bake Bake.
332 virtual void Update(BufferIndex bufferIndex, float progress, bool bake) = 0;
337 * Helper function to evaluate a cubic bezier curve assuming first point is at 0.0 and last point is at 1.0
338 * @param[in] p0 First control point of the bezier curve
339 * @param[in] p1 Second control point of the bezier curve
340 * @param[in] t A floating point value between 0.0 and 1.0
341 * @return Value of the curve at progress t
343 inline float EvaluateCubicBezier( float p0, float p1, float t ) const
346 return 3.0f*(1.0f-t)*(1.0f-t)*t*p0 + 3.0f*(1.0f-t)*tSquare*p1 + tSquare*t;
349 float mDurationSeconds;
350 float mInitialDelaySeconds;
352 AlphaFunction mAlphaFunction;
354 Dali::Animation::EndAction mDisconnectAction; ///< EndAction to apply when target object gets disconnected from the stage.
355 bool mActive:1; ///< Animator is "active" while it's running.
356 bool mEnabled:1; ///< Animator is "enabled" while its target object is valid and on the stage.
360 * An animator for a specific property type PropertyType.
362 template < typename PropertyType, typename PropertyAccessorType >
363 class Animator : public AnimatorBase, public PropertyOwner::Observer
368 * Construct a new property animator.
369 * @param[in] property The animatable property; only valid while the Animator is attached.
370 * @param[in] animatorFunction The function used to animate the property.
371 * @param[in] alphaFunction The alpha function to apply.
372 * @param[in] timePeriod The time period of this animation.
373 * @return A newly allocated animator.
375 static AnimatorBase* New( const PropertyOwner& propertyOwner,
376 const PropertyBase& property,
377 AnimatorFunctionBase* animatorFunction,
378 AlphaFunction alphaFunction,
379 const TimePeriod& timePeriod )
381 typedef Animator< PropertyType, PropertyAccessorType > AnimatorType;
383 // The property was const in the actor-thread, but animators are used in the scene-graph thread.
384 AnimatorType* animator = new AnimatorType( const_cast<PropertyOwner*>( &propertyOwner ),
385 const_cast<PropertyBase*>( &property ),
388 animator->SetAlphaFunction( alphaFunction );
389 animator->SetInitialDelay( timePeriod.delaySeconds );
390 animator->SetDuration( timePeriod.durationSeconds );
396 * Virtual destructor.
402 mPropertyOwner->RemoveObserver(*this);
405 if( mAnimatorFunction )
407 delete mAnimatorFunction;
412 * Called when mPropertyOwner is connected to the scene graph.
414 virtual void PropertyOwnerConnected( PropertyOwner& owner )
420 * Called when mPropertyOwner is disconnected from the scene graph.
422 virtual void PropertyOwnerDisconnected( BufferIndex bufferIndex, PropertyOwner& owner )
424 // If we are active, then bake the value if required
425 if ( mActive && mDisconnectAction != Dali::Animation::Discard )
427 // Bake to target-value if BakeFinal, otherwise bake current value
428 Update( bufferIndex, ( mDisconnectAction == Dali::Animation::Bake ? mCurrentProgress : 1.0f ), true );
436 * Called shortly before mPropertyOwner is destroyed
438 virtual void PropertyOwnerDestroyed( PropertyOwner& owner )
440 mPropertyOwner = NULL;
441 mPropertyAccessor.Reset();
448 virtual void Update( BufferIndex bufferIndex, float progress, bool bake )
450 float alpha = ApplyAlphaFunction(progress);
452 const PropertyType& current = mPropertyAccessor.Get( bufferIndex );
454 const PropertyType result = (*mAnimatorFunction)( alpha, current );
457 mPropertyAccessor.Bake( bufferIndex, result );
461 mPropertyAccessor.Set( bufferIndex, result );
464 mCurrentProgress = progress;
470 virtual bool Orphan()
472 return (mPropertyOwner == NULL);
478 * Private constructor; see also Animator::New().
480 Animator( PropertyOwner* propertyOwner,
481 PropertyBase* property,
482 AnimatorFunctionBase* animatorFunction )
483 : mPropertyOwner( propertyOwner ),
484 mPropertyAccessor( property ),
485 mAnimatorFunction( animatorFunction ),
486 mCurrentProgress( 0.0f )
488 mPropertyOwner->AddObserver(*this);
492 Animator( const Animator& );
495 Animator& operator=( const Animator& );
499 PropertyOwner* mPropertyOwner;
500 PropertyAccessorType mPropertyAccessor;
502 AnimatorFunctionBase* mAnimatorFunction;
503 float mCurrentProgress;
506 } // namespace SceneGraph
509 * AnimatorFunction base class.
510 * All update functions must inherit from AnimatorFunctionBase and overload the appropiate "()" operator
512 struct AnimatorFunctionBase
517 AnimatorFunctionBase(){}
520 * Virtual destructor (Intended as base class)
522 virtual ~AnimatorFunctionBase(){}
524 ///Stub "()" operators.
525 virtual bool operator()(float progress, const bool& property)
530 virtual float operator()(float progress, const int& property)
535 virtual float operator()(float progress, const unsigned int& property)
540 virtual float operator()(float progress, const float& property)
545 virtual Vector2 operator()(float progress, const Vector2& property)
550 virtual Vector3 operator()(float progress, const Vector3& property)
555 virtual Vector4 operator()(float progress, const Vector4& property)
560 virtual Quaternion operator()(float progress, const Quaternion& property)
568 struct AnimateByInteger : public AnimatorFunctionBase
570 AnimateByInteger(const int& relativeValue)
571 : mRelative(relativeValue)
575 float operator()(float alpha, const int& property)
577 return int(property + mRelative * alpha + 0.5f );
583 struct AnimateToInteger : public AnimatorFunctionBase
585 AnimateToInteger(const int& targetValue)
586 : mTarget(targetValue)
590 float operator()(float alpha, const int& property)
592 return int(property + ((mTarget - property) * alpha) + 0.5f);
598 struct AnimateByUnsignedInteger : public AnimatorFunctionBase
600 AnimateByUnsignedInteger(const unsigned int& relativeValue)
601 : mRelative(relativeValue)
605 float operator()(float alpha, const unsigned int& property)
607 return static_cast<unsigned int>(property + mRelative * alpha + 0.5f );
610 unsigned int mRelative;
613 struct AnimateToUnsignedInteger : public AnimatorFunctionBase
615 AnimateToUnsignedInteger(const unsigned int& targetValue)
616 : mTarget(targetValue)
620 float operator()(float alpha, const unsigned int& property)
622 return static_cast<unsigned int>(property + ((mTarget - property) * alpha) + 0.5f);
625 unsigned int mTarget;
628 struct AnimateByFloat : public AnimatorFunctionBase
630 AnimateByFloat(const float& relativeValue)
631 : mRelative(relativeValue)
635 float operator()(float alpha, const float& property)
637 return float(property + mRelative * alpha);
643 struct AnimateToFloat : public AnimatorFunctionBase
645 AnimateToFloat(const float& targetValue)
646 : mTarget(targetValue)
650 float operator()(float alpha, const float& property)
652 return float(property + ((mTarget - property) * alpha));
658 struct AnimateByVector2 : public AnimatorFunctionBase
660 AnimateByVector2(const Vector2& relativeValue)
661 : mRelative(relativeValue)
665 Vector2 operator()(float alpha, const Vector2& property)
667 return Vector2(property + mRelative * alpha);
673 struct AnimateToVector2 : public AnimatorFunctionBase
675 AnimateToVector2(const Vector2& targetValue)
676 : mTarget(targetValue)
680 Vector2 operator()(float alpha, const Vector2& property)
682 return Vector2(property + ((mTarget - property) * alpha));
688 struct AnimateByVector3 : public AnimatorFunctionBase
690 AnimateByVector3(const Vector3& relativeValue)
691 : mRelative(relativeValue)
695 Vector3 operator()(float alpha, const Vector3& property)
697 return Vector3(property + mRelative * alpha);
703 struct AnimateToVector3 : public AnimatorFunctionBase
705 AnimateToVector3(const Vector3& targetValue)
706 : mTarget(targetValue)
710 Vector3 operator()(float alpha, const Vector3& property)
712 return Vector3(property + ((mTarget - property) * alpha));
718 struct AnimateByVector4 : public AnimatorFunctionBase
720 AnimateByVector4(const Vector4& relativeValue)
721 : mRelative(relativeValue)
725 Vector4 operator()(float alpha, const Vector4& property)
727 return Vector4(property + mRelative * alpha);
733 struct AnimateToVector4 : public AnimatorFunctionBase
735 AnimateToVector4(const Vector4& targetValue)
736 : mTarget(targetValue)
740 Vector4 operator()(float alpha, const Vector4& property)
742 return Vector4(property + ((mTarget - property) * alpha));
748 struct AnimateByOpacity : public AnimatorFunctionBase
750 AnimateByOpacity(const float& relativeValue)
751 : mRelative(relativeValue)
755 Vector4 operator()(float alpha, const Vector4& property)
757 Vector4 result(property);
758 result.a += mRelative * alpha;
766 struct AnimateToOpacity : public AnimatorFunctionBase
768 AnimateToOpacity(const float& targetValue)
769 : mTarget(targetValue)
773 Vector4 operator()(float alpha, const Vector4& property)
775 Vector4 result(property);
776 result.a = property.a + ((mTarget - property.a) * alpha);
784 struct AnimateByBoolean : public AnimatorFunctionBase
786 AnimateByBoolean(bool relativeValue)
787 : mRelative(relativeValue)
791 bool operator()(float alpha, const bool& property)
793 // Alpha is not useful here, just keeping to the same template as other update functors
794 return bool(alpha >= 1.0f ? (property || mRelative) : property);
800 struct AnimateToBoolean : public AnimatorFunctionBase
802 AnimateToBoolean(bool targetValue)
803 : mTarget(targetValue)
807 bool operator()(float alpha, const bool& property)
809 // Alpha is not useful here, just keeping to the same template as other update functors
810 return bool(alpha >= 1.0f ? mTarget : property);
816 struct RotateByAngleAxis : public AnimatorFunctionBase
818 RotateByAngleAxis(const Radian& angleRadians, const Vector3& axis)
819 : mAngleRadians( angleRadians ),
820 mAxis(axis.x, axis.y, axis.z)
824 Quaternion operator()(float alpha, const Quaternion& rotation)
828 return rotation * Quaternion(mAngleRadians * alpha, mAxis);
834 Radian mAngleRadians;
838 struct RotateToQuaternion : public AnimatorFunctionBase
840 RotateToQuaternion(const Quaternion& targetValue)
841 : mTarget(targetValue)
845 Quaternion operator()(float alpha, const Quaternion& rotation)
847 return Quaternion::Slerp(rotation, mTarget, alpha);
854 struct KeyFrameBooleanFunctor : public AnimatorFunctionBase
856 KeyFrameBooleanFunctor(KeyFrameBooleanPtr keyFrames)
857 : mKeyFrames(keyFrames)
861 bool operator()(float progress, const bool& property)
863 if(mKeyFrames->IsActive(progress))
865 return mKeyFrames->GetValue(progress, Dali::Animation::Linear);
870 KeyFrameBooleanPtr mKeyFrames;
873 struct KeyFrameIntegerFunctor : public AnimatorFunctionBase
875 KeyFrameIntegerFunctor(KeyFrameIntegerPtr keyFrames, Interpolation interpolation)
876 : mKeyFrames(keyFrames),mInterpolation(interpolation)
880 float operator()(float progress, const int& property)
882 if(mKeyFrames->IsActive(progress))
884 return mKeyFrames->GetValue(progress, mInterpolation);
889 KeyFrameIntegerPtr mKeyFrames;
890 Interpolation mInterpolation;
893 struct KeyFrameUnsignedIntegerFunctor : public AnimatorFunctionBase
895 KeyFrameUnsignedIntegerFunctor(KeyFrameUnsignedIntegerPtr keyFrames, Interpolation interpolation)
896 : mKeyFrames(keyFrames),mInterpolation(interpolation)
900 float operator()(float progress, const unsigned int& property)
902 if(mKeyFrames->IsActive(progress))
904 return mKeyFrames->GetValue(progress, mInterpolation);
909 KeyFrameUnsignedIntegerPtr mKeyFrames;
910 Interpolation mInterpolation;
913 struct KeyFrameNumberFunctor : public AnimatorFunctionBase
915 KeyFrameNumberFunctor(KeyFrameNumberPtr keyFrames, Interpolation interpolation)
916 : mKeyFrames(keyFrames),mInterpolation(interpolation)
920 float operator()(float progress, const float& property)
922 if(mKeyFrames->IsActive(progress))
924 return mKeyFrames->GetValue(progress, mInterpolation);
929 KeyFrameNumberPtr mKeyFrames;
930 Interpolation mInterpolation;
933 struct KeyFrameVector2Functor : public AnimatorFunctionBase
935 KeyFrameVector2Functor(KeyFrameVector2Ptr keyFrames, Interpolation interpolation)
936 : mKeyFrames(keyFrames),mInterpolation(interpolation)
940 Vector2 operator()(float progress, const Vector2& property)
942 if(mKeyFrames->IsActive(progress))
944 return mKeyFrames->GetValue(progress, mInterpolation);
949 KeyFrameVector2Ptr mKeyFrames;
950 Interpolation mInterpolation;
954 struct KeyFrameVector3Functor : public AnimatorFunctionBase
956 KeyFrameVector3Functor(KeyFrameVector3Ptr keyFrames, Interpolation interpolation)
957 : mKeyFrames(keyFrames),mInterpolation(interpolation)
961 Vector3 operator()(float progress, const Vector3& property)
963 if(mKeyFrames->IsActive(progress))
965 return mKeyFrames->GetValue(progress, mInterpolation);
970 KeyFrameVector3Ptr mKeyFrames;
971 Interpolation mInterpolation;
974 struct KeyFrameVector4Functor : public AnimatorFunctionBase
976 KeyFrameVector4Functor(KeyFrameVector4Ptr keyFrames, Interpolation interpolation)
977 : mKeyFrames(keyFrames),mInterpolation(interpolation)
981 Vector4 operator()(float progress, const Vector4& property)
983 if(mKeyFrames->IsActive(progress))
985 return mKeyFrames->GetValue(progress, mInterpolation);
990 KeyFrameVector4Ptr mKeyFrames;
991 Interpolation mInterpolation;
994 struct KeyFrameQuaternionFunctor : public AnimatorFunctionBase
996 KeyFrameQuaternionFunctor(KeyFrameQuaternionPtr keyFrames)
997 : mKeyFrames(keyFrames)
1001 Quaternion operator()(float progress, const Quaternion& property)
1003 if(mKeyFrames->IsActive(progress))
1005 return mKeyFrames->GetValue(progress, Dali::Animation::Linear);
1010 KeyFrameQuaternionPtr mKeyFrames;
1013 struct PathPositionFunctor : public AnimatorFunctionBase
1015 PathPositionFunctor( PathPtr path )
1020 Vector3 operator()(float progress, const Vector3& property)
1022 return mPath->SamplePosition(progress );
1028 struct PathRotationFunctor : public AnimatorFunctionBase
1030 PathRotationFunctor( PathPtr path, const Vector3& forward )
1034 mForward.Normalize();
1037 Quaternion operator()(float progress, const Quaternion& property)
1039 Vector3 tangent( mPath->SampleTangent(progress) );
1040 return Quaternion( mForward, tangent );
1048 } // namespace Internal
1052 #endif // __DALI_INTERNAL_SCENE_GRAPH_ANIMATOR_H__