<!--
{
  "documentType" : "article",
  "framework" : "RealityKit",
  "identifier" : "/documentation/RealityKit/presentation-views-and-attachments",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Views and attachments"
}
-->

# Views and attachments

Bring RealityKit content into your app with views and renderers.

## Overview

Views are the building blocks for apps that include RealityKit content.
Each view displays RealityKit content in your app either by rendering the content
in a window, volume, or an immersive space.

## Topics

### SwiftUI scene presentation

[Controlling the layout behavior of a reality view](/documentation/RealityKit/controlling-the-layout-behavior-of-a-realityview)

Choose a strategy for sizing frames and centering 3D content.

[`RealityView`](/documentation/RealityKit/RealityView)

A view that contains RealityKit content.

[`RealityViewContent`](/documentation/RealityKit/RealityViewContent)

The content of a visionOS reality view.

[`RealityViewCameraContent`](/documentation/RealityKit/RealityViewCameraContent)

The content of a reality view that is displayed through a camera.

[`RealityViewContentProtocol`](/documentation/RealityKit/RealityViewContentProtocol)

A protocol representing the content of a reality view.

[`RealityViewDefaultPlaceholder`](/documentation/RealityKit/RealityViewDefaultPlaceholder)

A view that represents the default placeholder for a RealityView.

[`RealityViewEntityCollection`](/documentation/RealityKit/RealityViewEntityCollection)

A collection of entities in a RealityView.

[`RealityViewLayoutOption`](/documentation/RealityKit/RealityViewLayoutOption)

Options that specify the frame sizing and content alignment option for `RealityView`.

[`EntityCollection`](/documentation/RealityKit/EntityCollection)

An ordered, mutable collection of entities.

### SwiftUI 3D model presentation

[`Model3D`](/documentation/RealityKit/Model3D)

A view that asynchronously loads and displays a 3D model.

[`Model3DPhase`](/documentation/RealityKit/Model3DPhase)

The current phase of the asynchronous model loading operation.

[`ResolvedModel3D`](/documentation/RealityKit/ResolvedModel3D)

A view for displaying static three-dimensional models.

[`Model3DPlaceholderContent`](/documentation/RealityKit/Model3DPlaceholderContent)

A container view that presents either a 3D model or a placeholder for one.

[`Model3DAsset`](/documentation/RealityKit/Model3DAsset)

A container used to represent the asset loaded into the Model3D View.

### Metal workflow rendering

[`RealityRenderer`](/documentation/RealityKit/RealityRenderer)

A renderer that displays a RealityKit scene in an existing Metal workflow.

[`CameraSettings`](/documentation/RealityKit/RealityRenderer/CameraSettings-swift.struct)

Settings for rendering with a camera.

[`CameraOutput`](/documentation/RealityKit/RealityRenderer/CameraOutput)

Output produced by rendering with a camera.

[`ImageBasedLight`](/documentation/RealityKit/RealityRenderer/ImageBasedLight)

Describe the lighting properties for the scene.

[`MetalEventAction`](/documentation/RealityKit/RealityRenderer/MetalEventAction)

The structure describing an event and value to be signaled or waited for.

[`EntityCollection`](/documentation/RealityKit/RealityRenderer/EntityCollection)

A collection of entities in a [`RealityRenderer`](/documentation/RealityKit/RealityRenderer).

### SwiftUI view attachments

[`RealityViewAttachmentBuilderContent`](/documentation/RealityKit/RealityViewAttachmentBuilderContent)

A view that gathers the attachment content for your current reality view.

[`Attachment`](/documentation/RealityKit/Attachment)

An attachment content you can use to gather an identifier and view.

[`RealityViewAttachments`](/documentation/RealityKit/RealityViewAttachments)

The attachments that belong to a RealityView.

[`ViewAttachmentEntity`](/documentation/RealityKit/ViewAttachmentEntity)

An entity that has a view attachment.

[`ViewAttachmentComponent`](/documentation/RealityKit/ViewAttachmentComponent)

A component containing additional information about a view attachment
entity provided  via the [`entity(for:)`](/documentation/RealityKit/RealityViewAttachments/entity(for:))
function.

[`PresentationComponent`](/documentation/RealityKit/PresentationComponent)

A component that presents a SwiftUI modal presentation from a
RealityKit entity.

[`TextComponent`](/documentation/RealityKit/TextComponent)

A component that draws 2D text at an entity’s location.

### Visual environment adjustments

[`RealityViewEnvironment`](/documentation/RealityKit/RealityViewEnvironment)

A struct that determines the background and default lighting properties for a reality view.

[`RealityViewRenderingEffects`](/documentation/RealityKit/RealityViewRenderingEffects)

A struct for enabling and disabling rendering effects for RealityKit content.

[`RealityViewRenderingEffectMode`](/documentation/RealityKit/RealityViewRenderingEffectMode)

A mode that determines whether a rendering effect is enabled or disabled.

[`RealityViewDynamicRange`](/documentation/RealityKit/RealityViewDynamicRange)

Options that determine the state of high dynamic range rendering for virtual content.

[`AntialiasingMode`](/documentation/RealityKit/AntialiasingMode)

The rendering technique used to smooth edges of virtual content.

[`RealityViewPostProcessEffect`](/documentation/RealityKit/RealityViewPostProcessEffect)

A struct for enabling or disabling post processing effects for all content a reality view contains.

[`PostProcessEffectContext`](/documentation/RealityKit/PostProcessEffectContext)

An object RealityKit passes data to a post process effect method.

[`Environment`](/documentation/RealityKit/ARView/Environment-swift.struct)

A description of background, lighting, and acoustic properties for a
view’s content.

[`RenderOptions`](/documentation/RealityKit/ARView/RenderOptions-swift.struct)

The available rendering options that you use to selectively disable
certain rendering effects.

### Postprocessing

[Postprocessing effects](/documentation/RealityKit/postprocessing-effects)

Create special rendering effects for your RealityKit scenes.

[`PostProcessContext`](/documentation/RealityKit/ARView/PostProcessContext)

An object the framework uses to pass data to a postprocess callback.

[`RenderCallbacks`](/documentation/RealityKit/ARView/RenderCallbacks-swift.struct)

A container that holds the view’s render callbacks.

[`PostProcessEffect`](/documentation/RealityKit/PostProcessEffect)

A protocol that defines hooks for custom post processing effects.

### Coordinate space conversions

[`RealityCoordinateSpaceConverting`](/documentation/RealityKit/RealityCoordinateSpaceConverting)

A value that can be converted between SwiftUI `CoordinateSpace` and RealityKit `Entity`.

[`SceneRealityCoordinateSpace`](/documentation/RealityKit/SceneRealityCoordinateSpace)

The coordinate space that represents the center of a RealityKit scene.

[`CameraRealityCoordinateSpace`](/documentation/RealityKit/CameraRealityCoordinateSpace)

The coordinate space that represents the scene’s active camera.

[`RealityCoordinateSpace`](/documentation/RealityKit/RealityCoordinateSpace)

A 3D coordinate space that exists within a RealityKit hierarchy.

[`RealityCoordinateSpaceProjecting`](/documentation/RealityKit/RealityCoordinateSpaceProjecting)

A protocol for coordinate spaces that can project 2D points to and from 3D.

### Camera mode settings

[`RealityViewCamera`](/documentation/RealityKit/RealityViewCamera)

A camera for reality view scenes, that can be world tracking or virtual.

[`CameraControls`](/documentation/RealityKit/CameraControls)

[`CameraMode`](/documentation/RealityKit/ARView/CameraMode-swift.enum)

The available camera modes.

### Attachment types

[`AttachmentContentBuilder`](/documentation/RealityKit/AttachmentContentBuilder)

A result builder that creates attachment content from closures.

[`AttachmentContent`](/documentation/RealityKit/AttachmentContent)

A type that provides content for an attachment content builder.

[`TuplePackAttachmentContent`](/documentation/RealityKit/TuplePackAttachmentContent)

[`ConditionalAttachmentContent`](/documentation/RealityKit/ConditionalAttachmentContent)

[`EmptyAttachmentContent`](/documentation/RealityKit/EmptyAttachmentContent)

A attachment content that doesn’t contain any content.

[`TupleAttachmentContent`](/documentation/RealityKit/TupleAttachmentContent)

[`AnyAttachmentContent`](/documentation/RealityKit/AnyAttachmentContent)

A type-erased attachment content.

### UIKit and AppKit presentation

[`ARView`](/documentation/RealityKit/ARView)

A view that enables you to display an AR experience with RealityKit.

[`DebugOptions`](/documentation/RealityKit/ARView/DebugOptions-swift.struct)

Options for drawing overlay content in a scene that can aid in
debugging.

[`ARViewBase`](/documentation/RealityKit/ARViewBase)

The platform-specific base class for the view into which RealityKit renders
content.


---

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)