---
title: USDStageComponent
framework: usdkit
role: symbol
role_heading: Structure
platforms: [iOS 27.0+, iPadOS 27.0+, Mac Catalyst 27.0+, macOS 27.0+, tvOS 27.0+, visionOS 27.0+]
path: usdkit/usdstagecomponent
---

# USDStageComponent

A component that renders a USD stage as RealityKit entities.

## Declaration

```swift
struct USDStageComponent
```

## Overview

Overview Attach a USDStageComponent to an entity to render USD content as child entities. The component supports two modes of operation: Manual mode: Created with init(allowsHitTesting:). You control when rendering occurs by calling render(_:to:at:). Automatic mode: Created with init(_:timeCode:allowsHitTesting:). The component manages rendering internally and updates when the stage or time code changes.

## Topics

### Creating a stage component

- [init(_:timeCode:allowsHitTesting:)](usdkit/usdstagecomponent/init(_:timecode:allowshittesting:).md)
- [init(allowsHitTesting:)](usdkit/usdstagecomponent/init(allowshittesting:).md)

### Configuring the component

- [stage](usdkit/usdstagecomponent/stage.md)
- [timeCode](usdkit/usdstagecomponent/timecode.md)
- [allowsHitTesting](usdkit/usdstagecomponent/allowshittesting.md)
- [rendersAutomatically](usdkit/usdstagecomponent/rendersautomatically.md)

### Rendering the stage

- [render(_:to:at:)](usdkit/usdstagecomponent/render(_:to:at:).md)
- [USDStageComponent.RenderResult](usdkit/usdstagecomponent/renderresult.md)

### Type Methods

- [coordinateSpace(on:at:timeCode:)](usdkit/usdstagecomponent/coordinatespace(on:at:timecode:).md)
- [waitForRenderCompletion(on:)](usdkit/usdstagecomponent/waitforrendercompletion(on:).md)

## Relationships

### Conforms To

- [Component](realitykit/component.md)
- [Copyable](swift/copyable.md)
- [Decodable](swift/decodable.md)
- [Encodable](swift/encodable.md)
- [Equatable](swift/equatable.md)
- [Escapable](swift/escapable.md)

## See Also

### RealityKit rendering and playback

- [USDPlayer](usdkit/usdplayer.md)