Protocol

MDLLightProbeIrradianceDataSource

Adopt this protocol to provide information for use in automatic placement of light probes around a scene.

Declaration

@protocol MDLLightProbeIrradianceDataSource

Overview

The MDLAsset placeLightProbesWithDensity:heuristic:usingIrradianceDataSource: method automatically creates MDLLightProbe objects, setting their positions and lighting parameters to provide optimal light probe coverage within a scene you define. When you use that method, you must provide an object implementing this protocol, which Model I/O queries in order to evaluate your scene.

Topics

Providing Light Probe Information

boundingBox

The bounding region of the scene to which light probes are being added.

Required.

sphericalHarmonicsLevel

The number of levels of spherical harmonics information provided by the data source.

- sphericalHarmonicsCoefficientsAtPosition:

Asks the data source to provide spherical harmonics coefficients that describe lighting conditions in all directions from the specified point in a scene.

Relationships

Inherits From

See Also

Lights

MDLLight

The abstract superclass for objects that describe light sources in a scene.

MDLAreaLight

A light source that illuminates a 3D scene from an area with a specific shape.

MDLLightProbe

A light source described in terms of the variations in color and intensity of its illumination in all directions.

MDLPhotometricLight

A light source whose shape, direction, and intensity of illumination are determined by a photometric profile.

MDLPhysicallyPlausibleLight

A light source for use in shading models based on real-world physics.

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