Função XMVectorShiftLeft (directxmath.h)

Artigo
02/28/2024

Desloca um vetor deixado por um determinado número de elementos de 32 bits, preenchendo os elementos desocupados com elementos de um segundo vetor.

Sintaxe

XMVECTOR XM_CALLCONV XMVectorShiftLeft(
  [in] FXMVECTOR V1,
  [in] FXMVECTOR V2,
  [in] uint32_t  Elements
) noexcept;

Parâmetros

[in] V1

Vetor para deslocar para a esquerda.

[in] V2

Vetor usado para preencher os componentes desocupados da V1 depois que ele é deslocado para a esquerda.

[in] Elements

Número de elementos de 32 bits pelos quais deslocar V para a esquerda. Esse parâmetro deve ser 0, 1, 2 ou 3.

Retornar valor

Retorna o XMVECTOR deslocado e preenchido.

Comentários

O código a seguir demonstra como essa função pode ser usada.

XMVECTOR v1 = XMVectorSet( 10.0f, 20.0f, 30.0f, 40.0f );
XMVECTOR v2 = XMVectorSet( 50.0f, 60.0f, 70.0f, 80.0f );
XMVECTOR result = XMVectorShiftLeft( v1, v2, 1 );

O vetor deslocado (resultado) será <20.0f, 30.0f, 40.0f, 50.0f>.

No caso de um valor de deslocamento constante, é mais eficiente usar a forma de modelo de XMVectorShiftLeft:


template<uint32_t Elements>
    XMVECTOR XMVectorShiftLeft(FXMVECTOR V1, FXMVECTOR V2)

Example: XMVectorShiftLeft<1>( v1, v2 );

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.