Funzione D3DXVec3BaryCentric (D3DX10Math.h)

  • Articolo

Nota

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

Restituisce un punto nelle coordinate bariche, utilizzando i vettori 3D specificati.

Sintassi

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

Parametri

pOut [in]

Tipo: D3DXVECTOR3*

Puntatore al D3DXVECTOR3 che è il risultato dell'operazione.

pV1 [in]

Tipo: const D3DXVECTOR3*

Puntatore a una struttura di D3DXVECTOR3 di origine.

pV2 [in]

Tipo: const D3DXVECTOR3*

Puntatore a una struttura di D3DXVECTOR3 di origine.

pV3 [in]

Tipo: const D3DXVECTOR3*

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

Puntatore a una struttura D3DXVECTOR3 in coordinate bariche.

Osservazioni:

La funzione D3DXVec3BaryCentric 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 D3DXVec3BaryCentric 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

Vedi anche

Funzioni matematiche