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 AnimateByFloat : public AnimatorFunctionBase
600 AnimateByFloat(const float& relativeValue)
601 : mRelative(relativeValue)
605 float operator()(float alpha, const float& property)
607 return float(property + mRelative * alpha);
613 struct AnimateToFloat : public AnimatorFunctionBase
615 AnimateToFloat(const float& targetValue)
616 : mTarget(targetValue)
620 float operator()(float alpha, const float& property)
622 return float(property + ((mTarget - property) * alpha));
628 struct AnimateByVector2 : public AnimatorFunctionBase
630 AnimateByVector2(const Vector2& relativeValue)
631 : mRelative(relativeValue)
635 Vector2 operator()(float alpha, const Vector2& property)
637 return Vector2(property + mRelative * alpha);
643 struct AnimateToVector2 : public AnimatorFunctionBase
645 AnimateToVector2(const Vector2& targetValue)
646 : mTarget(targetValue)
650 Vector2 operator()(float alpha, const Vector2& property)
652 return Vector2(property + ((mTarget - property) * alpha));
658 struct AnimateByVector3 : public AnimatorFunctionBase
660 AnimateByVector3(const Vector3& relativeValue)
661 : mRelative(relativeValue)
665 Vector3 operator()(float alpha, const Vector3& property)
667 return Vector3(property + mRelative * alpha);
673 struct AnimateToVector3 : public AnimatorFunctionBase
675 AnimateToVector3(const Vector3& targetValue)
676 : mTarget(targetValue)
680 Vector3 operator()(float alpha, const Vector3& property)
682 return Vector3(property + ((mTarget - property) * alpha));
688 struct AnimateByVector4 : public AnimatorFunctionBase
690 AnimateByVector4(const Vector4& relativeValue)
691 : mRelative(relativeValue)
695 Vector4 operator()(float alpha, const Vector4& property)
697 return Vector4(property + mRelative * alpha);
703 struct AnimateToVector4 : public AnimatorFunctionBase
705 AnimateToVector4(const Vector4& targetValue)
706 : mTarget(targetValue)
710 Vector4 operator()(float alpha, const Vector4& property)
712 return Vector4(property + ((mTarget - property) * alpha));
718 struct AnimateByOpacity : public AnimatorFunctionBase
720 AnimateByOpacity(const float& relativeValue)
721 : mRelative(relativeValue)
725 Vector4 operator()(float alpha, const Vector4& property)
727 Vector4 result(property);
728 result.a += mRelative * alpha;
736 struct AnimateToOpacity : public AnimatorFunctionBase
738 AnimateToOpacity(const float& targetValue)
739 : mTarget(targetValue)
743 Vector4 operator()(float alpha, const Vector4& property)
745 Vector4 result(property);
746 result.a = property.a + ((mTarget - property.a) * alpha);
754 struct AnimateByBoolean : public AnimatorFunctionBase
756 AnimateByBoolean(bool relativeValue)
757 : mRelative(relativeValue)
761 bool operator()(float alpha, const bool& property)
763 // Alpha is not useful here, just keeping to the same template as other update functors
764 return bool(alpha >= 1.0f ? (property || mRelative) : property);
770 struct AnimateToBoolean : public AnimatorFunctionBase
772 AnimateToBoolean(bool targetValue)
773 : mTarget(targetValue)
777 bool operator()(float alpha, const bool& property)
779 // Alpha is not useful here, just keeping to the same template as other update functors
780 return bool(alpha >= 1.0f ? mTarget : property);
786 struct RotateByAngleAxis : public AnimatorFunctionBase
788 RotateByAngleAxis(const Radian& angleRadians, const Vector3& axis)
789 : mAngleRadians( angleRadians ),
790 mAxis(axis.x, axis.y, axis.z)
794 Quaternion operator()(float alpha, const Quaternion& rotation)
798 return rotation * Quaternion(mAngleRadians * alpha, mAxis);
804 Radian mAngleRadians;
808 struct RotateToQuaternion : public AnimatorFunctionBase
810 RotateToQuaternion(const Quaternion& targetValue)
811 : mTarget(targetValue)
815 Quaternion operator()(float alpha, const Quaternion& rotation)
817 return Quaternion::Slerp(rotation, mTarget, alpha);
824 struct KeyFrameBooleanFunctor : public AnimatorFunctionBase
826 KeyFrameBooleanFunctor(KeyFrameBooleanPtr keyFrames)
827 : mKeyFrames(keyFrames)
831 bool operator()(float progress, const bool& property)
833 if(mKeyFrames->IsActive(progress))
835 return mKeyFrames->GetValue(progress, Dali::Animation::Linear);
840 KeyFrameBooleanPtr mKeyFrames;
843 struct KeyFrameIntegerFunctor : public AnimatorFunctionBase
845 KeyFrameIntegerFunctor(KeyFrameIntegerPtr keyFrames, Interpolation interpolation)
846 : mKeyFrames(keyFrames),mInterpolation(interpolation)
850 float operator()(float progress, const int& property)
852 if(mKeyFrames->IsActive(progress))
854 return mKeyFrames->GetValue(progress, mInterpolation);
859 KeyFrameIntegerPtr mKeyFrames;
860 Interpolation mInterpolation;
863 struct KeyFrameNumberFunctor : public AnimatorFunctionBase
865 KeyFrameNumberFunctor(KeyFrameNumberPtr keyFrames, Interpolation interpolation)
866 : mKeyFrames(keyFrames),mInterpolation(interpolation)
870 float operator()(float progress, const float& property)
872 if(mKeyFrames->IsActive(progress))
874 return mKeyFrames->GetValue(progress, mInterpolation);
879 KeyFrameNumberPtr mKeyFrames;
880 Interpolation mInterpolation;
883 struct KeyFrameVector2Functor : public AnimatorFunctionBase
885 KeyFrameVector2Functor(KeyFrameVector2Ptr keyFrames, Interpolation interpolation)
886 : mKeyFrames(keyFrames),mInterpolation(interpolation)
890 Vector2 operator()(float progress, const Vector2& property)
892 if(mKeyFrames->IsActive(progress))
894 return mKeyFrames->GetValue(progress, mInterpolation);
899 KeyFrameVector2Ptr mKeyFrames;
900 Interpolation mInterpolation;
904 struct KeyFrameVector3Functor : public AnimatorFunctionBase
906 KeyFrameVector3Functor(KeyFrameVector3Ptr keyFrames, Interpolation interpolation)
907 : mKeyFrames(keyFrames),mInterpolation(interpolation)
911 Vector3 operator()(float progress, const Vector3& property)
913 if(mKeyFrames->IsActive(progress))
915 return mKeyFrames->GetValue(progress, mInterpolation);
920 KeyFrameVector3Ptr mKeyFrames;
921 Interpolation mInterpolation;
924 struct KeyFrameVector4Functor : public AnimatorFunctionBase
926 KeyFrameVector4Functor(KeyFrameVector4Ptr keyFrames, Interpolation interpolation)
927 : mKeyFrames(keyFrames),mInterpolation(interpolation)
931 Vector4 operator()(float progress, const Vector4& property)
933 if(mKeyFrames->IsActive(progress))
935 return mKeyFrames->GetValue(progress, mInterpolation);
940 KeyFrameVector4Ptr mKeyFrames;
941 Interpolation mInterpolation;
944 struct KeyFrameQuaternionFunctor : public AnimatorFunctionBase
946 KeyFrameQuaternionFunctor(KeyFrameQuaternionPtr keyFrames)
947 : mKeyFrames(keyFrames)
951 Quaternion operator()(float progress, const Quaternion& property)
953 if(mKeyFrames->IsActive(progress))
955 return mKeyFrames->GetValue(progress, Dali::Animation::Linear);
960 KeyFrameQuaternionPtr mKeyFrames;
963 struct PathPositionFunctor : public AnimatorFunctionBase
965 PathPositionFunctor( PathPtr path )
970 Vector3 operator()(float progress, const Vector3& property)
972 return mPath->SamplePosition(progress );
978 struct PathRotationFunctor : public AnimatorFunctionBase
980 PathRotationFunctor( PathPtr path, const Vector3& forward )
984 mForward.Normalize();
987 Quaternion operator()(float progress, const Quaternion& property)
989 Vector3 tangent( mPath->SampleTangent(progress) );
990 return Quaternion( mForward, tangent );
998 } // namespace Internal
1002 #endif // __DALI_INTERNAL_SCENE_GRAPH_ANIMATOR_H__