Fonction D3DXVec4BaryCentric (D3DX10Math.h)
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 |
|
Voir aussi