<!--
{
  "availability" : [
    "iOS: 18.0.0 -",
    "iPadOS: 18.0.0 -",
    "macCatalyst: 18.0.0 -",
    "macOS: 15.0.0 -",
    "tvOS: 26.0.0 -",
    "visionOS: 2.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "RealityKit",
  "identifier" : "/documentation/RealityKit/PortalComponent/Plane",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "RealityKit"
    ],
    "preciseIdentifier" : "s:17RealityFoundation15PortalComponentV5PlaneV"
  },
  "title" : "PortalComponent.Plane"
}
-->

# PortalComponent.Plane

A representation of a portal as an infinite plane.

```
struct Plane
```

## Overview

Enable the corresponding clipping and crossing features by passing this value in
[`PortalComponent.ClippingMode.plane(_:)`](/documentation/RealityKit/PortalComponent/ClippingMode-swift.enum/plane(_:)) or
[`PortalComponent.CrossingMode.plane(_:)`](/documentation/RealityKit/PortalComponent/CrossingMode-swift.enum/plane(_:)).

RealityKit defines the [`position`](/documentation/RealityKit/PortalComponent/Plane/position) and [`normal`](/documentation/RealityKit/PortalComponent/Plane/normal) properties in entity local space.

The following default values are available:

- [`positiveX`](/documentation/RealityKit/PortalComponent/Plane/positiveX)
- [`negativeX`](/documentation/RealityKit/PortalComponent/Plane/negativeX)
- [`positiveY`](/documentation/RealityKit/PortalComponent/Plane/positiveY)
- [`negativeY`](/documentation/RealityKit/PortalComponent/Plane/negativeY)
- [`positiveZ`](/documentation/RealityKit/PortalComponent/Plane/positiveZ)
- [`negativeZ`](/documentation/RealityKit/PortalComponent/Plane/negativeZ)

See [`PortalComponent`](/documentation/RealityKit/PortalComponent) for example usage.

## Topics

### Creating a plane

### Initializers

[`init(position: SIMD3<Float>, normal: SIMD3<Float>)`](/documentation/RealityKit/PortalComponent/Plane/init(position:normal:))

Creates a portal plane with position and normal.

### Instance Properties

[`var normal: SIMD3<Float>`](/documentation/RealityKit/PortalComponent/Plane/normal)

The normal of the portal plane, in entity local space.

[`var position: SIMD3<Float>`](/documentation/RealityKit/PortalComponent/Plane/position)

The position of the portal plane, in entity local space.

### Type Properties

[`static let negativeX: PortalComponent.Plane`](/documentation/RealityKit/PortalComponent/Plane/negativeX)

A portal plane sitting at the origin facing the negative x direction.

[`static let negativeY: PortalComponent.Plane`](/documentation/RealityKit/PortalComponent/Plane/negativeY)

A portal plane sitting at the origin facing the negative y direction.

[`static let negativeZ: PortalComponent.Plane`](/documentation/RealityKit/PortalComponent/Plane/negativeZ)

A portal plane sitting at the origin facing the negative z direction.

[`static let positiveX: PortalComponent.Plane`](/documentation/RealityKit/PortalComponent/Plane/positiveX)

A portal plane sitting at the origin facing the positive x direction.

[`static let positiveY: PortalComponent.Plane`](/documentation/RealityKit/PortalComponent/Plane/positiveY)

A portal plane sitting at the origin facing the positive y direction.

[`static let positiveZ: PortalComponent.Plane`](/documentation/RealityKit/PortalComponent/Plane/positiveZ)

A portal plane sitting at the origin facing the positive z direction.

## Relationships

### Conforms To

[`Equatable`](/documentation/Swift/Equatable)

---

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)