<!--
{
  "availability" : [
    "iOS: 8.0.0 - 26.0.0",
    "iPadOS: 8.0.0 - 26.0.0",
    "macCatalyst: 13.1.0 - 26.0.0",
    "macOS: 10.8.0 - 26.0.0",
    "tvOS: 9.0.0 - 26.0.0",
    "visionOS: 1.0.0 - 26.0.0",
    "watchOS: 3.0.0 - 26.0.0"
  ],
  "documentType" : "symbol",
  "framework" : "SceneKit",
  "identifier" : "/documentation/SceneKit/SCNMaterial/selfIllumination",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "SceneKit"
    ],
    "preciseIdentifier" : "c:objc(cs)SCNMaterial(py)selfIllumination"
  },
  "title" : "selfIllumination"
}
-->

# selfIllumination

An object that provides color values representing the global illumination of the surface.

```
var selfIllumination: SCNMaterialProperty { get }
```

## Discussion

Self-illumination applies to all materials, but is especially useful for those using physically-based shading (see [`physicallyBased`](/documentation/SceneKit/SCNMaterial/LightingModel-swift.struct/physicallyBased)). Physically-based materials work best with environment-based lighting (see the [`SCNScene`](/documentation/SceneKit/SCNScene) property [`lightingEnvironment`](/documentation/SceneKit/SCNScene/lightingEnvironment)), but for some materials it can be useful to let a surface itself define part of its lighting—for example, an object whose position obscures it from the “sky” that provides the main lighting environment. When you assign contents to this property, they override the environmental lighting contribution to diffuse shading, but environmental lighting still contributes to specular effects.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)