<!--
{
  "availability" : [
    "iOS: 27.0.0 -",
    "iPadOS: 27.0.0 -",
    "macCatalyst: 27.0.0 -",
    "macOS: 27.0.0 -",
    "tvOS: 27.0.0 -",
    "visionOS: 27.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "RealityKit",
  "identifier" : "/documentation/RealityKit/OcclusionCullingComponent",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "RealityKit"
    ],
    "preciseIdentifier" : "s:17RealityFoundation25OcclusionCullingComponentV"
  },
  "title" : "OcclusionCullingComponent"
}
-->

# OcclusionCullingComponent

A component that controls whether the system performs occlusion
culling on the owning Entity and its descendants.

```
struct OcclusionCullingComponent
```

## Overview

Occlusion culling can improve performance by skipping rendering
for entities that are fully hidden behind other geometry. Entities
are opted into this system by default.

This component can be used to disable occlusion culling for an
Entity hierarchy if it’s observed that culling produces incorrect
visuals. Such scenarios may include:

- Content that quickly moves in and out of occluded areas.
- Content that uses a Geometry Modifier to warp vertices outside
  of the mesh’s reported bounds.
- A camera teleports to a new location in a single frame and
  starts viewing the scene from a drastically different angle
  or position.

The enablement setting on this component will be applied
recursively to descendant Entities. A component added to a
descendant Entity will override any settings inherited from
its parent.

## Topics

### Creating a component

[`init(isEnabled:)`](/documentation/RealityKit/OcclusionCullingComponent/init(isEnabled:))

### Enabling occlusion culling

[`isEnabled`](/documentation/RealityKit/OcclusionCullingComponent/isEnabled)

Whether occlusion culling should be performed on this Entity and its children.


---

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)