Fonction D3DXVec4BaryCentric (D3DX10Math.h)

  • Article

Notes

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

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

Syntaxe

D3DXVECTOR4* D3DXVec4BaryCentric(
  _In_       D3DXVECTOR4 *pOut,
  _In_ const D3DXVECTOR4 *pV1,
  _In_ const D3DXVECTOR4 *pV2,
  _In_ const D3DXVECTOR4 *pV3,
  _In_       FLOAT       f,
  _In_       FLOAT       g
);

Paramètres

pOut [in]

Type : D3DXVECTOR4*

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

pV1 [in]

Type : const D3DXVECTOR4*

Pointeur vers une structure D3DXVECTOR4 source.

pV2 [in]

Type : const D3DXVECTOR4*

Pointeur vers une structure D3DXVECTOR4 source.

pV3 [in]

Type : const D3DXVECTOR4*

Pointeur vers une structure D3DXVECTOR4 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 : D3DXVECTOR4*

Pointeur vers une structure D3DXVECTOR4 en coordonnées barycentriques.

Notes

La fonction D3DXVec4BaryCentric 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 de cette fonction est la même valeur retournée dans le paramètre pOut. De cette façon, la fonction D3DXVec4BaryCentric 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.

Spécifications

Condition requise Valeur
En-tête
D3DX10Math.h

Voir aussi

Fonctions mathématiques