A cube map texture that depicts the environment surrounding the scene’s contents, used for advanced lighting effects.
SDKs
- iOS 10.0+
- macOS 10.12+
- Mac Catalyst 13.0+
- tvOS 10.0+
- watchOS 3.0+
Framework
- Scene
Kit
Declaration
@property(nonatomic, readonly) SCNMaterial Property *lightingEnvironment;
Discussion
When rendering materials with the SCNLighting
lighting model, SceneKit illuminates surfaces differently according to the environment that surrounds them. For example, with physically based shading, even a diffuse surface takes on some color from the sky above it and the ground below it.
Tip
For realistic results, reuse the same contents for both the lighting environment and the background
property.
For information about defining cube maps, see the discussion of the contents
property.