Función D3DXSHEvalDirection (D3DX10.h)

Nota

La biblioteca de utilidades D3DX (D3DX 9, D3DX 10 y D3DX 11) está en desuso y no es compatible con las aplicaciones de la Tienda Windows.

Nota

En lugar de usar esta función, se recomienda usar la función de biblioteca armónica esférica MathXMSHEvalDirection.

Evalúa las funciones base armónicas esféricas (SH) de un vector de dirección de entrada.

Sintaxis

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

Parámetros

pOut [in]

Tipo: FLOAT*

Puntero a los coeficientes de salida armónicos esféricos (SH). La evaluación genera coeficientes Order². Vea la sección Comentarios.

Order [in]

Tipo: UINT

Orden de evaluación de SH. Debe estar en el intervalo de D3DXSH_MINORDER para D3DXSH_MAXORDER, ambos incluidos. La evaluación genera coeficientes Order². El grado de evaluación es Order - 1.

pDir [in]

Tipo: const D3DXVECTOR3*

(x, y, z) vector de dirección en el que se evalúan las funciones de base sh. Debe normalizarse. Vea la sección Comentarios.

Valor devuelto

Tipo: FLOAT*

Puntero a coeficientes de salida SH. Vea la sección Comentarios.

Comentarios

Cada coeficiente de la función base Ylm se almacena en la ubicación de memoria l² + m + l, donde:

• l es el grado de la función base.
• m es el índice de función base para el valor l especificado y los intervalos de -l a l, ambos incluidos.

En la esfera con radio de unidad, como se muestra en la ilustración siguiente, la dirección se puede especificar simplemente con theta, el ángulo sobre el eje z en la dirección derecha y phi, el ángulo de z.

Las ecuaciones siguientes muestran la relación entre coordenadas cartesianas (x, y, z) y esféricas (theta, phi) en la esfera de unidad. El ángulo theta varía en el intervalo de 0 a 2 pi, mientras que phi varía de 0 a pi.

Requisitos

Requisito	Value
Encabezado	D3DX10.h
Biblioteca	D3DX10.lib

Consulte también

Funciones matemáticas