docs/content/programming-guide/animation-rotation.h

   1 /*! \page animation-rotation Rotation with quaternions
   2  *
   3  * \ref Dali::Quaternion "Quaternions" are used to specify unique orientations on actors. They are also
   4  * very useful for calculating smooth transitions between orientations.
   5  *
   6  * The Dali::Actor class provides the ability to set the orientation
   7  * by both angle+axis and quaternion. It also allows you to rotate the
   8  * actor around another quaternion.
   9  *
  10  * @code
  11  * Dali::Actor actor;
  12  * actor.SetOrientation(Quaternion(Radian(Degree(45.0f)).value, Vector3::XAXIS)),
  13  *
  14  * Quaternion q(Radian(Degree(30.0f)).value, Vector3(1.0f, 1.0f, 0.0f));
  15  * actor.RotateBy(q);
  16  * @endcode
  17  *
  18  * The Dali::Animation class provides several AnimateTo methods that
  19  * use \ref Dali::Quaternion "Quaternions" directly to change the orientation.
  20  *
  21  * @code
  22  * mAnimation = Animation::New(5.0f); // 5 seconds
  23  * Quaternion q(Radian(Degree(45.0f)).value, Vector3::YAXIS);
  24  * Quaternion r(Radian(Degree(30.0f)).value, Vector3::ZAXIS);
  25  * q *= r;
  26  * mAnimation.AnimateTo(Property(mActor, Actor::Property::ORIENTATION), q, AlphaFunction::EASE_IN_OUT);
  27  * mAnimation.Play();
  28  * @endcode
  29  */