Função D3DXVec2BaryCentric (D3dx9math.h)

Observação

A biblioteca de utilitários D3DX foi preterida. Em vez disso, recomendamos que você use DirectXMath .

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, 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 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 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 vale para as 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.

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 barycentricas, confira Descrição das Coordenadas Barycentricas 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

Confira também

Funções Matemáticas