Función XMVectorInsert (directxmath.h)

Artículo
02/26/2024

Gira un vector a la izquierda por un número determinado de componentes de 32 bits e inserta elementos seleccionados de ese resultado en otro vector.

Sintaxis

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;

Parámetros

[in] VD

Vector en el que se va a insertar.

[in] VS

Vector que se va a girar a la izquierda.

[in] VSLeftRotateElements

Número de componentes de 32 bits por los que se va a girar VS a la izquierda.

[in] Select0

0 o 1. Si es uno, el componente x del vector girado se insertará en el componente correspondiente de VD. De lo contrario, el componente x de VD se deja solo.

[in] Select1

0 o 1. Si es uno, el componente y del vector girado se insertará en el componente correspondiente de VD. De lo contrario, el componente y de VD se deja solo.

[in] Select2

0 o 1. Si es uno, el componente z del vector girado se insertará en el componente correspondiente de VD. De lo contrario, el componente z de VD se deja solo.

[in] Select3

0 o 1. Si es uno, el componente w del vector girado se insertará en el componente correspondiente de VD. De lo contrario, el componente w de VD se deja solo.

Valor devuelto

Devuelve el XMVECTOR que resulta de la rotación y la inserción.

Comentarios

Para obtener el mejor rendimiento, el resultado de XMVectorInsert debe asignarse de nuevo a VD.

En los casos con parámetros de uint32_t constantes, es más eficaz usar la forma de plantilla de XMVectorInsert:


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

Requisitos de la plataforma

Microsoft Visual Studio 2010 o Microsoft Visual Studio 2012 con Windows SDK para Windows 8. Compatible con aplicaciones de escritorio Win32, aplicaciones de la Tienda Windows y Windows Phone 8 aplicaciones.