D3DXVec2BaryCentric, fonction (D3DX10Math.h)

  • Article

Notes

La bibliothèque utilitaire D3DX10 est déconseillée. Nous vous recommandons d’utiliser DirectXMath à la place.

Retourne un point en coordonnées barycentriques, à l’aide des vecteurs 2D spécifiés.

Syntaxe

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

Paramètres

pOut [in]

Type : D3DXVECTOR2*

Pointeur vers le D3DXVECTOR2 qui est le résultat de l’opération.

pV1 [in]

Type : const D3DXVECTOR2*

Pointeur vers une structure D3DXVECTOR2 source.

pV2 [in]

Type : const D3DXVECTOR2*

Pointeur vers une structure D3DXVECTOR2 source.

pV3 [in]

Type : const D3DXVECTOR2*

Pointeur vers une structure D3DXVECTOR2 source.

f [in]

Type : FLOAT

Facteur de pondération. Consultez la section Notes.

g [in]

Type : FLOAT

Facteur de pondération. Consultez la section Notes.

Valeur de retour

Type : D3DXVECTOR2*

Pointeur vers une structure D3DXVECTOR2 en coordonnées barycentriques.

Notes

La fonction D3DXVec2BaryCentric permet de comprendre les points dans et autour d’un triangle, indépendamment de l’emplacement réel du triangle. Cette fonction retourne le point résultant à l’aide de l’équation suivante : V1 + f(V2-V1) + g(V3-V1).

N’importe quel point du plan V1V2V3 peut être représenté par la coordonnée barycentrique (f,g). Le paramètre f contrôle la pondération de V2 dans le résultat, et le paramètre g contrôle la pondération de V3 dans le résultat. Enfin, 1-f-g contrôle la quantité de V1 pondérée dans le résultat.

Notez les relations suivantes.

  • Si (f>=0 &, & g>=0 &, & 1-f-g>=0), le point se trouve à l’intérieur du triangle V1V2V3.
  • Si (f==0 &, & g>=0 &, & 1-f-g>=0), le point se trouve sur la ligne V1V3.
  • Si (f>=0 &, & g==0 &, & 1-f-g>=0), le point se trouve sur la ligne V1V2.
  • Si (f>=0 &, & g>=0 &, & 1-f-g==0), le point se trouve sur la ligne V2V3.

Les coordonnées barycentriques sont une forme de coordonnées générales. Dans ce contexte, l’utilisation de coordonnées barycentriques représente un changement dans les systèmes de coordonnées. Ce qui est vrai pour les coordonnées cartésiennes est vrai pour les coordonnées barycentriques.

La valeur de retour pour cette fonction est la même valeur retournée dans le paramètre pOut. De cette façon, la fonction D3DXVec2BaryCentric peut être utilisée comme paramètre pour une autre fonction.

Les coordonnées barycentriques définissent un point à l’intérieur d’un triangle en termes de sommets du triangle. Pour obtenir une description plus détaillée des coordonnées barycentriques, consultez Description des coordonnées barycentriques de Mathworld.

Configuration requise

Condition requise Valeur
En-tête
D3DX10Math.h
Bibliothèque
D3DX10.lib

Voir aussi

Fonctions mathématiques