Funzione D3DXVec2BaryCentric (D3DX10Math.h)

Nota

La libreria di utilità D3DX10 è deprecata. È consigliabile usare invece DirectXMath .

Restituisce un punto nelle coordinate barycentriche utilizzando i vettori 2D specificati.

Sintassi

D3DXVECTOR2* D3DXVec2BaryCentric(
  _In_       D3DXVECTOR2 *pOut,
  _In_ const D3DXVECTOR2 *pV1,
  _In_ const D3DXVECTOR2 *pV2,
  _In_ const D3DXVECTOR2 *pV3,
  _In_       FLOAT       f,
  _In_       FLOAT       g
);

Parametri

pOut [in]

Tipo: D3DXVECTOR2*

Puntatore al D3DXVECTOR2 che è il risultato dell'operazione.

pV1 [in]

Tipo: const D3DXVECTOR2*

Puntatore a una struttura di D3DXVECTOR2 di origine.

pV2 [in]

Tipo: const D3DXVECTOR2*

Puntatore a una struttura di D3DXVECTOR2 di origine.

pV3 [in]

Tipo: const D3DXVECTOR2*

Puntatore a una struttura di D3DXVECTOR2 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: D3DXVECTOR2*

Puntatore a una struttura D3DXVECTOR2 in coordinate bariche.

Osservazioni:

La funzione D3DXVec2BaryCentric 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 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 delle coordinate barycentriche di Mathworld.

Requisiti

Requisito	Valore
Intestazione	D3DX10Math.h
Libreria	D3DX10.lib

Vedi anche

Funzioni matematiche