Função D3DXVec4BaryCentric (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 4D especificados.

Sintaxe

D3DXVECTOR4* D3DXVec4BaryCentric(
  _Out_       D3DXVECTOR4 *pOut,
  _In_  const D3DXVECTOR4 *pV1,
  _In_  const D3DXVECTOR4 *pV2,
  _In_  const D3DXVECTOR4 *pV3,
  _In_        FLOAT       f,
  _In_        FLOAT       g
);

Parâmetros

pOut [out]

Tipo: D3DXVECTOR4*

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

pV1 [in]

Tipo: const D3DXVECTOR4*

Ponteiro para uma estrutura D3DXVECTOR4 de origem.

pV2 [in]

Tipo: const D3DXVECTOR4*

Ponteiro para uma estrutura D3DXVECTOR4 de origem.

pV3 [in]

Tipo: const D3DXVECTOR4*

Ponteiro para uma estrutura D3DXVECTOR4 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: D3DXVECTOR4*

Ponteiro para uma estrutura D3DXVECTOR4 em coordenadas Barycentric.

Comentários

A função D3DXVec4BaryCentric 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 D3DXVec4BaryCentric 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.

Requisitos

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

Confira também

Funções Matemáticas