Функция D3DXMatrixAffineTransformation (D3dx9math.h)
Примечание
Служебная библиотека D3DX устарела. Вместо этого рекомендуется использовать DirectXMath .
Создает матрицу трехмерного аффинного преобразования. Аргументы NULL обрабатываются как преобразования удостоверений.
Синтаксис
D3DXMATRIX* D3DXMatrixAffineTransformation(
_Inout_ D3DXMATRIX *pOut,
_In_ FLOAT Scaling,
_In_ const D3DXVECTOR3 *pRotationCenter,
_In_ const D3DXQUATERNION *pRotation,
_In_ const D3DXVECTOR3 *pTranslation
);
Параметры
-
pOut [in, out]
-
Тип: D3DXMATRIX*
Указатель на структуру D3DXMATRIX , которая является результатом операции.
-
Масштабирование [в]
-
Тип: FLOAT
Коэффициент масштабирования.
-
pRotationCenter [in]
-
Тип: const D3DXVECTOR3*
Указатель на структуру D3DXVECTOR3 , точку, определяющую центр поворота. Если этот аргумент имеет значение NULL, к формуле в примечаниях применяется матрицаrc identity M.
-
pRotation [in]
-
Тип: const D3DXQUATERNION*
Указатель на структуру D3DXQUATERNION , указывающую поворот. Если этот аргумент имеет значение NULL, к формуле в примечаниях применяется матрица идентификатора Mr .
-
pTranslation [in]
-
Тип: const D3DXVECTOR3*
Указатель на структуру D3DXVECTOR3 , представляющую перевод. Если этот аргумент имеет значение NULL, к формуле в примечаниях применяется матрица удостоверений Mt.
Возвращаемое значение
Тип: D3DXMATRIX*
Указатель на структуру D3DXMATRIX , которая является матрицей аффинного преобразования.
Комментарии
Эта функция вычисляет матрицу аффинного преобразования с помощью следующей формулы, при этом объединение матриц вычисляется в порядке слева направо:
Mout = Ms * (Mrc)⁻¹ * Mr * Mrc * Mt
где:
Mout = матрица вывода (pOut)
Ms = матрица масштабирования (масштабирование)
Mrc = центр матрицы поворота (pRotationCenter)
Mr = матрица поворота (pRotation)
Mt = матрица перевода (pTranslation)
Возвращаемое значение для этой функции совпадает с значением, возвращаемым в параметре pOut. Таким образом, функцию D3DXMatrixAffineTransformation можно использовать в качестве параметра для другой функции.
Для двухмерных аффинных преобразований используйте D3DXMatrixAffineTransformation2D.
Требования
| Требование | Значение |
|---|---|
| Заголовок |
|
| Библиотека |
|
См. также раздел