<!--
{
  "availability" : [
    "iOS: 26.4.0 -",
    "iPadOS: 26.4.0 -",
    "macCatalyst: 26.4.0 -",
    "macOS: 26.0.0 -",
    "visionOS: 26.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "ImmersiveMediaSupport",
  "identifier" : "/documentation/ImmersiveMediaSupport/ImmersiveCameraCalibration",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "Immersive Media Support"
    ],
    "preciseIdentifier" : "s:21ImmersiveMediaSupport0A17CameraCalibrationV"
  },
  "title" : "ImmersiveCameraCalibration"
}
-->

# ImmersiveCameraCalibration

A structure that represents immersive media camera calibration data.

```
struct ImmersiveCameraCalibration
```

## Overview

This data includes calibration type, calibration name, calibration file name, lens definition, mask data, camera origin, and other relevant data.

## Topics

### Calibration geometry

[`struct CameraOrigin`](/documentation/ImmersiveMediaSupport/ImmersiveCameraCalibration/CameraOrigin)

A type that holds the position information representing the origin from which to render the calibration in 3D space relative to the person’s eye.

[`struct CameraTextureMapping`](/documentation/ImmersiveMediaSupport/ImmersiveCameraCalibration/CameraTextureMapping)

A type that holds the matrices used for video frame texture mapping on the camera lens geometry.

[`class ImmersiveCameraMeshCalibration`](/documentation/ImmersiveMediaSupport/ImmersiveCameraMeshCalibration)

Calibration mesh geometry based on USDZ data.

### Calibration configuration

[`enum CalibrationType`](/documentation/ImmersiveMediaSupport/ImmersiveCameraCalibration/CalibrationType)

A value that represents the calibration type used to generate camera calibration geometry.

[`struct ImmersiveCameraLensDefinition`](/documentation/ImmersiveMediaSupport/ImmersiveCameraLensDefinition)

This type holds the ILPD lens configuration parameters to generate a camera calibration type instance.

### Initializers

### Instance Methods

### Initializers

[`init(name: String, type: ImmersiveCameraCalibration.CalibrationType, mask: ImmersiveCameraMask?, positionable: Bool, origin: ImmersiveCameraCalibration.CameraOrigin, textureMapping: ImmersiveCameraCalibration.CameraTextureMapping, environmentFilename: String?)`](/documentation/ImmersiveMediaSupport/ImmersiveCameraCalibration/init(name:type:mask:positionable:origin:textureMapping:environmentFilename:))

Creates a mesh based calibration from USDZ data and a image-based mask.

### Instance Properties

[`var environmentFilename: String?`](/documentation/ImmersiveMediaSupport/ImmersiveCameraCalibration/environmentFilename)

The USDZ filename of a backdrop to use for this calibration.

[`var mask: ImmersiveCameraMask?`](/documentation/ImmersiveMediaSupport/ImmersiveCameraCalibration/mask)

Immersive camera mask that needs to be used for this calibration.

[`var name: String`](/documentation/ImmersiveMediaSupport/ImmersiveCameraCalibration/name)

A string identifying this calibration.

[`var origin: ImmersiveCameraCalibration.CameraOrigin`](/documentation/ImmersiveMediaSupport/ImmersiveCameraCalibration/origin)

Position information, in meters, that represents the origin from which to render the calibration in 3D space relative to the person’s eye.

[`var positionable: Bool`](/documentation/ImmersiveMediaSupport/ImmersiveCameraCalibration/positionable)

A Boolean value that indicates whether to anchor this calibration in mixed reality 3D space rather than centering it on the person’s eye position.

[`var textureMapping: ImmersiveCameraCalibration.CameraTextureMapping`](/documentation/ImmersiveMediaSupport/ImmersiveCameraCalibration/textureMapping)

Texture mapping that describes how each section of the video frame maps into the calibration.

[`var type: ImmersiveCameraCalibration.CalibrationType`](/documentation/ImmersiveMediaSupport/ImmersiveCameraCalibration/type)

The type of this calibration.

## Relationships

### Conforms To

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

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

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

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

---

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)