<!--
{
  "availability" : [
    "iOS: 13.0.0 -",
    "iPadOS: 13.0.0 -",
    "macCatalyst: 13.0.0 -",
    "macOS: 10.15.0 -",
    "tvOS: 26.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "RealityKit",
  "identifier" : "/documentation/RealityKit/DirectionalLightComponent/isRealWorldProxy",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "RealityKit"
    ],
    "preciseIdentifier" : "s:17RealityFoundation25DirectionalLightComponentV16isRealWorldProxySbvp"
  },
  "title" : "isRealWorldProxy"
}
-->

# isRealWorldProxy

A Boolean that you use to control whether the directional light operates
as a proxy for a real-world light.

```
var isRealWorldProxy: Bool
```

## Discussion

Set the value to `true` when you want the light to cast shadows on
virtual content without illuminating anything in the scene. You can use
this to create shadows on occlusion materials that accept dynamic
lighting.

---

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)