<!--
{
  "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/ImmersiveCameraLensDefinition",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "Immersive Media Support"
    ],
    "preciseIdentifier" : "s:21ImmersiveMediaSupport0A20CameraLensDefinitionV"
  },
  "title" : "ImmersiveCameraLensDefinition"
}
-->

# ImmersiveCameraLensDefinition

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

```
struct ImmersiveCameraLensDefinition
```

## Overview

Initializer method creates these types from ILPD data blobs (JSON contents) read from ILPD files. These lens definition metadata types are also used for STMap generation to transform AIV video frames of one lens projection type to another during content previews.

## Topics

### Initializers

   

[`init(from: Data) throws`](/documentation/ImmersiveMediaSupport/ImmersiveCameraLensDefinition/init(from:))

Creates an `ImmersiveCameraLensDefinition` object from a ILPD data blob, basically the JSON contents of a ILPD file..      

### Instance Properties

[`var cameraID: String`](/documentation/ImmersiveMediaSupport/ImmersiveCameraLensDefinition/cameraID)

The unique identifier of the immersive camera associated with this lens definition instance.

### Instance Methods

[`func generateSTMap(device: any MTLDevice, cameraEye: ImmersiveCameraLensDefinition.Eye, stmapType: ImmersiveCameraLensDefinition.STMapType, into: any MTLTexture) async throws`](/documentation/ImmersiveMediaSupport/ImmersiveCameraLensDefinition/generateSTMap(device:cameraEye:stmapType:into:))

Generates an STMap for the given projection type and for the given camera eye into the provided texture asynchronously.

### Enumerations

[`enum Eye`](/documentation/ImmersiveMediaSupport/ImmersiveCameraLensDefinition/Eye)

A value that represents a camera lens eye.

[`enum STMapType`](/documentation/ImmersiveMediaSupport/ImmersiveCameraLensDefinition/STMapType)

A value that represents a camera lens projection type.

## Relationships

### Conforms To

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

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

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

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

---

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)