Fonction XMVectorSelectControl (directxmath.h)

Article
02/26/2024

Définit un vecteur de contrôle à utiliser dans XMVectorSelect.

Syntaxe

XMVECTOR XM_CALLCONV XMVectorSelectControl(
  [in] uint32_t VectorIndex0,
  [in] uint32_t VectorIndex1,
  [in] uint32_t VectorIndex2,
  [in] uint32_t VectorIndex3
) noexcept;

Paramètres

[in] VectorIndex0

Index qui détermine le vecteur dans XMVectorSelect qui sera sélectionné. Si zéro, le premier composant du premier vecteur est sélectionné. Dans le cas contraire, le composant du deuxième vecteur est sélectionné.

[in] VectorIndex1

Index qui détermine le vecteur dans XMVectorSelect qui sera sélectionné. Si zéro, le deuxième composant du premier vecteur est sélectionné. Dans le cas contraire, le composant du deuxième vecteur est sélectionné.

[in] VectorIndex2

Index qui détermine le vecteur dans XMVectorSelect qui sera sélectionné. Si zéro, le troisième composant du premier vecteur est sélectionné. Dans le cas contraire, le composant du deuxième vecteur est sélectionné.

[in] VectorIndex3

Index qui détermine le vecteur dans XMVectorSelect qui sera sélectionné. Si zéro, le quatrième composant du premier vecteur est sélectionné. Dans le cas contraire, le composant du deuxième vecteur est sélectionné.

Valeur retournée

Retourne le vecteur de contrôle.

Remarques

Le pseudocode suivant illustre le fonctionnement de la fonction :

XMVECTOR    ControlVector;
const uint32_t  ControlElement[] =
            {
                XM_SELECT_0,
                XM_SELECT_1
            };

assert(VectorIndex0 < 2);
assert(VectorIndex1 < 2);
assert(VectorIndex2 < 2);
assert(VectorIndex3 < 2);

ControlVector.u[0] = ControlElement[VectorIndex0];
ControlVector.u[1] = ControlElement[VectorIndex1];
ControlVector.u[2] = ControlElement[VectorIndex2];
ControlVector.u[3] = ControlElement[VectorIndex3];

return ControlVector;

Configuration requise pour la plateforme

Microsoft Visual Studio 2010 ou Microsoft Visual Studio 2012 avec le Kit de développement logiciel (SDK) Windows pour Windows 8. Pris en charge pour les applications de bureau Win32, les applications du Windows Store et Windows Phone 8 applications.

Exemples

Utilisation de XMVectorSelectControl

Dans cet exemple, XMVectorSelectControl est utilisé pour générer un masque de contrôle qui sélectionnera les composants x et w du premier vecteur et les composants y et z du second.

Le résultat vectoriel sera ( 3.0f, 5.0f, 5.0f, 3.0f ).

XMVECTOR three = XMVectorReplicate( 3.0f );
XMVECTOR five = XMVectorReplicate( 5.0f );

XMVECTOR control = XMVectorSelectControl( 0, 1, 1, 0 );
XMVECTOR result = XMVectorSelect( three, five, control );

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	directxmath.h (inclure DirectXMath.h)

Voir aussi

Fonctions vectorielles basées sur les composants

XMVectorSelect

Partager via