XMVectorInsert 函式 (directxmath.h)

發行項
02/29/2024

將向量向左旋轉指定的32位元件數目，並將該結果的選取專案插入另一個向量。

語法

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;

參數

[in] VD

要插入的向量。

[in] VS

向量以向左旋轉。

[in] VSLeftRotateElements

要向左旋轉 VS 的 32 位元件數目。

[in] Select0

0 或 1。如果有的話，旋轉向量的 x 元件將會插入 VD 的對應元件。否則， VD 的 x 元件會單獨保留。

[in] Select1

0 或 1。如果有的話，旋轉向量的 Y 元件將會插入 VD 的對應元件中。否則， VD 的 Y 元件會單獨保留。

[in] Select2

0 或 1。如果有的話，旋轉向量的 z 元件將會插入 VD 的對應元件。否則， VD 的 z元件會單獨保留。

[in] Select3

0 或 1。如果有的話，旋轉向量的 w 元件將會插入 VD 的對應元件。否則， VD 的 w 元件會單獨保留。

傳回值

傳回從旋轉和插入產生的 XMVECTOR 。

備註

為了獲得最佳效能，應該將 XMVectorInsert 的結果指派回 VD。

對於常數uint32_t參數的情況，使用 XMVectorInsert 的範本形式會更有效率：


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