An object that manages the material’s response to ambient lighting.
- iOS 8.0+
- macOS 10.8+
- Mac Catalyst 13.0+Beta
- tvOS 9.0+
- watchOS 3.0+
Ambient shading describes the amount and color of ambient light reflected by the material. Ambient shading is uniform in all directions at all points on a surface. If a scene does not contain lights whose type is
ambient, this property has no effect on a material’s appearance.
By default, the ambient property’s
contents object is a dark gray color. Changing the ambient property’s contents lets you specify a different color or texture for the areas of a surface not directly illuminated by lights in a scene. To make the material respond identically to both ambient and diffuse light, set its
locks property to
The figure below shows a material (with a texture for its
diffuse property) before and after setting the ambient property’s contents to a solid color.
lighting property determines the formula SceneKit uses to combine its ambient color and other visual properties with lights and other contents in a scene to produce the final color for each rendered pixel in the rendered scene. For details, see Lighting Models.
This material property does not apply to physically-based materials (see