Funzione D3DXVec4BaryCentric (D3dx9math.h)
Nota
La libreria di utilità D3DX è deprecata. È consigliabile usare invece DirectXMath .
Restituisce un punto nelle coordinate barycentriche, utilizzando i vettori 4D specificati.
Sintassi
D3DXVECTOR4* D3DXVec4BaryCentric(
_Out_ D3DXVECTOR4 *pOut,
_In_ const D3DXVECTOR4 *pV1,
_In_ const D3DXVECTOR4 *pV2,
_In_ const D3DXVECTOR4 *pV3,
_In_ FLOAT f,
_In_ FLOAT g
);
Parametri
-
pOut [out]
-
Tipo: D3DXVECTOR4*
Puntatore alla struttura D3DXVECTOR4 risultante dall'operazione.
-
pV1 [in]
-
Tipo: const D3DXVECTOR4*
Puntatore a una struttura di D3DXVECTOR4 di origine.
-
pV2 [in]
-
Tipo: const D3DXVECTOR4*
Puntatore a una struttura di D3DXVECTOR4 di origine.
-
pV3 [in]
-
Tipo: const D3DXVECTOR4*
Puntatore a una struttura di D3DXVECTOR4 di origine.
-
f [in]
-
Tipo: FLOAT
Fattore di ponderazione. Vedere la sezione Osservazioni.
-
g [in]
-
Tipo: FLOAT
Fattore di ponderazione. Vedere la sezione Osservazioni.
Valore restituito
Tipo: D3DXVECTOR4*
Puntatore a una struttura D3DXVECTOR4 in coordinate bariche.
Osservazioni:
La funzione D3DXVec4BaryCentric consente di comprendere i punti in e intorno a un triangolo, indipendentemente dal punto in cui si trova effettivamente il triangolo. Questa funzione restituisce il punto risultante usando l'equazione seguente: V1 + f(V2-V1) + g(V3-V1).
Qualsiasi punto nel piano V1V2V3 può essere rappresentato dalla coordinata barycentrica (f,g). Il parametro f controlla la quantità di V2 ponderata nel risultato e il parametro g controlla quanto V3 viene ponderato nel risultato. Infine, 1-f-g controlla quanto V1 viene ponderato nel risultato.
Si notino le relazioni seguenti.
- Se (f>=0 &, & g>=0 &, & 1-f-g>=0), il punto si trova all'interno del triangolo V1V2V3.
- Se (f==0 &, & g>=0 &, & 1-f-g>=0), il punto si trova sulla riga V1V3.
- Se (f>=0 &, & g==0 &, & 1-f-g>=0), il punto si trova sulla riga V1V2.
- Se (f>=0 &, & g>=0 &, & 1-f-g==0), il punto si trova sulla riga V2V3.
Le coordinate bariche sono una forma di coordinate generali. In questo contesto, l'uso delle coordinate barycentriche rappresenta una modifica nei sistemi di coordinate. Ciò che contiene true per le coordinate cartesiane è true per le coordinate bariche.
Il valore restituito per questa funzione è lo stesso valore restituito nel parametro pOut . In questo modo, la funzione D3DXVec4BaryCentric può essere usata come parametro per un'altra funzione.
Le coordinate barycentriche definiscono un punto all'interno di un triangolo in termini di vertici del triangolo. Per una descrizione più approfondita delle coordinate barycentriche, vedere Descrizione delle coordinate barycentriche di Mathworld.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|
| Libreria |
|
Vedi anche