Class

MDLAreaLight

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

Declaration

@interface MDLAreaLight : MDLPhysicallyPlausibleLight

Overview

Unlike other light sources that illuminate a scene from a single point or direction, an area light has a specific shape. The shape of an area light is a two-dimensional figure in the xy-plane of the light’s local coordinate space, and its illumination is directed in the negative z-axis direction (spreading out from that direction according to the inherited innerConeAngle and outerConeAngle properties).

Both the MDLAreaLight and MDLPhotometricLight classes can describe lights with interesting shapes. An area light offers a simpler design that can be implemented with better rendering performance, and a photometric light offers design that better models real-world light fixtures at the cost of higher computational complexity.

Topics

Managing a Light’s Shape

areaRadius

The radius, in units of local coordinate space, of the area from which light emanates.

aspect

The aspect ratio of the light’s shape.

superEllipticPower

A vector that controls the roundness of a superelliptical light in the x- and y-axis directions.

Relationships

See Also

Lights

MDLLight

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

MDLLightProbe

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

MDLLightProbeIrradianceDataSource

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

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.