<!--
{
  "availability" : [
    "iOS: 17.0.0 -",
    "iPadOS: 17.0.0 -",
    "macCatalyst: 15.0.0 -",
    "macOS: 12.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "RealityKit",
  "identifier" : "/documentation/RealityKit/PhotogrammetrySession/Request",
  "metadataVersion" : "0.1.0",
  "role" : "Enumeration",
  "symbol" : {
    "kind" : "Enumeration",
    "modules" : [
      "RealityKit"
    ],
    "preciseIdentifier" : "s:17RealityFoundation21PhotogrammetrySessionC7RequestO"
  },
  "title" : "PhotogrammetrySession.Request"
}
-->

# PhotogrammetrySession.Request

An object that configures a photogrammetry session reconstruction request.

```
enum Request
```

## Overview

Create a [`PhotogrammetrySession.Request`](/documentation/RealityKit/PhotogrammetrySession/Request) for each 3D object you want
to construct from the same set of photographs. You might, for example,
create a session with two requests, one to generate a low-resolution
preview object in memory, and a second to generate a high-resolution
final object saved to the file system.

Before creating an instance of this class,  check [`isSupported`](/documentation/RealityKit/PhotogrammetrySession/isSupported)
to ensure object capture is available on the current device.

For more information on using [`PhotogrammetrySession`](/documentation/RealityKit/PhotogrammetrySession), see
<doc://com.apple.documentation/documentation/RealityKit/creating-3d-objects-from-photographs>.

## Topics

### Creating the request

[`init(modelFile:)`](/documentation/RealityKit/PhotogrammetrySession/Request/init(modelFile:))

Creates an instance based on the contents of a USDZ file.

### Specifying the output

[`PhotogrammetrySession.Request.modelFile(url:detail:geometry:)`](/documentation/RealityKit/PhotogrammetrySession/Request/modelFile(url:detail:geometry:))

An object-creation request saved to a USDZ file or a folder (for OBJ output).

[`PhotogrammetrySession.Request.modelEntity(detail:geometry:)`](/documentation/RealityKit/PhotogrammetrySession/Request/modelEntity(detail:geometry:))

An object-creation request stored in-memory for immediate display.

[`PhotogrammetrySession.Request.bounds`](/documentation/RealityKit/PhotogrammetrySession/Request/bounds)

An object-creation request that returns a box the same size as the
created model.

[`Detail`](/documentation/RealityKit/PhotogrammetrySession/Request/Detail)

Supported levels of detail for a request.

### Comparing values

### Transforming the created model

[`Geometry`](/documentation/RealityKit/PhotogrammetrySession/Request/Geometry)

An object that holds a bounding box and transformation data for a request.

## Relationships

### Conforms To

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

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

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

[`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)