Función D3DXVec2BaryCentric (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 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 [in]

Tipo: const D3DXVECTOR2*

Puntero a una estructura D3DXVECTOR2 de origen.

pV2 [in]

Tipo: const D3DXVECTOR2*

Puntero a una estructura D3DXVECTOR2 de origen.

pV3 [in]

Tipo: const D3DXVECTOR2*

Puntero a una estructura D3DXVECTOR2 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: D3DXVECTOR2*

Puntero a una estructura D3DXVECTOR2 en coordenadas Barycéntricas.

Observaciones

La función D3DXVec2BaryCentric 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 Barycéntricas 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 D3DXVec2BaryCentric 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. (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