Função D3DXVec2BaryCentric (D3dx9math.h)

Observação

A biblioteca de utilitários D3DX foi preterida. Recomendamos que você use DirectXMath em vez disso.

Retorna um ponto em coordenadas Barycentric, usando os vetores 2D especificados.

Sintaxe

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*

Ponteiro para a estrutura D3DXVECTOR2 que é o resultado da operação.

pV1 [in]

Tipo: const D3DXVECTOR2*

Ponteiro para uma estrutura D3DXVECTOR2 de origem.

pV2 [in]

Tipo: const D3DXVECTOR2*

Ponteiro para uma estrutura D3DXVECTOR2 de origem.

pV3 [in]

Tipo: const D3DXVECTOR2*

Ponteiro para uma estrutura D3DXVECTOR2 de origem.

f [in]

Tipo: FLOAT

Fator de ponderação. Consulte Observações.

g [in]

Tipo: FLOAT

Fator de ponderação. Consulte Observações.

Valor retornado

Tipo: D3DXVECTOR2*

Ponteiro para uma estrutura D3DXVECTOR2 em coordenadas Barycentric.

Comentários

A função D3DXVec2BaryCentric fornece uma maneira de entender pontos dentro e ao redor de um triângulo, independentemente de onde o triângulo está realmente localizado. Essa função retorna o ponto resultante usando a seguinte equação: V1 + f(V2-V1) + g(V3-V1).

Qualquer ponto no plano V1V2V3 pode ser representado pela coordenada Barycentric (f,g). O parâmetro f controla a quantidade de V2 ponderada no resultado e o parâmetro g controla a quantidade de V3 ponderada no resultado. Por fim, o 1-f-g controla a quantidade de V1 ponderada no resultado.

Observe as relações a seguir.

  • Se (f>=0 &, & g>=0 &, & 1-f-g>=0), o ponto está dentro do triângulo V1V2V3.
  • Se (f==0 &, & g>=0 &, & 1-f-g>=0), o ponto está na linha V1V3.
  • Se (f>=0 &, & g==0 &, & 1-f-g>=0), o ponto está na linha V1V2.
  • Se (f>=0 &, & g>=0 &, & 1-f-g==0), o ponto está na linha V2V3.

As coordenadas baricêntricas são uma forma de coordenadas gerais. Nesse contexto, o uso de coordenadas Barycentric representa uma alteração nos sistemas de coordenadas. O que vale para coordenadas cartesianas vale para coordenadas Barycentric.

O valor retornado para essa função é o mesmo valor retornado no parâmetro pOut . Dessa forma, a função D3DXVec2BaryCentric pode ser usada como um parâmetro para outra função.

Coordenadas baricêntricas definem um ponto dentro de um triângulo em termos de vértices do triângulo. Para obter uma descrição mais detalhada das coordenadas baricêntricas, consulte a Descrição das Coordenadas Barycentricas da Mathworld. (Esse recurso pode não estar disponível em alguns idiomas e países.)

Requisitos

Requisito Valor
parâmetro
D3dx9math.h
Biblioteca
D3dx9.lib

Confira também

Funções matemáticas