Funzione D3DXVec2BaryCentric (D3dx9math.h)
Nota
La libreria di utilità D3DX è deprecata. È consigliabile usare invece DirectXMath .
Restituisce un punto nelle coordinate barycentriche usando i vettori 2D specificati.
Sintassi
D3DXVECTOR2* D3DXVec2BaryCentric(
_Out_ D3DXVECTOR2 *pOut,
_In_ const D3DXVECTOR2 *pV1,
_In_ const D3DXVECTOR2 *pV2,
_In_ const D3DXVECTOR2 *pV3,
_In_ FLOAT f,
_In_ FLOAT g
);
Parametri
-
pOut [out]
-
Tipo: D3DXVECTOR2*
Puntatore alla struttura D3DXVECTOR2 che è il risultato dell'operazione.
-
pV1 [in]
-
Tipo: const D3DXVECTOR2*
Puntatore a una struttura D3DXVECTOR2 di origine.
-
pV2 [in]
-
Tipo: const D3DXVECTOR2*
Puntatore a una struttura D3DXVECTOR2 di origine.
-
pV3 [in]
-
Tipo: const D3DXVECTOR2*
Puntatore a una struttura D3DXVECTOR2 di origine.
-
f [in]
-
Tipo: FLOAT
Fattore di peso. Vedere la sezione Osservazioni.
-
g [in]
-
Tipo: FLOAT
Fattore di peso. Vedere la sezione Osservazioni.
Valore restituito
Tipo: D3DXVECTOR2*
Puntatore a una struttura D3DXVECTOR2 in coordinate barycentriche.
Commenti
La funzione D3DXVec2BaryCentric consente di comprendere i punti in e intorno a un triangolo, indipendentemente dalla posizione in cui si trova il triangolo. Questa funzione restituisce il punto risultante usando l'equazione seguente: V1 + f(V2-V1) + g(V3-V1).
Qualsiasi punto del 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 la quantità di V3 ponderata nel risultato. Infine, 1-f-g controlla la quantità di V1 ponderata 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 barycentriche sono una forma di coordinate generali. In questo contesto, l'uso di coordinate barycentriche rappresenta una modifica nei sistemi di coordinate. Ciò che contiene true per le coordinate cartesiane contiene true per le coordinate barycentriche.
Il valore restituito per questa funzione è lo stesso valore restituito nel parametro pOut . In questo modo, la funzione D3DXVec2BaryCentric 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 coordinate barycentriche di Mathworld. Questa risorsa potrebbe non essere disponibile in alcune lingue e paesi.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|
| Libreria |
|
Vedi anche