D3DXQuaternionSquadSetup 함수

구면2차 보간의 제어 포인트를 설정한다.

구문

void D3DXQuaternionSquadSetup(      

    D3DXQUATERNION *pAOut,
    D3DXQUATERNION *pBOut,
    D3DXQUATERNION *pCOut,
    const D3DXQUATERNION *pQ0,
    const D3DXQUATERNION *pQ1,
    const D3DXQUATERNION *pQ2,
    const D3DXQUATERNION *pQ3
);

파라미터

pAOut
[out] AOut 의 포인터.
pBOut
[out] BOut 의 포인터.
pCOut
[out] COut 의 포인터.
pQ0
[in] 입력 제어 포인트 Q0 의 포인터.
pQ1
[in] 입력 제어 포인트 Q1 의 포인터.
pQ2
[in] 입력 제어 포인트 Q2 의 포인터.
pQ3
[in] 입력 제어 포인트 Q3 의 포인터.

반환값

없음.

주의

이 함수는, 입력 pQ0, pQ1, pQ2, 및 pQ3 로 지정되는 4 개의 제어 포인트를 취한다. 그 후 이러한 값을 변경해, 최단의 패스를 통과하는 커브를 찾아낸다. q0, q2, 및 q3 의 값은, 다음과 같이 계산된다.
q0 = |Q0 + Q1| < |Q0 - Q1| ?  -Q0 : Q0
q2 = |Q1 + Q2| < |Q1 - Q2| ?  -Q2 : Q2
q3 = |Q2 + Q3| < |Q2 - Q3| ? -Q3 :Q3
새로운 Q 값을 계산하면 다음과 같이 해 AOut, BOut, 및 COut 가 계산된다.
AOut = q1 * e^{[-0. 25 *( Ln[Exp(q1) *q2] + Ln[Exp(q1) *q0] ) ]}
BOut = q2 * e^{[-0. 25 *( Ln[Exp(q2) *q3] + Ln[Exp(q2) *q1] ) ]}
COut = q2
주 Ln 는 애플리케이션 프로그래밍 인터페이스 (API)의 메서드 D3DXQuaternionLn 로, Exp 는 API 의 메서드 D3DXQuaternionExp 이다.

예

다음에, 쿼터니온 키세트 (Q0, Q1, Q2, Q3)를 사용해 내부 평방 포인트 (A, B, C)를 계산하는 예를 나타낸다. 이것에 의해, 인접하는 세그먼트(segment)를 또 있고로 접선이 연속한다.
        A     B
  Q0    Q1    Q2    Q3
이와 같이 해 Q1 와 Q2 의 사이를 보간 한다.
// Rotation about the z-axis
D3DXQUATERNION Q0 = D3DXQUATERNION(0,  0, 0.707f, -. 707f);
D3DXQUATERNION Q1 = D3DXQUATERNION(0,  0, 0.000f, 1.000f);
D3DXQUATERNION Q2 = D3DXQUATERNION(0,  0, 0.707f, 0.707f);
D3DXQUATERNION Q3 = D3DXQUATERNION(0,  0, 1.000f, 0.000f);
D3DXQUATERNION A, B, C, Qt;
FLOAT time = 0.5f;

D3DXQuaternionSquadSetup(&A, &B, &C, &Q0, &Q1, &Q2, &Q3);
D3DXQuaternionSquad(&Qt, &Q1, &A, &B, &C, time);
주 :
C 는, 함수의 결과에 의해 + 또는 - 의 Q2 가 된다.
Qt 는 함수의 결과이다.
결과는, z 축의 주위에서 time = 0.5 로 45 도 회전한 것이 된다.

함수의 정보

헤더 d3dx9math.h
임포트 라이브러리 d3dx9.lib
최저한의 operating system Windows 98

헤더	d3dx9math.h
임포트 라이브러리	d3dx9.lib
최저한의 operating system	Windows 98

참조

D3DXQuaternionSquad