Fungsi XMVectorInsert (directxmath.h)

Artikel
08/23/2023

Memutar vektor yang dibiarkan oleh sejumlah komponen 32-bit tertentu dan menyisipkan elemen yang dipilih dari hasil tersebut ke vektor lain.

Sintaks

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;

Parameter

[in] VD

Vektor untuk dimasukkan ke dalam.

[in] VS

Vektor untuk memutar ke kiri.

[in] VSLeftRotateElements

Jumlah komponen 32-bit untuk memutar VS ke kiri.

[in] Select0

Baik 0 atau 1. Jika satu, komponen x dari vektor yang diputar akan dimasukkan ke dalam komponen VD yang sesuai. Jika tidak, komponen x VD dibiarkan saja.

[in] Select1

Baik 0 atau 1. Jika satu, komponen y dari vektor yang diputar akan dimasukkan ke dalam komponen VD yang sesuai. Jika tidak, komponen y VD dibiarkan saja.

[in] Select2

Baik 0 atau 1. Jika satu, komponen z dari vektor yang diputar akan dimasukkan ke dalam komponen VD yang sesuai. Jika tidak, komponen z VD dibiarkan saja.

[in] Select3

Baik 0 atau 1. Jika satu, komponen w dari vektor yang diputar akan dimasukkan ke dalam komponen VD yang sesuai. Jika tidak, komponen w VD dibiarkan saja.

Mengembalikan nilai

Mengembalikan XMVECTOR yang dihasilkan dari rotasi dan penyisipan.

Keterangan

Untuk performa terbaik, hasil XMVectorInsert harus ditetapkan kembali ke VD.

Untuk kasus dengan parameter uint32_t konstan, lebih efisien untuk menggunakan bentuk templat XMVectorInsert:


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

Persyaratan Platform

Microsoft Visual Studio 2010 atau Microsoft Visual Studio 2012 dengan Windows SDK untuk Windows 8. Didukung untuk aplikasi desktop Win32, aplikasi Windows Store, dan aplikasi Windows Phone 8.