XMStoreFloat3x3-Funktion (directxmath.h)

  • Artikel

Speichert eine XMMATRIX in einer XMFLOAT3X3.

Syntax

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

Parameter

[out] pDestination

Adresse, an der die Daten gespeichert werden sollen.

[in] M

Matrix mit den zu speichernden Daten.

Rückgabewert

Keine.

Hinweise

XMFLOAT3X3 ist eine Matrixform mit Zeilenmatrizen. Zum Schreiben von Spaltenhauptdaten muss die XMMATRIX vor dem Aufruf der Store-Funktion über XMMatrixTranpose transponiert werden.

Diese Funktion verwendet eine Matrix und schreibt die Komponenten an der angegebenen Adresse in neun Gleitkommawerte mit einfacher Genauigkeit. Die wichtigste Komponente des ersten Zeilenvektors wird in die ersten vier Bytes der Adresse geschrieben, gefolgt von der zweitwichtigsten Komponente der ersten Zeile, gefolgt von der drittwichtigsten Komponente der ersten Zeile. Die wichtigsten drei Komponenten der zweiten Zeile werden dann ab Byte 12 auf ähnliche Weise in den Arbeitsspeicher geschrieben, gefolgt von der dritten Zeile zum Arbeitsspeicher ab Byte 24.

Der folgende Pseudocode veranschaulicht den Vorgang der Funktion.

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

Plattformanforderungen

Microsoft Visual Studio 2010 oder Microsoft Visual Studio 2012 mit dem Windows SDK für Windows 8. Unterstützt für Win32-Desktop-Apps, Windows Store-Apps und Windows Phone 8-Apps.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile directxmath.h

Weitere Informationen

Vektorspeicherfunktionen der DirectXMath-Bibliothek