Zoom

import IMGLYCamera

import SwiftUI

struct CameraSwiftUI: View {
  @State private var isPresented = false

  var body: some View {
    Button("Use the Camera") {
      isPresented = true
    }
    .fullScreenCover(isPresented: $isPresented) {
      Camera(.init(license: secrets.licenseKey, // pass nil for evaluation mode with watermark
                   userID: "<your unique user id>")) { result in
        switch result {
        case let .success(.capture(captures)):
          for capture in captures {
            switch capture {
            case let .photo(photo):
              if let url = photo.images.first?.url {
                print("Captured photo: \(url)")
              }
            case let .video(recording):
              print("Recorded videos: \(recording.videos.map(\.url))")
            }
          }

        case .success(.reaction):
          print("Reaction case not handled here")

        case let .failure(error):
          print(error.localizedDescription)
        }
        isPresented = false
      }
    }
  }
}

What You’ll Learn#

• How the built-in pinch-to-zoom gesture works while capturing.
• How the zoom range is clamped to the device’s hardware limits.
• Why there is no programmatic or initial-zoom API today.

Permission#

The camera runs a live capture session, which requires camera access. Add NSCameraUsageDescription to your app’s Info.plist with a user-facing description, or the system terminates the app the first time the camera opens:

<key>NSCameraUsageDescription</key>
<string>Capture a photo or video to edit in the editor.</string>

The IMGLY Camera requests camera authorization at runtime and shows a denial alert if access is refused — you only need to provide the usage-description key.

Pinch to Zoom#

Import IMGLYCamera and launch the camera as usual — pinch-to-zoom is part of the live preview, so the standard launch is all you need:

import IMGLYCamera

Camera(.init(license: secrets.licenseKey, // pass nil for evaluation mode with watermark
             userID: "<your unique user id>")) { result in

secrets.licenseKey comes from a small Secrets.swift shim the iOS guides repository ships — substitute your own license key. See Integrate Mobile Camera for the full launch and result handling.

Once the camera is open, your users:

• Pinch the live preview with two fingers to zoom in and out. The active zoom level applies to whatever they capture next.
• Double-tap the live preview to flip between the front and back cameras — the related built-in gesture on the same preview.

The zoom level is clamped to the device’s supported range. This range varies by device and lens — multi-lens devices reach further than single-lens models — and the camera never zooms beyond what the hardware supports.

No Programmatic Zoom#

Zoom is gesture-driven only. There is currently no field on CameraConfiguration to set an initial zoom level, change the limits, or disable the gesture, and no API to set the zoom programmatically while the camera is open. The user controls zoom directly through the pinch gesture.

Troubleshooting#

The zoom feels limited — the zoom range is the device’s hardware range. Single-lens devices have a narrower range than multi-lens models, so the maximum zoom differs across devices.

Pinching does nothing — the gesture works on the live camera preview, which is only available on a physical device. The iOS Simulator has no camera feed.

I need to set the zoom in code — there is no public API for this. Pinch-to-zoom is the only zoom path on the IMGLY Camera today.

Next Steps#

• Learn how to integrate the IMGLY Camera into your project.
• Configure the camera’s capture type, UI, and other properties.
• Learn how to retrieve and manage recordings.