Fonction D3DXVec3BaryCentric (D3dx9math.h)
Notes
La bibliothèque utilitaire D3DX est déconseillée. Nous vous recommandons d’utiliser DirectXMath à la place.
Retourne un point en coordonnées barycentriques, à 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
-
pOut [out]
-
Type : D3DXVECTOR3*
Pointeur vers la structure D3DXVECTOR3 qui est le résultat de l’opération.
-
pV1 [in]
-
Type : const D3DXVECTOR3*
Pointeur vers une structure D3DXVECTOR3 source.
-
pV2 [in]
-
Type : const D3DXVECTOR3*
Pointeur vers une structure D3DXVECTOR3 source.
-
pV3 [in]
-
Type : const D3DXVECTOR3*
Pointeur vers une structure D3DXVECTOR3 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 : D3DXVECTOR3*
Pointeur vers une structure D3DXVECTOR3 en coordonnées barycentriques.
Notes
La fonction D3DXVec3BaryCentric 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 D3DXVec3BaryCentric 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 |
|
| Bibliothèque |
|
Voir aussi