Fungsi XMVectorPermute (directxmath.h)

Permutes komponen dari dua vektor untuk membuat vektor baru.

Sintaks

XMVECTOR XM_CALLCONV XMVectorPermute(
  [in] FXMVECTOR V1,
  [in] FXMVECTOR V2,
       uint32_t  PermuteX,
       uint32_t  PermuteY,
       uint32_t  PermuteZ,
       uint32_t  PermuteW
) noexcept;

Parameter

[in] V1

Vektor pertama.

[in] V2

Vektor kedua.

PermuteX

Formulir indeks 0-7 menunjukkan dari mana komponen X vektor baru harus disalin.

PermuteY

Formulir indeks 0-7 menunjukkan dari mana komponen Y dari vektor baru harus disalin.

PermuteZ

Formulir indeks 0-7 menunjukkan dari mana komponen Z vektor baru harus disalin.

PermuteW

Formulir indeks 0-7 menunjukkan dari mana komponen W vektor baru harus disalin.

Nilai kembali

Mengembalikan vektor yang dianiaya yang dihasilkan dari menggabungkan vektor sumber.

Keterangan

Jika semua 4 indeks hanya mereferensikan satu vektor (yaitu semuanya dalam rentang 0-3 atau semua dalam rentang 4-7), gunakan XMVectorSwizzle sebagai gantinya untuk performa yang lebih baik.

Konstanta XM_PERMUTE_ disediakan untuk digunakan sebagai nilai input untuk PermuteX,PermuteY,PermuteZ, dan PermuteW.

Untuk parameter PermuteX/Y/Z/W yang konstan, jauh lebih efisien untuk menggunakan bentuk templat XMVectorPermute:

template<uint32_t PermuteX, uint32_t PermuteY, uint32_t PermuteZ, uint32_t PermuteW>
    XMVECTOR XMVectorPermute(FXMVECTOR V1, FXMVECTOR V2)

Example: XMVectorPermute<XM_PERMUTE_0Z, XM_PERMUTE_1X, XM_PERMUTE_0W, XM_PERMUTE_1Y>( V1, V2 );
   

Catatan Versi XMVectorPermute ini baru untuk DirectXMath. Pustaka XNAMath v2.x menggunakan XMVectorPermuteControl, kontrol XMVECTOR alih-alih 4 indeks untuk XMVectorPermute, dan menggunakan nilai yang berbeda untuk konstanta XM_PERMUTE_x.

 

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.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	directxmath.h (termasuk DirectXMath.h)

Lihat juga

Fungsi Vektor Component-Wise

XMVectorSwizzle