XMVectorPermute-Funktion (directxmath.h)

Artikel
08/23/2023

Permutiert die Komponenten von zwei Vektoren, um einen neuen Vektor zu erstellen.

Syntax

XMVECTOR XM_CALLCONV XMVectorPermute(
  [in] FXMVECTOR V1,
  [in] FXMVECTOR V2,
       uint32_t  PermuteX,
       uint32_t  PermuteY,
       uint32_t  PermuteZ,
       uint32_t  PermuteW
) noexcept;

Parameter

[in] V1

Erster Vektor.

[in] V2

Zweiter Vektor.

PermuteX

Indexform 0-7, die angibt, wo die X-Komponente des neuen Vektors kopiert werden soll.

PermuteY

Indexform 0-7, die angibt, wo die Y-Komponente des neuen Vektors kopiert werden soll.

PermuteZ

Indexform 0-7, die angibt, wo die Z-Komponente des neuen Vektors kopiert werden soll.

PermuteW

Indexform 0-7, die angibt, wo die W-Komponente des neuen Vektors kopiert werden soll.

Rückgabewert

Gibt den permutierten Vektor zurück, der sich aus der Kombination der Quellvektoren ergeben hat.

Hinweise

Wenn alle vier Indizes nur auf einen einzelnen Vektor verweisen (d. h., sie befinden sich alle im Bereich 0-3 oder alle im Bereich 4-7), verwenden Sie stattdessen XMVectorSwizzle , um die Leistung zu verbessern.

Die XM_PERMUTE_ Konstanten werden zur Verwendung als Eingabewerte für PermuteX, PermuteY, PermuteZ und PermuteW bereitgestellt.

Für konstante PermuteX/Y/Z/W-Parameter ist es viel effizienter, die Vorlagenform von XMVectorPermute zu verwenden:


template<uint32_t PermuteX, uint32_t PermuteY, uint32_t PermuteZ, uint32_t PermuteW>
    XMVECTOR XMVectorPermute(FXMVECTOR V1, FXMVECTOR V2)

Example: XMVectorPermute<XM_PERMUTE_0Z, XM_PERMUTE_1X, XM_PERMUTE_0W, XM_PERMUTE_1Y>( V1, V2 );

Hinweis Diese Version von XMVectorPermute ist neu für DirectXMath. Die XNAMath v2.x-Bibliothek verwendete XMVectorPermuteControlein -Steuerelement XMVECTOR anstelle von 4 Indizes für XMVectorPermuteund verwendete unterschiedliche Werte für die XM_PERMUTE_x Konstanten.

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 (DirectXMath.h einschließen)

Weitere Informationen

Komponentenweise Vektorfunktionen

XMVectorSwizzle

Freigeben über