<!--
{
  "availability" : [
    "iOS: -",
    "iPadOS: -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "DeveloperToolsSupport",
  "identifier" : "/documentation/DeveloperToolsSupport/PreviewCameraBuilder",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "DeveloperToolsSupport"
    ],
    "preciseIdentifier" : "s:21DeveloperToolsSupport20PreviewCameraBuilderV"
  },
  "title" : "PreviewCameraBuilder"
}
-->

# PreviewCameraBuilder

A builder type that composes a collection of cameras for previewing a
view in a 3D scene.

```
@resultBuilder struct PreviewCameraBuilder
```

## Overview

You implicitly use a preview camera builder when you define a list of
[`PreviewCamera`](/documentation/DeveloperToolsSupport/PreviewCamera) instances for a preview macro:

```
#Preview {
    CircleImage()
} cameras: {
    PreviewCamera(from: .top, name: "Top")
    PreviewCamera(from: .leading, name: "Leading")
    PreviewCamera(from: .front, name: "Front")
}
```

## Topics

### Building a preview camera

[`static func buildArray([[PreviewCamera]]) -> [PreviewCamera]`](/documentation/DeveloperToolsSupport/PreviewCameraBuilder/buildArray(_:))

Builds a partial result from an array of partial results.

[`static func buildExpression(PreviewCamera) -> [PreviewCamera]`](/documentation/DeveloperToolsSupport/PreviewCameraBuilder/buildExpression(_:)-5okdh)

Builds a partial result from a single camera.

[`static func buildExpression([PreviewCamera]) -> [PreviewCamera]`](/documentation/DeveloperToolsSupport/PreviewCameraBuilder/buildExpression(_:)-5t9d2)

Builds a partial result from an array of cameras.

[`static func buildPartialBlock(accumulated: [PreviewCamera], next: [PreviewCamera]) -> [PreviewCamera]`](/documentation/DeveloperToolsSupport/PreviewCameraBuilder/buildPartialBlock(accumulated:next:))

Combines an accumulated component with a new component.

[`static func buildPartialBlock(first: [PreviewCamera]) -> [PreviewCamera]`](/documentation/DeveloperToolsSupport/PreviewCameraBuilder/buildPartialBlock(first:))

Builds a partial result component from the first component.


---

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)