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