Funzione XMVectorInsert (directxmath.h)

Articolo
02/26/2024

Ruota un vettore sinistro da un determinato numero di componenti a 32 bit e inserisce gli elementi selezionati di tale risultato in un altro vettore.

Sintassi

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;

Parametri

[in] VD

Vettore in cui inserire.

[in] VS

Vettore da ruotare a sinistra.

[in] VSLeftRotateElements

Numero di componenti a 32 bit in base ai quali ruotare VISUAL Studio a sinistra.

[in] Select0

0 o 1. In caso affermativo, il componente x del vettore ruotato verrà inserito nel componente corrispondente di VD. In caso contrario, il componente x di VD viene lasciato solo.

[in] Select1

0 o 1. In caso affermativo, il componente y del vettore ruotato verrà inserito nel componente corrispondente di VD. In caso contrario, il componente y di VD viene lasciato solo.

[in] Select2

0 o 1. In caso affermativo, il componente z del vettore ruotato verrà inserito nel componente corrispondente di VD. In caso contrario, il componente z di VD viene lasciato solo.

[in] Select3

0 o 1. In caso affermativo, il componente w del vettore ruotato verrà inserito nel componente corrispondente di VD. In caso contrario, il componente w di VD viene lasciato solo.

Valore restituito

Restituisce il valore XMVECTOR risultante dalla rotazione e dall'inserimento.

Commenti

Per ottenere prestazioni ottimali, il risultato di XMVectorInsert deve essere assegnato di nuovo a VD.

Per i casi con parametri uint32_t costanti, è più efficiente usare il formato di modello di XMVectorInsert:


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

Requisiti della piattaforma

Microsoft Visual Studio 2010 o Microsoft Visual Studio 2012 con Windows SDK per Windows 8. Supportato per le app desktop Win32, le app di Windows Store e Windows Phone 8 app.