Fonction XMVectorShiftLeft (directxmath.h)

Article
03/02/2024

Déplace un vecteur vers la gauche d’un nombre donné d’éléments 32 bits, en remplissant les éléments libérés d’éléments d’un deuxième vecteur.

Syntaxe

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

Paramètres

[in] V1

Vecteur à déplacer vers la gauche.

[in] V2

Vecteur utilisé pour remplir les composants libérés de V1 après son décalage vers la gauche.

[in] Elements

Nombre d’éléments 32 bits par lesquels déplacer V vers la gauche. Ce paramètre doit être 0, 1, 2 ou 3.

Valeur retournée

Retourne la valeur décalée et renseignée dans XMVECTOR.

Remarques

Le code suivant montre comment cette fonction peut être utilisée.

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 );

Le vecteur décalé (résultat) sera <20.0f, 30.0f, 40.0f, 50.0f>.

Dans le cas d’une valeur de décalage constant, il est plus efficace d’utiliser la forme de modèle de XMVectorShiftLeft :


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

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

Configuration requise pour la plateforme

Microsoft Visual Studio 2010 ou Microsoft Visual Studio 2012 avec le SDK Windows pour Windows 8. Pris en charge pour les applications de bureau Win32, les applications du Windows Store et les applications Windows Phone 8.