XMStoreFloat3x3-Funktion (directxmath.h)
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 |