1 #ifndef DALI_TOOLKIT_INTERNAL_TRANSITION_BASE_H
2 #define DALI_TOOLKIT_INTERNAL_TRANSITION_BASE_H
5 * Copyright (c) 2022 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-toolkit/public-api/controls/control.h>
23 #include <dali-toolkit/public-api/transition/transition-base.h>
24 #include <dali-toolkit/public-api/transition/transition-set.h>
27 #include <dali/public-api/animation/animation.h>
28 #include <dali/public-api/object/base-object.h>
29 #include <dali/public-api/object/property-map.h>
37 using TransitionBasePtr = IntrusivePtr<TransitionBase>;
39 class TransitionBase : public BaseObject
43 * @brief Create a new TransitionBase object.
44 * @return A smart-pointer to the newly allocated TransitionBase.
46 static TransitionBasePtr New();
49 * @copydoc Dali::Toolkit::TransitionBase::SetTimePeriod()
51 void SetTimePeriod(const Dali::TimePeriod& timePeriod);
54 * @copydoc Dali::Toolkit::TransitionBase::GetTimePeriod()
56 Dali::TimePeriod GetTimePeriod() const;
59 * @copydoc Dali::Toolkit::TransitionBase::SetAlphaFunction()
61 void SetAlphaFunction(AlphaFunction alphaFunction)
63 mAlphaFunction = alphaFunction;
67 * @copydoc Dali::Toolkit::TransitionBase::GetAlphaFunction()
69 AlphaFunction GetAlphaFunction() const
71 return mAlphaFunction;
75 * @copydoc Dali::Toolkit::TransitionBase::TransitionWithChild()
77 void TransitionWithChild(bool transitionWithChild);
80 * @brief Run processes those are required done before size/position negotiation.
81 * @param[in] animation animation for the transition
83 void PreProcess(Dali::Animation animation);
86 * @brief Make property animation for Transition
91 * Emit the Finished signal
93 void TransitionFinished();
96 * @brief Set this transition is appearing transition or not.
97 * @param[in] appearingTransition True if this transition is appearing transition.
99 void SetAppearingTransition(bool appearingTransition)
101 mIsAppearingTransition = appearingTransition;
105 * @brief Returns whether this transition is appearing transition or not
107 bool IsAppearingTransition() const
109 return mIsAppearingTransition;
113 * @brief Returns whether this transition is a transition from a Control to another Control or effect to appearing or disappearing.
115 bool IsPairTransition() const
117 return mIsPairTransition;
121 * @brief Returns target which will be transition.
123 const Dali::Toolkit::Control GetTarget() const
130 * @brief Set property map which will be used as a animation start properties.
131 * @param[in] propertyMap propertyMap that will be used as a start value of transition.
133 void SetStartPropertyMap(const Property::Map& propertyMap)
135 mStartPropertyMap = propertyMap;
139 * @brief Set property map which will be used as a animation finish properties.
140 * @param[in] propertyMap propertyMap that will be used as a finish value of transition.
142 void SetFinishPropertyMap(const Property::Map& propertyMap)
144 mFinishPropertyMap = propertyMap;
148 * @brief Retrieve animation.
150 Dali::Animation GetAnimation()
156 * @brief Set target which will be transition.
157 * @param[in] target control that will be transition.
159 void SetTarget(Dali::Toolkit::Control target)
165 * @brief Returns whether this transition will be applied to children of target or not.
167 bool IsTransitionWithChild() const
169 return mTransitionWithChild;
173 * @brief Set whether this transition is a transition from a Control to another Control or effect to appearing or disappearing.
174 * @param[in] pairTransition True if this transition is appearing transition.
176 void SetPairTransition(bool pairTransition)
178 mIsPairTransition = pairTransition;
183 * Construct a new TransitionBase.
188 * Second-phase constructor.
195 ~TransitionBase() = default;
199 TransitionBase(const TransitionBase&);
202 TransitionBase& operator=(const TransitionBase& rhs);
206 * @brief Makes property animation for transition.
211 * @brief Adds a property on an animation between sourceValue and destimationValue.
212 * @param[in] target target control to be animated.
213 * @param[in] index property index for animation.
214 * @param[in] sourceValue source value of animation.
215 * @param[in] destinationValue destination value of animation.
217 void AnimateBetween(Dali::Toolkit::Control target, Property::Index index, Property::Value sourceValue, Property::Value destinationValue);
220 * @brief Copy target to make clone for the child Actors
225 * @brief Make pair of Property::Map to be used for transition animation.
226 * Set the pair of Property::Map by using SetStartPropertyMap() and SetFinishPropertyMap(),
227 * then the properties of mTarget will be animated between them during transition duration.
228 * If the transition requires the information of world transform, let them be in this method.
229 * World transform and World color can be retrieved by using GetWorldTransform() and GetWorldColor() methods.
230 * And If it is needed to add additional custom animation than use GetAnimation() and add them.
232 * @note Do not set any properties in this methods.
234 virtual void OnPlay()
239 * @brief If the transition is needed to do something after the transition is finished, let them be in this method.
241 virtual void OnFinished()
246 Dali::Toolkit::Control mTarget; ///< Target that will be animated.
247 Dali::Actor mCopiedActor; ///< Copied View that will replace mTarget during transition
248 Dali::Animation mAnimation; ///< Property animations for the transition of mTarget
249 AlphaFunction mAlphaFunction; ///< Alpha function that will applied for the property animation
250 Property::Map mStartPropertyMap; ///< Start properties to be animated. (world transform)
251 Property::Map mFinishPropertyMap; ///< Finish properties to be animated. (world transform)
252 Property::Map mOriginalPropertyMap; ///< Original properties of mTarget to be used to restore after the transition is finished.
253 Dali::TimePeriod mTimePeriod; ///< TimePeriod of transition
254 bool mTransitionWithChild; ///< True, if mTarget transition is inherit to its child Actors.
255 ///< If this is false, the child Actors are moved to the child of mCopiedActor that will have original properties of target Actor during Transition.
256 bool mMoveTargetChildren; ///< Flag, if mTransitionWithChild is false and mTarget has children than True.
257 bool mIsAppearingTransition; ///< True, if this transition is appearing transition.
258 bool mIsPairTransition; ///< True, if this transition is started from a Control to another Control.
261 } // namespace Internal
263 // Helpers for public-api forwarding methods
265 inline Internal::TransitionBase& GetImplementation(Dali::Toolkit::TransitionBase& animation)
267 DALI_ASSERT_ALWAYS(animation && "TransitionBase handle is empty");
269 BaseObject& handle = animation.GetBaseObject();
271 return static_cast<Internal::TransitionBase&>(handle);
274 inline const Internal::TransitionBase& GetImplementation(const Dali::Toolkit::TransitionBase& animation)
276 DALI_ASSERT_ALWAYS(animation && "TransitionBase handle is empty");
278 const BaseObject& handle = animation.GetBaseObject();
280 return static_cast<const Internal::TransitionBase&>(handle);
283 } // namespace Toolkit
287 #endif // DALI_TOOLKIT_INTERNAL_TRANSITION_BASE_H