QuaternionKeyFrameAnimation 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
하나 이상의 키 프레임이 있는 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 : KeyFrameAnimationPublic 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) |
메서드
적용 대상
추가 정보
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기