<!--
{
  "availability" : [
    "iOS: 18.0.0 -",
    "iPadOS: 18.0.0 -",
    "macCatalyst: 18.0.0 -",
    "macOS: 15.0.0 -",
    "tvOS: 26.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "RealityKit",
  "identifier" : "/documentation/RealityKit/PortalComponent/init(target:clippingPlane:)",
  "metadataVersion" : "0.1.0",
  "role" : "Initializer",
  "symbol" : {
    "kind" : "Initializer",
    "modules" : [
      "RealityKit"
    ],
    "preciseIdentifier" : "s:17RealityFoundation15PortalComponentV6target13clippingPlaneAcA6EntityC_AC08ClippingG0VSgtcfc"
  },
  "title" : "init(target:clippingPlane:)"
}
-->

# init(target:clippingPlane:)

Creates a portal component with a target entity and an optional clipping plane.

```
init(target: Entity, clippingPlane: PortalComponent.ClippingPlane? = nil)
```

## Parameters

`target`

A target world entity the portal is looking into.

`clippingPlane`

A planar representation of a portal to enable the clipping feature.
When `nil`, [`clippingMode`](/documentation/RealityKit/PortalComponent/clippingMode-swift.property) is [`PortalComponent.ClippingMode.disabled`](/documentation/RealityKit/PortalComponent/ClippingMode-swift.enum/disabled).

## Discussion

This initializes the [`PortalComponent`](/documentation/RealityKit/PortalComponent) with the given target entity,
and an optional clipping plane.
The target entity needs a [`WorldComponent`](/documentation/RealityKit/WorldComponent) in its component set.

To render a portal, an entity needs a [`PortalComponent`](/documentation/RealityKit/PortalComponent) and a
[`ModelComponent`](/documentation/RealityKit/ModelComponent), using one or more [`PortalMaterial`](/documentation/RealityKit/PortalMaterial) instances.

This initializer is equivalent to setting [`clippingMode`](/documentation/RealityKit/PortalComponent/clippingMode-swift.property) with
the corresponding [`PortalComponent.Plane`](/documentation/RealityKit/PortalComponent/Plane), leaving [`crossingMode`](/documentation/RealityKit/PortalComponent/crossingMode-swift.property)
at [`PortalComponent.CrossingMode.disabled`](/documentation/RealityKit/PortalComponent/CrossingMode-swift.enum/disabled).

For new code, prefer [`init(target:clippingMode:crossingMode:)`](/documentation/RealityKit/PortalComponent/init(target:clippingMode:crossingMode:)), which lets you configure
clipping and crossing together and supports volumetric 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)