Função D3DXVec2BaryCentric (D3dx9math. h)

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 [ fora]

Tipo: D3DXVECTOR2*

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

pV1 [ no]

Tipo: const D3DXVECTOR2 *

Ponteiro para uma estrutura de D3DXVECTOR2 de origem.

pV2 [ no]

Tipo: const D3DXVECTOR2 *

Ponteiro para uma estrutura de D3DXVECTOR2 de origem.

pV3 [ no]

Tipo: const D3DXVECTOR2 *

Ponteiro para uma estrutura de D3DXVECTOR2 de origem.

f [ em]

Tipo: float

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

g [ em]

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 os pontos em um triângulo, independentemente de onde o triângulo realmente está localizado. Essa função retorna o ponto resultante usando a seguinte equação: v1 + f (v2-v1) + g (v3-v1).

Qualquer ponto no V1V2V3 do plano pode ser representado pela coordenada barycentric (f, g). O parâmetro f controla a quantidade de v2 que é ponderada no resultado, e o parâmetro g controla a quantidade de v3 ponderada no resultado. Por fim, 1-f-g controla o quanto v1 é ponderado no resultado.

Observe as seguintes relações.

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

As coordenadas de barycentric são uma forma de coordenadas gerais. Nesse contexto, o uso de coordenadas barycentric representa uma alteração nos sistemas de coordenadas. O que se aplica a coordenadas cartesianas é verdadeiro para coordenadas Barycentrics.

O valor de retorno 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.

As coordenadas barycentric definem um ponto dentro de um triângulo em termos dos vértices do triângulo. Para obter uma descrição mais detalhada das coordenadas de barycentric, consulte Descrição de coordenadas barycentric do 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

Consulte também

Funções matemáticas