Fungsi D3DXVec3BaryCentric (D3dx9math.h)

Catatan

Pustaka utilitas D3DX tidak digunakan lagi. Kami menyarankan agar Anda menggunakan DirectXMath sebagai gantinya.

Mengembalikan titik dalam koordinat Barycentric, menggunakan vektor 3D yang ditentukan.

Sintaks

D3DXVECTOR3* D3DXVec3BaryCentric(
  _Out_       D3DXVECTOR3 *pOut,
  _In_  const D3DXVECTOR3 *pV1,
  _In_  const D3DXVECTOR3 *pV2,
  _In_  const D3DXVECTOR3 *pV3,
  _In_        FLOAT       f,
  _In_        FLOAT       g
);

Parameter

pOut [out]

Jenis: D3DXVECTOR3*

Penunjuk ke struktur D3DXVECTOR3 yang merupakan hasil operasi.

pV1 [in]

Jenis: const D3DXVECTOR3*

Penunjuk ke struktur D3DXVECTOR3 sumber.

pV2 [in]

Jenis: const D3DXVECTOR3*

Penunjuk ke struktur D3DXVECTOR3 sumber.

pV3 [in]

Jenis: const D3DXVECTOR3*

Penunjuk ke struktur D3DXVECTOR3 sumber.

f [in]

Jenis: FLOAT

Faktor pembobotan. Lihat Keterangan.

g [in]

Jenis: FLOAT

Faktor pembobotan. Lihat Keterangan.

Nilai hasil

Jenis: D3DXVECTOR3*

Penunjuk ke struktur D3DXVECTOR3 dalam koordinat Barycentric.

Keterangan

Fungsi D3DXVec3BaryCentric menyediakan cara untuk memahami titik-titik dalam dan sekitar segitiga, terlepas dari di mana segitiga sebenarnya berada. Fungsi ini mengembalikan titik yang dihasilkan dengan menggunakan persamaan berikut: V1 + f(V2-V1) + g(V3-V1).

Setiap titik dalam bidang V1V2V3 dapat diwakili oleh koordinat Barycentric (f,g). Parameter f mengontrol berapa banyak V2 yang ditimbang ke dalam hasil dan parameter g mengontrol berapa banyak V3 yang ditimbang ke dalam hasilnya. Terakhir, 1-f-g mengontrol berapa banyak V1 yang ditimbang ke dalam hasilnya.

Perhatikan hubungan berikut.

• Jika (f>=0 &, & g>=0 &, & 1-f-g>=0), titik berada di dalam segitiga V1V2V3.
• Jika (f==0 &, & g>=0 &, & 1-f-g>=0), titiknya ada di baris V1V3.
• Jika (f>=0 &, & g==0 &, & 1-f-g>=0), titiknya ada di baris V1V2.
• Jika (f>=0 &, & g>=0 &, & 1-f-g==0), titiknya ada di baris V2V3.

Koordinat barycentric adalah bentuk koordinat umum. Dalam konteks ini, menggunakan koordinat Barycentric mewakili perubahan sistem koordinat. Apa yang berlaku untuk koordinat Kartesius berlaku untuk koordinat Barycentric.

Nilai pengembalian untuk fungsi ini adalah nilai yang sama yang dikembalikan dalam parameter pOut . Dengan cara ini, fungsi D3DXVec3BaryCentric dapat digunakan sebagai parameter untuk fungsi lain.

Koordinat barycentric mendefinisikan titik di dalam segitiga dalam hal sudut segitiga. Untuk deskripsi yang lebih mendalam tentang koordinat barycentric, lihat Deskripsi Koordinat Barycentric Mathworld.

Persyaratan

Persyaratan	Value
Header	D3dx9math.h
Pustaka	D3dx9.lib

Baca juga

Fungsi matematika