XMStoreFloat3x3 函式 (directxmath.h)

將 XMMATRIX 儲存在 XMFLOAT3X3中。

語法

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

參數

[out] pDestination

要儲存數據的位址。

[in] M

包含要儲存之數據的矩陣。

傳回值

無。

備註

XMFLOAT3X3 是數據列主要矩陣形式。 若要寫出數據行主要數據，必須先透過 XMMatrixTranpose 轉置 XMMATRIX，再呼叫 store 函式。

此函式會採用矩陣，並將元件寫出至指定位址的九個單精度浮點值。 第一個數據列向量最重要的元件會寫入位址的前四個字節，後面接著第一個數據列的第二個最重要的元件，後面接著第一個數據列的第三個最重要元件。 然後，第二個數據列最重要的三個元件會以類似方式寫出到從位元組 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 for Windows 8。 支援 Win32 傳統型應用程式、Windows 市集應用程式和 Windows Phone 8 個應用程式。

規格需求

需求	值
目標平台	Windows
標頭	directxmath.h

另請參閱

DirectXMath 連結庫向量存放區函式