Microsoft DirectX 9.0 SDK Update (October 2004)

SphericalHarmonics.EvaluateSphericalLight Method

Language:

Note: This documentation is preliminary and is subject to change.

Evaluates a spherical light and returns spectral spherical harmonic (SH) data.

Overload List

public static void EvaluateSphericalLight(int, Vector3, float, float, float, float, GraphicsStream, GraphicsStream, GraphicsStream);
public static void EvaluateSphericalLight(int, Vector3, float, float, float, float, float[], float[], float[]);

Remarks

Evaluates a spherical light and returns spectral spherical harmonic (SH) data. There is no normalization of the intensity of the light like there is for directional lights, so care has to be taken when specifying the intensities. This will compute three spectral samples; redOutput will be returned, while greenOutput and blueOutput may be returned.

On the sphere with unit radius as shown, direction can be specified simply with theta, the angle about the z-axis in the right-handed direction, and phi, the angle from z.

Spherical Coordinates

The following equations show the relationship between Cartesian (x, y, z) and spherical (theta, phi) coordinates on the unit sphere. The angle theta varies over the range of 0 to 2 pi, while phi varies from 0 to pi.

Spherical Coordinates Equations

Exceptions
InvalidCallException The method call is invalid. For example, a method's parameter might contain an invalid value.


© 2004 Microsoft Corporation. All rights reserved. Terms of use.

Feedback? Please provide us with your comments on this topic.
For more help, visit the DirectX Developer Center