<!--
{
  "availability" : [
    "iOS: 13.0.0 -",
    "iPadOS: 13.0.0 -",
    "macCatalyst: 14.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "RealityKit",
  "identifier" : "/documentation/RealityKit/ARView/RenderOptions-swift.struct/disableAREnvironmentLighting",
  "metadataVersion" : "0.1.0",
  "role" : "Type Property",
  "symbol" : {
    "kind" : "Type Property",
    "modules" : [
      "RealityKit"
    ],
    "preciseIdentifier" : "s:10RealityKit6ARViewC13RenderOptionsV28disableAREnvironmentLightingAEvpZ"
  },
  "title" : "disableAREnvironmentLighting"
}
-->

# disableAREnvironmentLighting

Disable lighting from environment probes.

```
static let disableAREnvironmentLighting: ARView.RenderOptions
```

## Discussion

By default, RealityKit automatically creates light probes to record
the lighting conditions both globally, and at appropriate points in
the scene. The framework adjusts the complexity of the light probe
set to match the capabilities of the GPU. For example, it might use
only a global probe on less capable devices. It then applies
environment lighting to virtual objects based on the probes.

To disable this effect, add this option to the [`renderOptions`](/documentation/RealityKit/ARView/renderOptions-swift.property) set.

Alternatively, to use environment lighting but control the probes
manually, ensure the render option set doesn’t include this
option. Then configure the session for manual environment texturing,
using the
<doc://com.apple.documentation/documentation/ARKit/ARWorldTrackingConfiguration/EnvironmentTexturing-swift.enum/manual>
value.

For more information about creating and placing probes manually, see
<doc://com.apple.documentation/documentation/ARKit/adding-realistic-reflections-to-an-ar-experience>.

---

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)