XMStoreFloat4x4A-Funktion (directxmath.h)

Speichert einen XMVECTOR in einer XMFLOAT4X4A.

Syntax

void XM_CALLCONV XMStoreFloat4x4A(
  [out] XMFLOAT4X4A *pDestination,
  [in]  FXMMATRIX   M
) noexcept;

Parameter

[out] pDestination

Adresse, an der die Daten gespeichert werden sollen. Diese Adresse muss 16 Byte ausgerichtet sein.

[in] M

Matrix mit den zu speichernden Daten.

Rückgabewert

Keine.

Hinweise

XMFLOAT4X4A ist ein Zeilen-Hauptmatrix-Formular. Zum Schreiben von Spaltenhauptdaten muss die XMMATRIX vor dem Aufruf der Store-Funktion über XMMatrixTranpose transponiert werden.

Der folgende Pseudocode veranschaulicht den Vorgang der Funktion.

assert(pDestination);
assert(((uint32_t_PTR)pDestination & 0xF) == 0);

pDestination->m[0][0] = M.r[0].v[0];
pDestination->m[0][1] = M.r[0].v[1];
pDestination->m[0][2] = M.r[0].v[2];
pDestination->m[0][3] = M.r[0].v[3];

pDestination->m[1][0] = M.r[1].v[0];
pDestination->m[1][1] = M.r[1].v[1];
pDestination->m[1][2] = M.r[1].v[2];
pDestination->m[1][3] = M.r[1].v[3];

pDestination->m[2][0] = M.r[2].v[0];
pDestination->m[2][1] = M.r[2].v[1];
pDestination->m[2][2] = M.r[2].v[2];
pDestination->m[2][3] = M.r[2].v[3];

pDestination->m[3][0] = M.r[3].v[0];
pDestination->m[3][1] = M.r[3].v[1];
pDestination->m[3][2] = M.r[3].v[2];
pDestination->m[3][3] = M.r[3].v[3];

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