Función D3DXVec2BaryCentric (D3dx9math.h)

Devuelve un punto en coordenadas centradas en Barycentric, utilizando los vectores 2D especificados.

Sintaxis

D3DXVECTOR2* D3DXVec2BaryCentric(
  _Out_       D3DXVECTOR2 *pOut,
  _In_  const D3DXVECTOR2 *pV1,
  _In_  const D3DXVECTOR2 *pV2,
  _In_  const D3DXVECTOR2 *pV3,
  _In_        FLOAT       f,
  _In_        FLOAT       g
);

Parámetros

pOut [ out]

Tipo: D3DXVECTOR2*

Puntero a la estructura D3DXVECTOR2 que es el resultado de la operación.

pV1 [ En]

Tipo: const D3DXVECTOR2 *

Puntero a una estructura D3DXVECTOR2 de origen.

pV2 [ En]

Tipo: const D3DXVECTOR2 *

Puntero a una estructura D3DXVECTOR2 de origen.

pV3 [ En]

Tipo: const D3DXVECTOR2 *

Puntero a una estructura D3DXVECTOR2 de origen.

f [ in]

Tipo: FLOAT

Factor de ponderación. Vea la sección Comentarios.

g [ en]

Tipo: FLOAT

Factor de ponderación. Vea la sección Comentarios.

Valor devuelto

Tipo: D3DXVECTOR2*

Puntero a una estructura D3DXVECTOR2 en coordenadas centradas en baría.

Comentarios

La función D3DXVec2BaryCentric proporciona una manera de comprender los puntos dentro y alrededor 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 la cantidad de V2 que se pondera en el resultado y el parámetro g controla la cantidad de V3 que se pondera en el resultado. Por último, 1-f-g controla la cantidad de V1 que 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 baricéntricas representa un cambio en los sistemas de coordenadas. Lo que se aplica a las coordenadas cartesianas es true para las coordenadas baríntricas.

El valor devuelto para esta función es el mismo valor devuelto en el parámetro pOut. De este modo, la función D3DXVec2BaryCentric se puede usar como parámetro para otra función.

Las coordenadas barítricas 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 baricéntricas, vea Mathworld's Barycentric Coordinates Description. (Es posible que este recurso no esté disponible en algunos idiomas y países).

Requisitos

Requisito Value
Encabezado
D3dx9math.h
Biblioteca
D3dx9.lib

Consulte también

Funciones matemáticas