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