Função D3DXVec3BaryCentric (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 3D especificados.
Sintaxe
D3DXVECTOR3* D3DXVec3BaryCentric(
_Out_ D3DXVECTOR3 *pOut,
_In_ const D3DXVECTOR3 *pV1,
_In_ const D3DXVECTOR3 *pV2,
_In_ const D3DXVECTOR3 *pV3,
_In_ FLOAT f,
_In_ FLOAT g
);
Parâmetros
-
pOut [out]
-
Tipo: D3DXVECTOR3*
Ponteiro para a estrutura D3DXVECTOR3 que é o resultado da operação.
-
pV1 [in]
-
Tipo: const D3DXVECTOR3*
Ponteiro para uma estrutura D3DXVECTOR3 de origem.
-
pV2 [in]
-
Tipo: const D3DXVECTOR3*
Ponteiro para uma estrutura D3DXVECTOR3 de origem.
-
pV3 [in]
-
Tipo: const D3DXVECTOR3*
Ponteiro para uma estrutura D3DXVECTOR3 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: D3DXVECTOR3*
Ponteiro para uma estrutura D3DXVECTOR3 em coordenadas Barycentric.
Comentários
A função D3DXVec3BaryCentric 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 D3DXVec3BaryCentric 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 |
|
| Biblioteca |
|
Confira também