A Boolean value that determines whether the material responds identically to both ambient and diffuse lighting. Animatable.
- iOS 8.0+
- macOS 10.8+
- Mac Catalyst 13.0+
- tvOS 9.0+
- watchOS 3.0+
When modeling real-world lighting, a surface is typically considered to have a single “base” color or texture that is visible under both ambient and diffuse light. When this property’s value is
NO, SceneKit does not have this limitation: you may use a material’s
diffuse property to provide a color or texture that is visible under direct lighting, and its
ambient property to provide a different color or texture for areas not directly illuminated.
When this property’s value is
YES, or when using the
SCNLighting shading mode, SceneKit uses the
diffuse property for ambient lighting, ignoring the
ambient property and ensuring that the material responds identically to both ambient and diffuse light.
The default value for this property is
YES for new apps on all platforms. (In OS X v10.9 and earlier, the default value is
You can animate changes to this property’s value. See Animating SceneKit Content. Animating this property fades between the results of rendering with each state.