Instance Property

ambientOcclusion

The attenuation of ambient light due to local geometry variations on a surface.

Declaration

@property(nonatomic, readonly, retain) MDLMaterialProperty *ambientOcclusion;

Discussion

Ambient occlusion (AO) describes the accessibility of a point on a surface to the surrounding radiant environment and is typically used to attenuate ambient lighting. A renderer should not use AO data should to affect direct illumination.

The default AO value is zero. Typically, you assign a texture (such as that created with the generateAmbientOcclusionTextureWithQuality:attenuationFactor:objectsToConsider:vertexAttributeNamed:materialPropertyNamed: method of a mesh) to this material property to add shading based on the shape of the mesh.

See Also

Working with Shading Properties

baseColor

The inherent color of the material, to be used as a modulator during shading.

emission

The color emitted as radiance from a material’s surface.

specular

The intensity of specular highlights on the material’s surface.

materialIndexOfRefraction

The index of refraction for the medium surrounding a material.

interfaceIndexOfRefraction

The index of refraction for a material itself.

normal

The variation in the surface normal vectors in a material, relative to model coordinate space.

ambientOcclusionScale

The scaling factor for ambient occlusion shading.