Função D3DXSHEvalDirection (D3dx9math.h)

Observação

A biblioteca de utilitários D3DX (D3DX 9, D3DX 10 e D3DX 11) foi preterida e não tem suporte para aplicativos da Windows Store.

Observação

Em vez de usar essa função, recomendamos que você use a função de biblioteca matemática harmônica esféricaXMSHEvalDirection.

Avalia as funções base harmônicas esféricas (SH) de um vetor de direção de entrada.

Sintaxe

FLOAT* D3DXSHEvalDirection(
  _Out_       FLOAT       *pOut,
  _In_        UINT        Order,
  _In_  const D3DXVECTOR3 *pDir
);

Parâmetros

pOut [out]

Tipo: FLOAT*

Ponteiro para coeficientes de saída de SH (harmônico esférico). A avaliação gera coeficientes order². Consulte Observações.

Ordem [in]

Tipo: UINT

Ordem da avaliação de SH. Deve estar no intervalo de D3DXSH_MINORDER para D3DXSH_MAXORDER, inclusive. A avaliação gera coeficientes order². O grau da avaliação é Order – 1.

pDir [in]

Tipo: const D3DXVECTOR3*

(x, y, z) vetor de direção no qual avaliar as funções de base SH. Deve ser normalizado. Consulte Observações.

Valor retornado

Tipo: FLOAT*

Ponteiro para coeficientes de saída sh. Consulte Observações.

Comentários

Cada coeficiente da função base Ylm é armazenado no local da memória l² + m + l, em que:

  • l é o grau da função base.
  • m é o índice de função base para o valor l fornecido e varia de -l a l, inclusive.

Na esfera com raio de unidade, conforme mostrado na ilustração a seguir, a direção pode ser especificada simplesmente com theta, o ângulo sobre o eixo z na direção à direita e phi, o ângulo de z.

ilustração de uma esfera com raio de unidade

As equações a seguir mostram a relação entre as coordenadas Cartesian (x, y, z) e esféricas (theta, phi) na esfera de unidade. Aeta angular varia acima do intervalo de 0 a 2 pi, enquanto phi varia de 0 a pi.

equações da relação entre coordenadas cartesianas e esféricas

Requisitos

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

Confira também

Funções Matemáticas

Transferência de radiação pré-compilada (Direct3D 9)