Función D3DXVec3BaryCentric (D3dx9math.h)
Nota
La biblioteca de utilidades D3DX está en desuso. Se recomienda usar DirectXMath en su lugar.
Devuelve un punto en coordenadas Barycéntricas, utilizando los vectores 3D especificados.
Sintaxis
D3DXVECTOR3* D3DXVec3BaryCentric(
_Out_ D3DXVECTOR3 *pOut,
_In_ const D3DXVECTOR3 *pV1,
_In_ const D3DXVECTOR3 *pV2,
_In_ const D3DXVECTOR3 *pV3,
_In_ FLOAT f,
_In_ FLOAT g
);
Parámetros
-
pOut [out]
-
Tipo: D3DXVECTOR3*
Puntero a la estructura D3DXVECTOR3 que es el resultado de la operación.
-
pV1 [in]
-
Tipo: const D3DXVECTOR3*
Puntero a una estructura D3DXVECTOR3 de origen.
-
pV2 [in]
-
Tipo: const D3DXVECTOR3*
Puntero a una estructura D3DXVECTOR3 de origen.
-
pV3 [in]
-
Tipo: const D3DXVECTOR3*
Puntero a una estructura D3DXVECTOR3 de origen.
-
f [in]
-
Tipo: FLOAT
Factor de ponderación. Vea la sección Comentarios.
-
g [in]
-
Tipo: FLOAT
Factor de ponderación. Vea la sección Comentarios.
Valor devuelto
Tipo: D3DXVECTOR3*
Puntero a una estructura D3DXVECTOR3 en coordenadas Barycéntricas.
Observaciones
La función D3DXVec3BaryCentric proporciona una manera de comprender los puntos de un triángulo, independientemente de dónde se encuentra realmente el triángulo. Esta función devuelve el punto resultante mediante la siguiente ecuación: V1 + f(V2-V1) + g(V3-V1).
Cualquier punto del plano V1V2V3 se puede representar mediante la coordenada Barycentric (f,g). El parámetro f controla cuánto se pondera V2 en el resultado y el parámetro g controla cuánto se pondera V3 en el resultado. Por último, 1-f-g controla cuánto V1 se pondera en el resultado.
Tenga en cuenta las siguientes relaciones.
- Si (f>=0 &, & g>=0 &, & 1-f-g>=0), el punto está dentro del triángulo V1V2V3.
- Si (f==0 &, & g>=0 &, & 1-f-g>=0), el punto está en la línea V1V3.
- Si (f>=0 &, & g==0 &, & 1-f-g>=0), el punto está en la línea V1V2.
- Si (f>=0 &, & g>=0 &, & 1-f-g==0), el punto está en la línea V2V3.
Las coordenadas barycéntricas son una forma de coordenadas generales. En este contexto, el uso de coordenadas Barycentric representa un cambio en los sistemas de coordenadas. Lo que es cierto para las coordenadas cartesianas es true para las coordenadas Barycéntricas.
El valor devuelto de esta función es el mismo valor devuelto en el parámetro pOut . De este modo, la función D3DXVec3BaryCentric se puede usar como parámetro para otra función.
Las coordenadas Barycéntricas definen un punto dentro de un triángulo en términos de los vértices del triángulo. Para obtener una descripción más detallada de las coordenadas barycéntricas, vea Descripción de coordenadas barycéntricas de Mathworld.
Requisitos
| Requisito | Value |
|---|---|
| Encabezado |
|
| Biblioteca |
|
Consulte también