<!--
{
  "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/ClippingComponent",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "RealityKit"
    ],
    "preciseIdentifier" : "s:17RealityFoundation17ClippingComponentV"
  },
  "title" : "ClippingComponent"
}
-->

# ClippingComponent

A component that clips entities and their children to a customizable bounding box volume with feathered edges.

```
struct ClippingComponent
```

## Overview

The `ClippingComponent` provides a powerful and performant way to clip content in RealityKit.
It’s particularly useful for:

- Creating soft-edge effects with feathered boundaries instead of hard cuts
- Creating polished spatial experiences with hierarchical clipping control

Add a `ClippingComponent` to an entity by passing it to an entity’s
`Entity/ComponentSet/set()` method.

```swift
let windowEntity = Entity()

let bounds = BoundingBox(min: SIMD3<Float>(-10, -10, -10), max: SIMD3<Float>(10, 10, 10))
var clipping = ClippingComponent(bounds: bounds)
clipping.featheredEdge.falloff = .linear
clipping.featheredEdge.positiveEdgeInset = [2, 2, 0.0]  // 2-unit feather zone on +X & +Y edges
clipping.featheredEdge.negativeEdgeInset = [0.0, 0.0, 0.0]  // no feathering on negative edges
clipping.shouldClipSelf = true
clipping.shouldClipChildren = true

windowEntity.components.set(clipping)
```

## Topics

### Creating a clipping component

[`init(bounds:)`](/documentation/RealityKit/ClippingComponent/init(bounds:))

### Configuring clipping behavior

[`shouldClipChildren`](/documentation/RealityKit/ClippingComponent/shouldClipChildren)

Controls whether child entities are clipped by this component’s bounds.

[`shouldClipSelf`](/documentation/RealityKit/ClippingComponent/shouldClipSelf)

Controls whether the entity itself is clipped by this component’s bounds.

### Feathering clipped edges

[`featheredEdge`](/documentation/RealityKit/ClippingComponent/featheredEdge-swift.property)

The feathering configuration for the clipping boundaries.

[`ClippingComponent.FeatheredEdge`](/documentation/RealityKit/ClippingComponent/FeatheredEdge-swift.struct)

Configuration for feathering the clipping boundaries.



---

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)