D3DXVec3BaryCentric, fonction (D3dx9math. h)

Retourne un point dans les coordonnées Barycentric, à l’aide des vecteurs 3D spécifiés.

Syntaxe

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

Paramètres

moue [ à]

Type : D3DXVECTOR3*

Pointeur vers la structure D3DXVECTOR3 qui est le résultat de l’opération.

pV1 [ dans]

Type : const D3DXVECTOR3 *

Pointeur vers une structure D3DXVECTOR3 source.

pV2 [ dans]

Type : const D3DXVECTOR3 *

Pointeur vers une structure D3DXVECTOR3 source.

pV3 [ dans]

Type : const D3DXVECTOR3 *

Pointeur vers une structure D3DXVECTOR3 source.

f [ dans]

Type : float

Facteur de pondération. Consultez la section Notes.

g [ dans]

Type : float

Facteur de pondération. Consultez la section Notes.

Valeur de retour

Type : D3DXVECTOR3*

Pointeur vers une structure D3DXVECTOR3 dans les coordonnées Barycentric.

Notes

La fonction D3DXVec3BaryCentric fournit un moyen de comprendre les points dans et autour d’un triangle, indépendamment de l’endroit où le triangle est réellement situé. Cette fonction retourne le point résultant à l’aide de l’équation suivante : v1 + f (V2-V1) + g (v3-v1).

Tout point dans le plan V1V2V3 peut être représenté par la coordonnée Barycentric (f, g). Le paramètre f contrôle combien v2 est pondéré dans le résultat et le paramètre g contrôle combien v3 est pondéré dans le résultat. Enfin, 1-f-g contrôle la quantité de v1 qui est 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 Barycentric sont une forme de coordonnées générales. Dans ce contexte, l’utilisation de coordonnées Barycentric représente une modification des systèmes de coordonnées. Ce qui est vrai pour les coordonnées cartésiennes contient la valeur true pour les coordonnées Barycentric.

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

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

Configuration requise

Condition requise Valeur
En-tête
D3dx9math. h
Bibliothèque
D3dx9. lib

Voir aussi

Fonctions mathématiques