Share via

Функция XMStoreFloat3x3 (directxmath.h)

  • Статья

Сохраняет XMMATRIX в XMFLOAT3X3.

Синтаксис

void XM_CALLCONV XMStoreFloat3x3(
  [out] XMFLOAT3X3 *pDestination,
  [in]  FXMMATRIX  M
) noexcept;

Параметры

[out] pDestination

Адрес, по которому будут храниться данные.

[in] M

Матрица, содержащая данные для хранения.

Возвращаемое значение

Нет.

Remarks

XMFLOAT3X3 представляет собой матричную форму с основными строками. Чтобы записать данные по основным столбцам, перед вызовом функции store необходимо транспонировать XMMATRIX через XMMatrixTranpose .

Эта функция принимает матрицу и записывает компоненты в девять значений с плавающей запятой одной точности по заданному адресу. Наиболее значимая часть вектора первой строки записывается в первые четыре байта адреса, за ним следует второй по значимости компонент первой строки, а затем третий по значимости компонент первой строки. Затем наиболее значительные три компонента второй строки записываются в память, начиная с 12 байтов, а затем третья строка в память, начиная с 24 байтов.

Следующий псевдокод демонстрирует работу функции .

pDestination->_11 = M[0].x; // 4 bytes to address (uint8_t*)pDestination
pDestination->_12 = M[0].y; // 4 bytes to address (uint8_t*)pDestination + 4
pDestination->_13 = M[0].z; // 4 bytes to address (uint8_t*)pDestination + 8

pDestination->_21 = M[1].x; // 4 bytes to address (uint8_t*)pDestination + 12
pDestination->_22 = M[1].y; // 4 bytes to address (uint8_t*)pDestination + 16
pDestination->_23 = M[1].z; // 4 bytes to address (uint8_t*)pDestination + 20

pDestination->_31 = M[2].x; // 4 bytes to address (uint8_t*)pDestination + 24
pDestination->_32 = M[2].y; // 4 bytes to address (uint8_t*)pDestination + 28
pDestination->_33 = M[2].z; // 4 bytes to address (uint8_t*)pDestination + 32

Требования к платформе

Microsoft Visual Studio 2010 или Microsoft Visual Studio 2012 с windows SDK для Windows 8. Поддерживается для классических приложений Win32, приложений Магазина Windows и Windows Phone 8 приложений.

Требования

Требование Значение
Целевая платформа Windows
Header directxmath.h

См. также раздел

Функции хранилища векторов библиотеки DirectXMath