Función D3DXVec3BaryCentric (D3DX10Math.h)

Nota:

La biblioteca de utilidades D3DX10 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(
  _In_       D3DXVECTOR3 *pOut,
  _In_ const D3DXVECTOR3 *pV1,
  _In_ const D3DXVECTOR3 *pV2,
  _In_ const D3DXVECTOR3 *pV3,
  _In_       FLOAT       f,
  _In_       FLOAT       g
);

Parámetros

pOut [in]

Tipo: D3DXVECTOR3*

Puntero al 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.

Comentarios

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	D3DX10Math.h

Consulte también

Funciones matemáticas