다음을 통해 공유


QuaternionKeyFrameAnimation 클래스

정의

하나 이상의 키 프레임이 있는 Orientation 속성을 대상으로 하는 시간 기반 애니메이션입니다.

QuaternionKeyFrameAnimation 클래스는 Visual에서 Orientation 속성에 애니메이션 효과를 주는 데 사용되는 지원되는 KeyFrameAnimation형식 중 하나입니다. 쿼터니언은 회전에 대해 생각하는 유용하고 때로는 간단한 방법입니다. 쿼터니언은 각도 간에 가장 짧은 경로를 사용하고 회전 각도/축 및 회전 행렬이 실행되는 Gimbal Lock과 같은 문제를 방지합니다. Quaternion은 스칼라 및 벡터 파트의 두 가지 구성 요소로 구성됩니다.

public ref class QuaternionKeyFrameAnimation sealed : KeyFrameAnimation
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class QuaternionKeyFrameAnimation final : KeyFrameAnimation
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class QuaternionKeyFrameAnimation : KeyFrameAnimation
Public NotInheritable Class QuaternionKeyFrameAnimation
Inherits KeyFrameAnimation
상속
Object Platform::Object IInspectable CompositionObject CompositionAnimation KeyFrameAnimation QuaternionKeyFrameAnimation
특성

Windows 요구 사항

디바이스 패밀리
Windows 10 (10.0.10586.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v2.0에서 도입되었습니다.)

예제

void QuaternionAnimation(SpriteVisual visual)
{
  // Create the QuaternionKeyFrameAnimation
  var quaternionKFA = _compositor.CreateQuaternionKeyFrameAnimation();

  // Create a Quaternion that represents a 45 degree rotation around X Axis
  Quaternion quaternion = new Quaternion(0.380f, 0f, 0.0f, 0.92f);

  // Insert the Quaternion into the KeyFrame
  quaternionKFA.InsertKeyFrame(1.0f, quaternion);
  quaternionKFA.Duration = TimeSpan.FromSeconds(1);

  // Attach to the Orientation property of Visual
  visual.StartAnimation("Orientation", quaternionKFA);
}

설명

애니메이션은 CompositionObject.StartAnimation 을 호출하고 속성 이름과 애니메이션을 지정하여 개체의 속성과 연결됩니다. 애니메이션 속성 목록은 CompositionObject.StartAnimation 의 설명 섹션을 참조하세요.

Quaternion은 벡터와 스칼라 구성 요소의 두 가지 구별 가능한 부분으로 구성됩니다. 키 프레임 애니메이션과 함께 사용하는 경우 4개의 부동 소수 자릿수 또는 Vector3 및 스칼라의 표기법으로 Quaternion을 정의할 수 있습니다. System.Numerics는 이러한 표기법 중 하나에 대한 생성자를 제공합니다.

회전을 Quaternion으로 변환할 때 축/각도 콤보, 회전 행렬 또는 Yaw/Pitch/Roll에서 Quaternions를 만들 수 있는 System.Numerics Quaternion 도우미 함수를 활용할 수 있습니다. 위의 예제에서는 아래 도우미에서 동일한 Quaternion을 생성할 수 있습니다.

Quaternion quaternion = Quaternion.CreateFromAxisAngle(new Vector3(1.0f, 0.0f, 0.0f), 0.78f);

속성

Comment

CompositionObject와 연결할 문자열입니다.

(다음에서 상속됨 CompositionObject)
Compositor

CompositionObject를 만드는 데 사용되는 Compositor입니다.

(다음에서 상속됨 CompositionObject)
DelayBehavior

키 프레임 애니메이션의 지연 동작입니다.

(다음에서 상속됨 KeyFrameAnimation)
DelayTime

CompositionObject.StartAnimation이 호출된 후 애니메이션이 시작되기 전에 지연됩니다.

(다음에서 상속됨 KeyFrameAnimation)
Direction

애니메이션이 재생되는 방향입니다.

Direction 속성을 사용하면 애니메이션에 IterationCount가 1보다 큰 경우 시작과 끝 또는 끝을 시작하거나 번갈아 시작하거나 애니메이션을 처음부터 끝까지 구동할 수 있습니다. 이렇게 하면 애니메이션 정의를 쉽게 사용자 지정할 수 있습니다.

(다음에서 상속됨 KeyFrameAnimation)
Dispatcher

CompositionObject의 디스패처입니다.

(다음에서 상속됨 CompositionObject)
DispatcherQueue

CompostionObject에 대한 DispatcherQueue 를 가져옵니다.

(다음에서 상속됨 CompositionObject)
Duration

애니메이션의 기간입니다.

(다음에서 상속됨 KeyFrameAnimation)
ImplicitAnimations

이 개체에 연결된 암시적 애니메이션의 컬렉션입니다.

(다음에서 상속됨 CompositionObject)
InitialValueExpressions

애니메이션의 초기 값을 가져옵니다.

(다음에서 상속됨 CompositionAnimation)
IterationBehavior

키 프레임 애니메이션의 반복 동작입니다.

(다음에서 상속됨 KeyFrameAnimation)
IterationCount

키 프레임 애니메이션을 반복할 횟수입니다.

(다음에서 상속됨 KeyFrameAnimation)
KeyFrameCount

KeyFrameAnimation의 키 프레임 수입니다.

(다음에서 상속됨 KeyFrameAnimation)
Properties

CompositionObject와 연결된 속성의 컬렉션입니다.

(다음에서 상속됨 CompositionObject)
StopBehavior

StopAnimation이 호출되면 속성 값을 설정하는 방법을 지정합니다.

(다음에서 상속됨 KeyFrameAnimation)
Target

애니메이션의 대상입니다.

(다음에서 상속됨 CompositionAnimation)

메서드

ClearAllParameters()

애니메이션의 모든 매개 변수를 지웁니다.

(다음에서 상속됨 CompositionAnimation)
ClearParameter(String)

애니메이션에서 매개 변수를 지웁니다.

(다음에서 상속됨 CompositionAnimation)
Close()

CompositionObject를 닫고 시스템 리소스를 해제합니다.

(다음에서 상속됨 CompositionObject)
ConnectAnimation(String, CompositionAnimation)

연결 및 애니메이션.

(다음에서 상속됨 CompositionObject)
DisconnectAnimation(String)

애니메이션의 연결을 끊습니다.

(다음에서 상속됨 CompositionObject)
Dispose()

관리되지 않는 리소스의 확보, 해제 또는 다시 설정과 관련된 애플리케이션 정의 작업을 수행합니다.

(다음에서 상속됨 CompositionObject)
InsertExpressionKeyFrame(Single, String)

식 키 프레임을 삽입합니다.

(다음에서 상속됨 KeyFrameAnimation)
InsertExpressionKeyFrame(Single, String, CompositionEasingFunction)

식 키 프레임을 삽입합니다.

(다음에서 상속됨 KeyFrameAnimation)
InsertKeyFrame(Single, Quaternion)

키 프레임을 삽입합니다.

InsertKeyFrame(Single, Quaternion, CompositionEasingFunction)

지정된 감속/가속 함수를 사용하여 키 프레임을 삽입합니다.

PopulatePropertyInfo(String, AnimationPropertyInfo)

애니메이션 효과를 주는 속성을 정의합니다.

(다음에서 상속됨 CompositionObject)
SetBooleanParameter(String, Boolean)

ExpressionAnimation 또는 식키 프레임에 사용할 부울 값 매개 변수를 설정합니다.

(다음에서 상속됨 CompositionAnimation)
SetColorParameter(String, Color)

ExpressionAnimation 또는 식키 프레임에 사용할 Color 값 매개 변수를 설정합니다.

(다음에서 상속됨 CompositionAnimation)
SetExpressionReferenceParameter(String, IAnimationObject)

IAnimationObjectExpressionAnimation에서 참조 매개 변수로 구현하는 개체를 설정합니다.

(다음에서 상속됨 CompositionAnimation)
SetMatrix3x2Parameter(String, Matrix3x2)

ExpressionAnimation 또는 식 키 프레임에 사용할 Matrix3x2 값 매개 변수를 설정합니다.

(다음에서 상속됨 CompositionAnimation)
SetMatrix4x4Parameter(String, Matrix4x4)

ExpressionAnimation 또는 식 키프레임에 사용할 Matrix4x4 값 매개 변수를 설정합니다.

(다음에서 상속됨 CompositionAnimation)
SetQuaternionParameter(String, Quaternion)

ExpressionAnimation 또는 식키 프레임에 사용할 Quaternion 값을 설정합니다.

(다음에서 상속됨 CompositionAnimation)
SetReferenceParameter(String, CompositionObject)

ExpressionAnimation 또는 식키 프레임에 사용할 Composition 개체에 대한 참조를 설정합니다.

(다음에서 상속됨 CompositionAnimation)
SetScalarParameter(String, Single)

ExpressionAnimation 또는 식키 프레임에 사용할 스칼라 값 매개 변수를 설정합니다.

(다음에서 상속됨 CompositionAnimation)
SetVector2Parameter(String, Vector2)

ExpressionAnimation 또는 식키 프레임에 사용할 Vector2 값 매개 변수를 설정합니다.

(다음에서 상속됨 CompositionAnimation)
SetVector3Parameter(String, Vector3)

ExpressionAnimation 또는 식키 프레임에 사용할 Vector3 값 매개 변수를 설정합니다.

(다음에서 상속됨 CompositionAnimation)
SetVector4Parameter(String, Vector4)

ExpressionAnimation 또는 식 키 프레임에 사용할 Vector4 값 매개 변수를 설정합니다.

(다음에서 상속됨 CompositionAnimation)
StartAnimation(String, CompositionAnimation)

개체의 지정된 속성에 애니메이션을 연결하고 애니메이션을 시작합니다.

(다음에서 상속됨 CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)

개체의 지정된 속성에 애니메이션을 연결하고 애니메이션을 시작합니다.

(다음에서 상속됨 CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)

애니메이션 그룹을 시작합니다.

CompositionObject의 StartAnimationGroup 메서드를 사용하면 CompositionAnimationGroup을 시작할 수 있습니다. 그룹의 모든 애니메이션은 개체에서 동시에 시작됩니다.

(다음에서 상속됨 CompositionObject)
StopAnimation(String)

지정된 속성에서 애니메이션의 연결을 끊고 애니메이션을 중지합니다.

(다음에서 상속됨 CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)

애니메이션 그룹을 중지합니다.

(다음에서 상속됨 CompositionObject)
TryGetAnimationController(String)

지정된 속성에서 실행되는 애니메이션에 대한 AnimationController를 반환합니다.

(다음에서 상속됨 CompositionObject)

적용 대상

추가 정보