XMVectorInsert-Funktion (directxmath.h)

Artikel
02/26/2024

Rotiert einen Vektor nach links um eine bestimmte Anzahl von 32-Bit-Komponenten und fügt ausgewählte Elemente dieses Ergebnisses in einen anderen Vektor ein.

Syntax

XMVECTOR XM_CALLCONV XMVectorInsert(
  [in] FXMVECTOR VD,
  [in] FXMVECTOR VS,
  [in] uint32_t  VSLeftRotateElements,
  [in] uint32_t  Select0,
  [in] uint32_t  Select1,
  [in] uint32_t  Select2,
  [in] uint32_t  Select3
) noexcept;

Parameter

[in] VD

Vektor, in den eingefügt werden soll.

[in] VS

Vektor, der nach links gedreht werden soll.

[in] VSLeftRotateElements

Anzahl der 32-Bit-Komponenten, um die vs links gedreht werden soll.

[in] Select0

Entweder 0 oder 1. Falls vorhanden, wird die x-Komponente des gedrehten Vektors in die entsprechende Komponente von VD eingefügt. Andernfalls wird die x-Komponente von VD in Ruhe gelassen.

[in] Select1

Entweder 0 oder 1. Falls vorhanden, wird die y-Komponente des gedrehten Vektors in die entsprechende Komponente von VD eingefügt. Andernfalls wird die y-Komponente von VD in Ruhe gelassen.

[in] Select2

Entweder 0 oder 1. Falls vorhanden, wird die z-Komponente des gedrehten Vektors in die entsprechende Komponente von VD eingefügt. Andernfalls wird die z-Komponente von VD in Ruhe gelassen.

[in] Select3

Entweder 0 oder 1. Falls vorhanden, wird die w-Komponente des gedrehten Vektors in die entsprechende Komponente von VD eingefügt. Andernfalls wird die w-Komponente von VD in Ruhe gelassen.

Rückgabewert

Gibt den XMVECTOR zurück, der sich aus der Drehung und dem Einfügen ergibt.

Hinweise

Um eine optimale Leistung zu erzielen, sollte das Ergebnis von XMVectorInsert wieder vd zugewiesen werden.

Für Fälle mit konstanten uint32_t Parametern ist es effizienter, das Vorlagenformular von XMVectorInsert zu verwenden:


template<uint32_t VSLeftRotateElements, uint32_t Select0, uint32_t Select1, uint32_t Select2, uint32_t Select3>
    XMVECTOR XMVectorInsert(FXMVECTOR VD, FXMVECTOR VS)

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.