Fonction XMVectorInsert (directxmath.h)

Article
02/29/2024

Fait pivoter un vecteur à partir d’un nombre donné de composants 32 bits et insère les éléments sélectionnés de ce résultat dans un autre vecteur.

Syntaxe

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;

Paramètres

[in] VD

Vecteur dans laquelle insérer.

[in] VS

Vecteur à pivoter vers la gauche.

[in] VSLeftRotateElements

Nombre de composants 32 bits selon lesquels faire pivoter VS vers la gauche.

[in] Select0

0 ou 1. Le cas échéant, le composant x du vecteur pivoté est inséré dans le composant VD correspondant. Sinon, le composant x de VD est laissé seul.

[in] Select1

0 ou 1. Le cas échéant, le composant y du vecteur pivoté est inséré dans le composant VD correspondant. Sinon, le composant y de VD est laissé seul.

[in] Select2

0 ou 1. Le cas échéant, le composant z du vecteur pivoté est inséré dans le composant VD correspondant. Sinon, le composant z de VD est laissé seul.

[in] Select3

0 ou 1. Le cas échéant, le composant w du vecteur pivoté est inséré dans le composant VD correspondant. Sinon, le composant w de VD est laissé seul.

Valeur retournée

Retourne le XMVECTOR qui résulte de la rotation et de l’insertion.

Remarques

Pour de meilleures performances, le résultat de XMVectorInsert doit être réaffecté à VD.

Pour les cas avec des paramètres de uint32_t constants, il est plus efficace d’utiliser la forme de modèle de XMVectorInsert :


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

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.