Função XMVectorInsert (directxmath.h)

Artigo
02/26/2024

Gira um vetor deixado por um determinado número de componentes de 32 bits e insere elementos selecionados desse resultado em outro vetor.

Sintaxe

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

Vetor no qual inserir.

[in] VS

Vetor para girar para a esquerda.

[in] VSLeftRotateElements

Número de componentes de 32 bits pelos quais girar o VS para a esquerda.

[in] Select0

0 ou 1. Se houver, o componente x do vetor girado será inserido no componente correspondente da VD. Caso contrário, o componente x da VD será deixado sozinho.

[in] Select1

0 ou 1. Se houver, o componente y do vetor girado será inserido no componente correspondente da VD. Caso contrário, o componente y da VD será deixado sozinho.

[in] Select2

0 ou 1. Se houver, o componente z do vetor girado será inserido no componente correspondente da VD. Caso contrário, o componente z da VD será deixado sozinho.

[in] Select3

0 ou 1. Se houver, o componente w do vetor girado será inserido no componente correspondente da VD. Caso contrário, o w-component da VD será deixado sozinho.

Retornar valor

Retorna o XMVECTOR que resulta da rotação e da inserção.

Comentários

Para obter o melhor desempenho, o resultado de XMVectorInsert deve ser atribuído de volta à VD.

Para casos com parâmetros de uint32_t constantes, é mais eficiente usar a forma de modelo 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 plataforma

Microsoft Visual Studio 2010 ou Microsoft Visual Studio 2012 com o SDK do Windows para Windows 8. Com suporte para aplicativos da área de trabalho Win32, aplicativos da Windows Store e aplicativos Windows Phone 8.