Funzione D3DXVec2BaryCentric (D3dx9math.h)

Restituisce un punto in 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 [ Cambio]

Tipo: D3DXVECTOR2*

Puntatore alla struttura D3DXVECTOR2 che rappresenta il risultato dell'operazione.

pV1 [ Pollici]

Tipo: const D3DXVECTOR2 *

Puntatore a una struttura D3DXVECTOR2 di origine.

pV2 [ Pollici]

Tipo: const D3DXVECTOR2 *

Puntatore a una struttura D3DXVECTOR2 di origine.

pV3 [ Pollici]

Tipo: const D3DXVECTOR2 *

Puntatore a una struttura 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 barycentriche.

Commenti

La funzione D3DXVec2BaryCentric consente di comprendere i punti all'interno e intorno a un triangolo, indipendentemente dalla posizione 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 barycentric (f,g). Il parametro f controlla quanto V2 viene ponderato 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 barycentriche sono una forma di coordinate generali. In questo contesto, l'uso di coordinate barycentric rappresenta una modifica nei sistemi di coordinate. Ciò che vale per le coordinate cartesiane è vero 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ù dettagliata delle coordinate barycentric, vedere Descrizione delle coordinate barycentriche di Mathworld. Questa risorsa potrebbe non essere disponibile in alcune lingue e paesi.

Requisiti

Requisito Valore
Intestazione
D3dx9math.h
Libreria
D3dx9.lib

Vedi anche

Funzioni matematiche