Instance Method


Generates spherical harmonics information based on the light’s photometry data.


- (void)generateSphericalHarmonicsFromLight:(NSUInteger)sphericalHarmonicsLevel;



The number of levels for which to generate spherical harmonics. Each level of spherical harmonics contains more coefficients, affecting both the layout of the resulting data and the detail of any lighting effects based on it.


Spherical harmonic coefficients describe the distribution of light around a light source with less high-frequency detail than a cube map texture, but they can be used more efficiently in real-time rendering. After calling this method, use the sphericalHarmonicsCoefficients property to access the generated coefficients.

See Also

Interpreting the Light Web as Spherical Harmonics


Data containing spherical harmonics coefficients that describe the light’s intensity in all directions.


The number of levels of generated spherical harmonics information.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software