@capgo/camera-preview 7.17.1 → 7.18.0

package/README.md

@@ -1037,6 +1037,7 @@ Defines the options for capturing a picture.
 | **`saveToGallery`**    | <code>boolean</code>                                    | If true, the captured image will be saved to the user's gallery.                                                                                                                                            | <code>false</code>  | 7.5.0  |
 | **`withExifLocation`** | <code>boolean</code>                                    | If true, the plugin will attempt to add GPS location data to the image's EXIF metadata. This may prompt the user for location permissions.                                                                  | <code>false</code>  | 7.6.0  |
 | **`embedTimestamp`**   | <code>boolean</code>                                    | If true, the plugin will embed a timestamp in the top-right corner of the image.                                                                                                                            | <code>false</code>  | 7.17.0 |
+| **`embedLocation`**    | <code>boolean</code>                                    | If true, the plugin will embed the current location in the top-right corner of the image. Requires `withExifLocation` to be enabled.                                                                        | <code>false</code>  | 7.18.0 |
 
 
 #### CameraSampleOptions

package/android/src/main/java/app/capgo/capacitor/camera/preview/CameraPreview.java

@@ -372,6 +372,9 @@ public class CameraPreview
     final boolean embedTimestamp = Boolean.TRUE.equals(
       call.getBoolean("embedTimestamp")
     );
+    final boolean embedLocation = Boolean.TRUE.equals(
+      call.getBoolean("embedLocation")
+    );
 
     cameraXView.capturePhoto(
       quality,
@@ -379,7 +382,8 @@ public class CameraPreview
       width,
       height,
       location,
-      embedTimestamp
+      embedTimestamp,
+      embedLocation
     );
   }
 

package/android/src/main/java/app/capgo/capacitor/camera/preview/CameraXView.java

@@ -1169,7 +1169,8 @@ public class CameraXView implements LifecycleOwner, LifecycleObserver {
     Integer width,
     Integer height,
     Location location,
-    final boolean embedTimestamp
+    final boolean embedTimestamp,
+    final boolean embedLocation
   ) {
     // Prevent capture if a stop is pending
     if (IsOperationRunning("capturePhoto")) {
@@ -1187,7 +1188,9 @@ public class CameraXView implements LifecycleOwner, LifecycleObserver {
       ", saveToGallery: " +
       saveToGallery +
       ", embedTimestamp: " +
-      embedTimestamp
+      embedTimestamp +
+      ", embedLocation: " +
+      embedLocation
     );
 
     if (imageCapture == null) {
@@ -1262,10 +1265,12 @@ public class CameraXView implements LifecycleOwner, LifecycleObserver {
                 width,
                 height
               );
-              if (embedTimestamp) {
-                resizedBitmap = drawTimestampOntoBitmap(
+              if (embedTimestamp || embedLocation) {
+                resizedBitmap = drawTimestampAndLocationOntoBitmap(
                   resizedBitmap,
-                  exifInterface
+                  exifInterface,
+                  embedTimestamp,
+                  embedLocation
                 );
               }
               ByteArrayOutputStream stream = new ByteArrayOutputStream();
@@ -1302,10 +1307,12 @@ public class CameraXView implements LifecycleOwner, LifecycleObserver {
                 exifInterface
               );
               Bitmap previewCropped = cropBitmapToMatchPreview(originalBitmap);
-              if (embedTimestamp) {
-                previewCropped = drawTimestampOntoBitmap(
+              if (embedTimestamp || embedLocation) {
+                previewCropped = drawTimestampAndLocationOntoBitmap(
                   previewCropped,
-                  exifInterface
+                  exifInterface,
+                  embedTimestamp,
+                  embedLocation
                 );
               }
               ByteArrayOutputStream stream = new ByteArrayOutputStream();
@@ -1406,37 +1413,34 @@ public class CameraXView implements LifecycleOwner, LifecycleObserver {
     );
   }
 
-  private Bitmap drawTimestampOntoBitmap(Bitmap src, ExifInterface exif) {
+  private Bitmap drawTimestampAndLocationOntoBitmap(
+    Bitmap src,
+    ExifInterface exif,
+    boolean embedTimestamp,
+    boolean embedLocation
+  ) {
     if (src == null) return null;
 
-    // Build timestamp string ("yyyy-MM-dd HH:mm:ss"), preferring EXIF original
-    final String fmt = "yyyy-MM-dd HH:mm:ss";
-    String when = null;
-    if (exif != null) {
-      final String exifDate = exif.getAttribute(
-        ExifInterface.TAG_DATETIME_ORIGINAL
-      ); // "yyyy:MM:dd HH:mm:ss"
-      if (exifDate != null && !exifDate.trim().isEmpty()) {
-        try {
-          java.text.SimpleDateFormat inFmt = new java.text.SimpleDateFormat(
-            "yyyy:MM:dd HH:mm:ss",
-            java.util.Locale.US
-          );
-          java.util.Date d = inFmt.parse(exifDate);
-          if (d != null) {
-            when = new java.text.SimpleDateFormat(
-              fmt,
-              java.util.Locale.getDefault()
-            ).format(d);
-          }
-        } catch (java.text.ParseException ignored) {}
-      }
-    }
-    if (when == null) {
-      when = new java.text.SimpleDateFormat(
-        fmt,
-        java.util.Locale.getDefault()
-      ).format(new java.util.Date());
+    // Build strings (null-safe)
+    final String when = embedTimestamp
+      ? buildTimestampStringFromExif(exif)
+      : null;
+    final String where =
+      (embedLocation ? buildLocationStringFromExif(exif) : null);
+
+    // Nothing to draw?
+    if (
+      (when == null || when.isEmpty()) && (where == null || where.isEmpty())
+    ) {
+      Log.d(
+        TAG,
+        "capturePhoto:... embedTimestamp: " +
+        embedTimestamp +
+        ", embedLocation: " +
+        embedLocation
+      );
+      Log.d(TAG, "capturePhoto: nothing to draw");
+      return src;
     }
 
     final Bitmap bmp = src.isMutable()
@@ -1444,14 +1448,16 @@ public class CameraXView implements LifecycleOwner, LifecycleObserver {
       : src.copy(Bitmap.Config.ARGB_8888, true);
     final Canvas canvas = new Canvas(bmp);
 
-    // ---- Match iOS constants ----
-    final float fontPx = Math.max(10f, bmp.getWidth() * 0.035f); // ≥10, 3.5% of width
-    final float paddingH = 16f;
-    final float paddingV = 10f;
-    final float cornerRadius = 10f;
-    final float margin = 12f;
+    // ---- Visual constants (match timestamp style) ----
+    final float fontPx = Math.max(10f, bmp.getWidth() * 0.035f); // ~3.5% of width
+    final float paddingH = 16f; // horizontal inner padding
+    final float paddingV = 10f; // vertical inner padding
+    final float margin = 12f; // margin from image edges
+    final float gap = 8f; // vertical gap between stacked pills
+    final float corner = 10f; // corner radius
+    final int bgColor = Color.argb(56, 31, 31, 31); // ~iOS gray at ~22% alpha
 
-    // Text paint (SF .semibold ≈ Roboto Medium)
+    // Text paint
     final Paint text = new Paint(
       Paint.ANTI_ALIAS_FLAG | Paint.SUBPIXEL_TEXT_FLAG | Paint.LINEAR_TEXT_FLAG
     );
@@ -1460,52 +1466,110 @@ public class CameraXView implements LifecycleOwner, LifecycleObserver {
     text.setTextSize(fontPx);
     text.setTextAlign(Paint.Align.LEFT);
     text.setDither(true);
-
-    // Measure text
-    final float textWidth = text.measureText(when);
+    text.setFilterBitmap(true);
+    text.setHinting(Paint.HINTING_ON);
     final Paint.FontMetrics fm = text.getFontMetrics();
-    final float textHeight = fm.descent - fm.ascent;
-
-    // Bubble rect (top-right)
-    final float bgWidth = textWidth + paddingH * 2f;
-    final float bgHeight = textHeight + paddingV * 2f;
-    final float bgLeft = Math.max(0, bmp.getWidth() - bgWidth - margin);
-    final float bgTop = margin;
-    final float bgRight = bgLeft + bgWidth;
-    final float bgBottom = bgTop + bgHeight;
-
-    // Background color: UIColor(white:0.12, alpha:0.22)
-    // -> alpha ≈ 0.22*255 ≈ 56, rgb ≈ 0.12*255 ≈ 31
-    final int bgColor = Color.argb(56, 31, 31, 31);
+    final float lineHeight = fm.descent - fm.ascent;
 
+    // Background paint
     final Paint bg = new Paint(Paint.ANTI_ALIAS_FLAG);
     bg.setColor(bgColor);
     bg.setStyle(Paint.Style.FILL);
-    // Shadow: offset (0,2), blur ~6, alpha 0.25 black
     bg.setShadowLayer(6f, 0f, 2f, Color.argb(64, 0, 0, 0));
 
-    // Draw bubble
-    canvas.drawRoundRect(
-      bgLeft,
-      bgTop,
-      bgRight,
-      bgBottom,
-      cornerRadius,
-      cornerRadius,
-      bg
-    );
+    float nextTop = margin;
+
+    // Helper to draw a pill aligned to the top-right, returns the bottom Y used
+    java.util.function.BiFunction<String, Float, Float> drawPill = (
+      label,
+      top
+    ) -> {
+      if (label == null || label.isEmpty()) return top;
+      float textW = text.measureText(label);
+      float bgW = textW + paddingH * 2f;
+      float bgH = lineHeight + paddingV * 2f;
+
+      float left = Math.max(0, bmp.getWidth() - bgW - margin);
+      float right = left + bgW;
+      float bottom = top + bgH;
+
+      // Background
+      canvas.drawRoundRect(left, top, right, bottom, corner, corner, bg);
+
+      // Text baseline
+      float textX = left + paddingH;
+      float textY = top + paddingV - fm.ascent; // convert top-left to baseline
+      canvas.drawText(label, textX, textY, text);
+
+      return bottom;
+    };
+
+    // 1) Timestamp (if any)
+    if (when != null && !when.isEmpty()) {
+      nextTop = drawPill.apply(when, nextTop);
+      // add gap below
+      nextTop += gap;
+    }
 
-    // Text origin (like iOS: top-left inside padding)
-    final float textX = bgLeft + paddingH;
-    final float textY = bgTop + paddingV - fm.ascent; // convert top-left to baseline
+    // 2) Location (if any)
+    if (where != null && !where.isEmpty()) {
+      // If there was no timestamp drawn, we still start at top margin.
+      // If there was, we use the accumulated nextTop (= bottom + gap).
+      drawPill.apply(
+        where,
+        (when != null && !when.isEmpty()) ? nextTop : margin
+      );
+    }
 
-    // High-quality rendering akin to iOS flags
-    text.setFilterBitmap(true);
-    text.setHinting(Paint.HINTING_ON);
+    return bmp;
+  }
 
-    canvas.drawText(when, textX, textY, text);
+  /** Build "yyyy-MM-dd HH:mm:ss" from EXIF, fallback to now. */
+  private String buildTimestampStringFromExif(ExifInterface exif) {
+    final String out = "yyyy-MM-dd HH:mm:ss";
+    try {
+      if (exif != null) {
+        String exifDate = exif.getAttribute(
+          ExifInterface.TAG_DATETIME_ORIGINAL
+        );
+        if (exifDate == null || exifDate.trim().isEmpty()) {
+          exifDate = exif.getAttribute(ExifInterface.TAG_DATETIME);
+        }
+        if (exifDate != null && !exifDate.trim().isEmpty()) {
+          java.text.SimpleDateFormat in = new java.text.SimpleDateFormat(
+            "yyyy:MM:dd HH:mm:ss",
+            java.util.Locale.US
+          );
+          java.util.Date d = in.parse(exifDate);
+          if (d != null) {
+            return new java.text.SimpleDateFormat(
+              out,
+              java.util.Locale.getDefault()
+            ).format(d);
+          }
+        }
+      }
+    } catch (Throwable ignored) {}
+    // Fallback to "now" if EXIF missing/invalid
+    return new java.text.SimpleDateFormat(
+      out,
+      java.util.Locale.getDefault()
+    ).format(new java.util.Date());
+  }
 
-    return bmp;
+  /** Build "lat, lon" from EXIF GPS. Returns null if absent (so caller can skip). */
+  private String buildLocationStringFromExif(ExifInterface exif) {
+    if (exif == null) return null;
+    try {
+      float[] latLong = new float[2];
+      if (exif.getLatLong(latLong)) {
+        // Keep a compact but readable precision (5 decimals ≈ ~1 m–10 m)
+        String lat = String.format(java.util.Locale.US, "%.5f", latLong[0]);
+        String lon = String.format(java.util.Locale.US, "%.5f", latLong[1]);
+        return lat + ", " + lon;
+      }
+    } catch (Throwable ignored) {}
+    return null; // No EXIF GPS → skip
   }
 
   private int exifToDegrees(int exifOrientation) {

package/dist/docs.json

@@ -1444,6 +1444,22 @@
           "docs": "If true, the plugin will embed a timestamp in the top-right corner of the image.",
           "complexTypes": [],
           "type": "boolean | undefined"
+        },
+        {
+          "name": "embedLocation",
+          "tags": [
+            {
+              "text": "false",
+              "name": "default"
+            },
+            {
+              "text": "7.18.0",
+              "name": "since"
+            }
+          ],
+          "docs": "If true, the plugin will embed the current location in the top-right corner of the image.\nRequires `withExifLocation` to be enabled.",
+          "complexTypes": [],
+          "type": "boolean | undefined"
         }
       ]
     },

package/dist/esm/definitions.d.ts

@@ -244,6 +244,13 @@ export interface CameraPreviewPictureOptions {
      * @since 7.17.0
      */
     embedTimestamp?: boolean;
+    /**
+     * If true, the plugin will embed the current location in the top-right corner of the image.
+     * Requires `withExifLocation` to be enabled.
+     * @default false
+     * @since 7.18.0
+     */
+    embedLocation?: boolean;
 }
 /** Represents EXIF data extracted from an image. */
 export interface ExifData {

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAUA,MAAM,CAAN,IAAY,UAQX;AARD,WAAY,UAAU;IACpB,sCAAwB,CAAA;IACxB,sCAAwB,CAAA;IACxB,qCAAuB,CAAA;IACvB,sCAAwB,CAAA;IACxB,2BAAa,CAAA;IACb,oCAAsB,CAAA;IACtB,+BAAiB,CAAA;AACnB,CAAC,EARW,UAAU,KAAV,UAAU,QAQrB","sourcesContent":["import type { PluginListenerHandle } from \"@capacitor/core\";\n\nexport type CameraPosition = \"rear\" | \"front\";\n\nexport type FlashMode = CameraPreviewFlashMode;\n\nexport type GridMode = \"none\" | \"3x3\" | \"4x4\";\n\nexport type CameraPositioning = \"center\" | \"top\" | \"bottom\";\n\nexport enum DeviceType {\n  ULTRA_WIDE = \"ultraWide\",\n  WIDE_ANGLE = \"wideAngle\",\n  TELEPHOTO = \"telephoto\",\n  TRUE_DEPTH = \"trueDepth\",\n  DUAL = \"dual\",\n  DUAL_WIDE = \"dualWide\",\n  TRIPLE = \"triple\",\n}\n\n/**\n * Represents a single camera lens on a device. A {@link CameraDevice} can have multiple lenses.\n */\nexport interface CameraLens {\n  /** A human-readable name for the lens, e.g., \"Ultra-Wide\". */\n  label: string;\n  /** The type of the camera lens. */\n  deviceType: DeviceType;\n  /** The focal length of the lens in millimeters. */\n  focalLength: number;\n  /** The base zoom factor for this lens (e.g., 0.5 for ultra-wide, 1.0 for wide). */\n  baseZoomRatio: number;\n  /** The minimum zoom factor supported by this specific lens. */\n  minZoom: number;\n  /** The maximum zoom factor supported by this specific lens. */\n  maxZoom: number;\n}\n\n/**\n * Represents a physical camera on the device (e.g., the front-facing camera).\n */\nexport interface CameraDevice {\n  /** A unique identifier for the camera device. */\n  deviceId: string;\n  /** A human-readable name for the camera device. */\n  label: string;\n  /** The physical position of the camera on the device. */\n  position: CameraPosition;\n  /** A list of all available lenses for this camera device. */\n  lenses: CameraLens[];\n  /** The overall minimum zoom factor available across all lenses on this device. */\n  minZoom: number;\n  /** The overall maximum zoom factor available across all lenses on this device. */\n  maxZoom: number;\n  /** Identifies whether the device is a logical camera (composed of multiple physical lenses). */\n  isLogical: boolean;\n}\n\n/**\n * Represents the detailed information of the currently active lens.\n */\nexport interface LensInfo {\n  /** The focal length of the active lens in millimeters. */\n  focalLength: number;\n  /** The device type of the active lens. */\n  deviceType: DeviceType;\n  /** The base zoom ratio of the active lens (e.g., 0.5x, 1.0x). */\n  baseZoomRatio: number;\n  /** The current digital zoom factor applied on top of the base zoom. */\n  digitalZoom: number;\n}\n\n/**\n * Defines the configuration options for starting the camera preview.\n */\nexport interface CameraPreviewOptions {\n  /**\n   * The parent element to attach the video preview to.\n   * @platform web\n   */\n  parent?: string;\n  /**\n   * A CSS class name to add to the preview element.\n   * @platform web\n   */\n  className?: string;\n  /**\n   * The width of the preview in pixels. Defaults to the screen width.\n   * @platform android, ios, web\n   */\n  width?: number;\n  /**\n   * The height of the preview in pixels. Defaults to the screen height.\n   * @platform android, ios, web\n   */\n  height?: number;\n  /**\n   * The horizontal origin of the preview, in pixels.\n   * @platform android, ios\n   */\n  x?: number;\n  /**\n   * The vertical origin of the preview, in pixels.\n   * @platform android, ios\n   */\n  y?: number;\n  /**\n   * The aspect ratio of the camera preview, '4:3' or '16:9' or 'fill'.\n   * Cannot be set if width or height is provided, otherwise the call will be rejected.\n   * Use setPreviewSize to adjust size after starting.\n   *\n   * @since 2.0.0\n   */\n  aspectRatio?: \"4:3\" | \"16:9\";\n  /**\n   * The grid overlay to display on the camera preview.\n   * @default \"none\"\n   * @since 2.1.0\n   */\n  gridMode?: GridMode;\n  /**\n   * Adjusts the y-position to account for safe areas (e.g., notches).\n   * @platform ios\n   * @default false\n   */\n  includeSafeAreaInsets?: boolean;\n  /**\n   * If true, places the preview behind the webview.\n   * @platform android\n   * @default true\n   */\n  toBack?: boolean;\n  /**\n   * Bottom padding for the preview, in pixels.\n   * @platform android, ios\n   */\n  paddingBottom?: number;\n  /**\n   * Whether to rotate the preview when the device orientation changes.\n   * @platform ios\n   * @default true\n   */\n  rotateWhenOrientationChanged?: boolean;\n  /**\n   * The camera to use.\n   * @default \"rear\"\n   */\n  position?: CameraPosition | string;\n  /**\n   * If true, saves the captured image to a file and returns the file path.\n   * If false, returns a base64 encoded string.\n   * @default false\n   */\n  storeToFile?: boolean;\n  /**\n   * If true, prevents the plugin from rotating the image based on EXIF data.\n   * @platform android\n   * @default false\n   */\n  disableExifHeaderStripping?: boolean;\n  /**\n   * If true, disables the audio stream, preventing audio permission requests.\n   * @default true\n   */\n  disableAudio?: boolean;\n  /**\n   * If true, locks the device orientation while the camera is active.\n   * @platform android\n   * @default false\n   */\n  lockAndroidOrientation?: boolean;\n  /**\n   * If true, allows the camera preview's opacity to be changed.\n   * @platform android, web\n   * @default false\n   */\n  enableOpacity?: boolean;\n\n  /**\n   * If true, disables the visual focus indicator when tapping to focus.\n   * @platform android, ios\n   * @default false\n   */\n  disableFocusIndicator?: boolean;\n  /**\n   * The `deviceId` of the camera to use. If provided, `position` is ignored.\n   * @platform ios\n   */\n  deviceId?: string;\n  /**\n   * The initial zoom level when starting the camera preview.\n   * If the requested zoom level is not available, the native plugin will reject.\n   * @default 1.0\n   * @platform android, ios\n   * @since 2.2.0\n   */\n  initialZoomLevel?: number;\n  /**\n   * The vertical positioning of the camera preview.\n   * @default \"center\"\n   * @platform android, ios, web\n   * @since 2.3.0\n   */\n  positioning?: CameraPositioning;\n  /**\n   * If true, enables video capture capabilities when the camera starts.\n   * @default false\n   * @platform android\n   * @since 7.11.0\n   */\n  enableVideoMode?: boolean;\n}\n\n/**\n * Defines the options for capturing a picture.\n */\nexport interface CameraPreviewPictureOptions {\n  /**\n   * The maximum height of the picture in pixels. The image will be resized to fit within this height while maintaining aspect ratio.\n   * If not specified the captured image will match the preview's visible area.\n   */\n  height?: number;\n  /**\n   * The maximum width of the picture in pixels. The image will be resized to fit within this width while maintaining aspect ratio.\n   * If not specified the captured image will match the preview's visible area.\n   */\n  width?: number;\n  /**\n   * The quality of the captured image, from 0 to 100.\n   * Does not apply to `png` format.\n   * @default 85\n   */\n  quality?: number;\n  /**\n   * The format of the captured image.\n   * @default \"jpeg\"\n   */\n  format?: PictureFormat;\n  /**\n   * If true, the captured image will be saved to the user's gallery.\n   * @default false\n   * @since 7.5.0\n   */\n  saveToGallery?: boolean;\n  /**\n   * If true, the plugin will attempt to add GPS location data to the image's EXIF metadata.\n   * This may prompt the user for location permissions.\n   * @default false\n   * @since 7.6.0\n   */\n  withExifLocation?: boolean;\n  /**\n   * If true, the plugin will embed a timestamp in the top-right corner of the image.\n   * @default false\n   * @since 7.17.0\n   */\n  embedTimestamp?: boolean;\n}\n\n/** Represents EXIF data extracted from an image. */\nexport interface ExifData {\n  [key: string]: any;\n}\n\nexport type PictureFormat = \"jpeg\" | \"png\";\n\n/** Defines a standard picture size with width and height. */\nexport interface PictureSize {\n  /** The width of the picture in pixels. */\n  width: number;\n  /** The height of the picture in pixels. */\n  height: number;\n}\n\n/** Represents the supported picture sizes for a camera facing a certain direction. */\nexport interface SupportedPictureSizes {\n  /** The camera direction (\"front\" or \"rear\"). */\n  facing: string;\n  /** A list of supported picture sizes for this camera. */\n  supportedPictureSizes: PictureSize[];\n}\n\n/**\n * Defines the options for capturing a sample frame from the camera preview.\n */\nexport interface CameraSampleOptions {\n  /**\n   * The quality of the captured sample, from 0 to 100.\n   * @default 85\n   */\n  quality?: number;\n}\n\n/**\n * The available flash modes for the camera.\n * 'torch' is a continuous light mode.\n */\nexport type CameraPreviewFlashMode = \"off\" | \"on\" | \"auto\" | \"torch\";\n\n/** Reusable exposure mode type for cross-platform support. */\nexport type ExposureMode = \"AUTO\" | \"LOCK\" | \"CONTINUOUS\" | \"CUSTOM\";\n\n/**\n * Defines the options for setting the camera preview's opacity.\n */\nexport interface CameraOpacityOptions {\n  /**\n   * The opacity percentage, from 0.0 (fully transparent) to 1.0 (fully opaque).\n   * @default 1.0\n   */\n  opacity?: number;\n}\n\n/**\n * Represents safe area insets for devices.\n * Android: Values are expressed in logical pixels (dp) to match JS layout units.\n * iOS: Values are expressed in physical pixels and exclude status bar.\n */\nexport interface SafeAreaInsets {\n  /** Current device orientation (1 = portrait, 2 = landscape, 0 = unknown). */\n  orientation: number;\n  /**\n   * Orientation-aware notch/camera cutout inset (excluding status bar).\n   * In portrait mode: returns top inset (notch at top).\n   * In landscape mode: returns left inset (notch at side).\n   * Android: Value in dp, iOS: Value in pixels (status bar excluded).\n   */\n  top: number;\n}\n\n/**\n * Canonical device orientation values across platforms.\n */\nexport type DeviceOrientation =\n  | \"portrait\"\n  | \"landscape-left\"\n  | \"landscape-right\"\n  | \"portrait-upside-down\"\n  | \"unknown\";\n\n/**\n * The main interface for the CameraPreview plugin.\n */\nexport interface CameraPreviewPlugin {\n  /**\n   * Starts the camera preview.\n   *\n   * @param {CameraPreviewOptions} options - The configuration for the camera preview.\n   * @returns {Promise<{ width: number; height: number; x: number; y: number }>} A promise that resolves with the preview dimensions.\n   * @since 0.0.1\n   */\n  start(options: CameraPreviewOptions): Promise<{\n    /** The width of the preview in pixels. */\n    width: number;\n    /** The height of the preview in pixels. */\n    height: number;\n    /** The horizontal origin of the preview, in pixels. */\n    x: number;\n    /** The vertical origin of the preview, in pixels. */\n    y: number;\n  }>;\n\n  /**\n   * Stops the camera preview.\n   *\n   * @returns {Promise<void>} A promise that resolves when the camera preview is stopped.\n   * @since 0.0.1\n   */\n  stop(): Promise<void>;\n\n  /**\n   * Captures a picture from the camera.\n   *\n   * If `storeToFile` was set to `true` when starting the preview, the returned\n   * `value` will be an absolute file path on the device instead of a base64 string. Use getBase64FromFilePath to get the base64 string from the file path.\n   *\n   * @param {CameraPreviewPictureOptions} options - The options for capturing the picture.\n   * @returns {Promise<{ value: string; exif: ExifData }>} Resolves with:\n   *   - `value`: base64 string, or file path if `storeToFile` is true\n   *   - `exif`: extracted EXIF metadata when available\n   * @since 0.0.1\n   */\n  capture(\n    options: CameraPreviewPictureOptions,\n  ): Promise<{ value: string; exif: ExifData }>;\n\n  /**\n   * Captures a single frame from the camera preview stream.\n   *\n   * @param {CameraSampleOptions} options - The options for capturing the sample.\n   * @returns {Promise<{ value: string }>} A promise that resolves with the sample image as a base64 encoded string.\n   * @since 0.0.1\n   */\n  captureSample(options: CameraSampleOptions): Promise<{ value: string }>;\n\n  /**\n   * Gets the flash modes supported by the active camera.\n   *\n   * @returns {Promise<{ result: CameraPreviewFlashMode[] }>} A promise that resolves with an array of supported flash modes.\n   * @since 0.0.1\n   */\n  getSupportedFlashModes(): Promise<{\n    result: CameraPreviewFlashMode[];\n  }>;\n\n  /**\n   * Set the aspect ratio of the camera preview.\n   *\n   * @param {{ aspectRatio: '4:3' | '16:9'; x?: number; y?: number }} options - The desired aspect ratio and optional position.\n   *   - aspectRatio: The desired aspect ratio ('4:3' or '16:9')\n   *   - x: Optional x coordinate for positioning. If not provided, view will be auto-centered horizontally.\n   *   - y: Optional y coordinate for positioning. If not provided, view will be auto-centered vertically.\n   * @returns {Promise<{ width: number; height: number; x: number; y: number }>} A promise that resolves with the actual preview dimensions and position.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  setAspectRatio(options: {\n    aspectRatio: \"4:3\" | \"16:9\";\n    x?: number;\n    y?: number;\n  }): Promise<{\n    width: number;\n    height: number;\n    x: number;\n    y: number;\n  }>;\n\n  /**\n   * Gets the current aspect ratio of the camera preview.\n   *\n   * @returns {Promise<{ aspectRatio: '4:3' | '16:9' }>} A promise that resolves with the current aspect ratio.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  getAspectRatio(): Promise<{ aspectRatio: \"4:3\" | \"16:9\" }>;\n\n  /**\n   * Sets the grid mode of the camera preview overlay.\n   *\n   * @param {{ gridMode: GridMode }} options - The desired grid mode ('none', '3x3', or '4x4').\n   * @returns {Promise<void>} A promise that resolves when the grid mode is set.\n   * @since 8.0.0\n   */\n  setGridMode(options: { gridMode: GridMode }): Promise<void>;\n\n  /**\n   * Gets the current grid mode of the camera preview overlay.\n   *\n   * @returns {Promise<{ gridMode: GridMode }>} A promise that resolves with the current grid mode.\n   * @since 8.0.0\n   */\n  getGridMode(): Promise<{ gridMode: GridMode }>;\n\n  /**\n   * Gets the horizontal field of view (FoV) for the active camera.\n   * Note: This can be an estimate on some devices.\n   *\n   * @returns {Promise<{ result: number }>} A promise that resolves with the horizontal field of view in degrees.\n   * @since 0.0.1\n   */\n  getHorizontalFov(): Promise<{\n    result: number;\n  }>;\n\n  /**\n   * Gets the supported picture sizes for all cameras.\n   *\n   * @returns {Promise<{ supportedPictureSizes: SupportedPictureSizes[] }>} A promise that resolves with the list of supported sizes.\n   * @since 7.4.0\n   */\n  getSupportedPictureSizes(): Promise<{\n    supportedPictureSizes: SupportedPictureSizes[];\n  }>;\n\n  /**\n   * Sets the flash mode for the active camera.\n   *\n   * @param {{ flashMode: CameraPreviewFlashMode | string }} options - The desired flash mode.\n   * @returns {Promise<void>} A promise that resolves when the flash mode is set.\n   * @since 0.0.1\n   */\n  setFlashMode(options: {\n    flashMode: CameraPreviewFlashMode | string;\n  }): Promise<void>;\n\n  /**\n   * Toggles between the front and rear cameras.\n   *\n   * @returns {Promise<void>} A promise that resolves when the camera is flipped.\n   * @since 0.0.1\n   */\n  flip(): Promise<void>;\n\n  /**\n   * Sets the opacity of the camera preview.\n   *\n   * @param {CameraOpacityOptions} options - The opacity options.\n   * @returns {Promise<void>} A promise that resolves when the opacity is set.\n   * @since 0.0.1\n   */\n  setOpacity(options: CameraOpacityOptions): Promise<void>;\n\n  /**\n   * Stops an ongoing video recording.\n   *\n   * @returns {Promise<{ videoFilePath: string }>} A promise that resolves with the path to the recorded video file.\n   * @since 0.0.1\n   */\n  stopRecordVideo(): Promise<{ videoFilePath: string }>;\n\n  /**\n   * Starts recording a video.\n   *\n   * @param {CameraPreviewOptions} options - The options for video recording. Only iOS.\n   * @returns {Promise<void>} A promise that resolves when video recording starts.\n   * @since 0.0.1\n   */\n  startRecordVideo(options: CameraPreviewOptions): Promise<void>;\n\n  /**\n   * Checks if the camera preview is currently running.\n   *\n   * @returns {Promise<{ isRunning: boolean }>} A promise that resolves with the running state.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  isRunning(): Promise<{ isRunning: boolean }>;\n\n  /**\n   * Gets all available camera devices.\n   *\n   * @returns {Promise<{ devices: CameraDevice[] }>} A promise that resolves with the list of available camera devices.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  getAvailableDevices(): Promise<{ devices: CameraDevice[] }>;\n\n  /**\n   * Gets the current zoom state, including min/max and current lens info.\n   *\n   * @returns {Promise<{ min: number; max: number; current: number; lens: LensInfo }>} A promise that resolves with the zoom state.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  getZoom(): Promise<{\n    min: number;\n    max: number;\n    current: number;\n    lens: LensInfo;\n  }>;\n\n  /**\n   * Returns zoom button values for quick switching.\n   * - iOS/Android: includes 0.5 if ultra-wide available; 1 and 2 if wide available; 3 if telephoto available\n   * - Web: unsupported\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  getZoomButtonValues(): Promise<{ values: number[] }>;\n\n  /**\n   * Sets the zoom level of the camera.\n   *\n   * @param {{ level: number; ramp?: boolean; autoFocus?: boolean }} options - The desired zoom level. `ramp` is currently unused. `autoFocus` defaults to true.\n   * @returns {Promise<void>} A promise that resolves when the zoom level is set.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  setZoom(options: {\n    level: number;\n    ramp?: boolean;\n    autoFocus?: boolean;\n  }): Promise<void>;\n\n  /**\n   * Gets the current flash mode.\n   *\n   * @returns {Promise<{ flashMode: FlashMode }>} A promise that resolves with the current flash mode.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  getFlashMode(): Promise<{ flashMode: FlashMode }>;\n\n  /**\n   * Removes all registered listeners.\n   *\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  removeAllListeners(): Promise<void>;\n\n  /**\n   * Switches the active camera to the one with the specified `deviceId`.\n   *\n   * @param {{ deviceId: string }} options - The ID of the device to switch to.\n   * @returns {Promise<void>} A promise that resolves when the camera is switched.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  setDeviceId(options: { deviceId: string }): Promise<void>;\n\n  /**\n   * Gets the ID of the currently active camera device.\n   *\n   * @returns {Promise<{ deviceId: string }>} A promise that resolves with the current device ID.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  getDeviceId(): Promise<{ deviceId: string }>;\n\n  /**\n   * Gets the current preview size and position.\n   * @returns {Promise<{x: number, y: number, width: number, height: number}>}\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  getPreviewSize(): Promise<{\n    x: number;\n    y: number;\n    width: number;\n    height: number;\n  }>;\n  /**\n   * Sets the preview size and position.\n   * @param options The new position and dimensions.\n   * @returns {Promise<{ width: number; height: number; x: number; y: number }>} A promise that resolves with the actual preview dimensions and position.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  setPreviewSize(options: {\n    x?: number;\n    y?: number;\n    width: number;\n    height: number;\n  }): Promise<{\n    width: number;\n    height: number;\n    x: number;\n    y: number;\n  }>;\n\n  /**\n   * Sets the camera focus to a specific point in the preview.\n   *\n   * Note: The plugin does not attach any native tap-to-focus gesture handlers. Handle taps in\n   * your HTML/JS (e.g., on the overlaying UI), then pass normalized coordinates here.\n   *\n   * @param {Object} options - The focus options.\n   * @param {number} options.x - The x coordinate in the preview view to focus on (0-1 normalized).\n   * @param {number} options.y - The y coordinate in the preview view to focus on (0-1 normalized).\n   * @returns {Promise<void>} A promise that resolves when the focus is set.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  setFocus(options: { x: number; y: number }): Promise<void>;\n\n  /**\n   * Adds a listener for screen resize events.\n   * @param {string} eventName - The event name to listen for.\n   * @param {Function} listenerFunc - The function to call when the event is triggered.\n   * @returns {Promise<PluginListenerHandle>} A promise that resolves with a handle to the listener.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  addListener(\n    eventName: \"screenResize\",\n    listenerFunc: (data: {\n      width: number;\n      height: number;\n      x: number;\n      y: number;\n    }) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Adds a listener for orientation change events.\n   * @param {string} eventName - The event name to listen for.\n   * @param {Function} listenerFunc - The function to call when the event is triggered.\n   * @returns {Promise<PluginListenerHandle>} A promise that resolves with a handle to the listener.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  addListener(\n    eventName: \"orientationChange\",\n    listenerFunc: (data: { orientation: DeviceOrientation }) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Deletes a file at the given absolute path on the device.\n   * Use this to quickly clean up temporary images created with `storeToFile`.\n   * On web, this is not supported and will throw.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  deleteFile(options: { path: string }): Promise<{ success: boolean }>;\n\n  /**\n   * Gets the safe area insets for devices.\n   * Returns the orientation-aware notch/camera cutout inset and the current orientation.\n   * In portrait mode: returns top inset (notch at top).\n   * In landscape mode: returns left inset (notch moved to side).\n   * This specifically targets the cutout area (notch, punch hole, etc.) that all modern phones have.\n   *\n   * Android: Values returned in dp (logical pixels).\n   * iOS: Values returned in physical pixels, excluding status bar (only pure notch/cutout size).\n   *\n   * @platform android, ios\n   */\n  getSafeAreaInsets(): Promise<SafeAreaInsets>;\n\n  /**\n   * Gets the current device orientation in a cross-platform format.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  getOrientation(): Promise<{ orientation: DeviceOrientation }>;\n\n  /**\n   * Returns the exposure modes supported by the active camera.\n   * Modes can include: 'locked', 'auto', 'continuous', 'custom'.\n   * @platform android, ios\n   */\n  getExposureModes(): Promise<{ modes: ExposureMode[] }>;\n\n  /**\n   * Returns the current exposure mode.\n   * @platform android, ios\n   */\n  getExposureMode(): Promise<{ mode: ExposureMode }>;\n\n  /**\n   * Sets the exposure mode.\n   * @platform android, ios\n   */\n  setExposureMode(options: { mode: ExposureMode }): Promise<void>;\n\n  /**\n   * Returns the exposure compensation (EV bias) supported range.\n   * @platform ios\n   */\n  getExposureCompensationRange(): Promise<{\n    min: number;\n    max: number;\n    step: number;\n  }>;\n\n  /**\n   * Returns the current exposure compensation (EV bias).\n   * @platform ios\n   */\n  getExposureCompensation(): Promise<{ value: number }>;\n\n  /**\n   * Sets the exposure compensation (EV bias). Value will be clamped to range.\n   * @platform ios\n   */\n  setExposureCompensation(options: { value: number }): Promise<void>;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAUA,MAAM,CAAN,IAAY,UAQX;AARD,WAAY,UAAU;IACpB,sCAAwB,CAAA;IACxB,sCAAwB,CAAA;IACxB,qCAAuB,CAAA;IACvB,sCAAwB,CAAA;IACxB,2BAAa,CAAA;IACb,oCAAsB,CAAA;IACtB,+BAAiB,CAAA;AACnB,CAAC,EARW,UAAU,KAAV,UAAU,QAQrB","sourcesContent":["import type { PluginListenerHandle } from \"@capacitor/core\";\n\nexport type CameraPosition = \"rear\" | \"front\";\n\nexport type FlashMode = CameraPreviewFlashMode;\n\nexport type GridMode = \"none\" | \"3x3\" | \"4x4\";\n\nexport type CameraPositioning = \"center\" | \"top\" | \"bottom\";\n\nexport enum DeviceType {\n  ULTRA_WIDE = \"ultraWide\",\n  WIDE_ANGLE = \"wideAngle\",\n  TELEPHOTO = \"telephoto\",\n  TRUE_DEPTH = \"trueDepth\",\n  DUAL = \"dual\",\n  DUAL_WIDE = \"dualWide\",\n  TRIPLE = \"triple\",\n}\n\n/**\n * Represents a single camera lens on a device. A {@link CameraDevice} can have multiple lenses.\n */\nexport interface CameraLens {\n  /** A human-readable name for the lens, e.g., \"Ultra-Wide\". */\n  label: string;\n  /** The type of the camera lens. */\n  deviceType: DeviceType;\n  /** The focal length of the lens in millimeters. */\n  focalLength: number;\n  /** The base zoom factor for this lens (e.g., 0.5 for ultra-wide, 1.0 for wide). */\n  baseZoomRatio: number;\n  /** The minimum zoom factor supported by this specific lens. */\n  minZoom: number;\n  /** The maximum zoom factor supported by this specific lens. */\n  maxZoom: number;\n}\n\n/**\n * Represents a physical camera on the device (e.g., the front-facing camera).\n */\nexport interface CameraDevice {\n  /** A unique identifier for the camera device. */\n  deviceId: string;\n  /** A human-readable name for the camera device. */\n  label: string;\n  /** The physical position of the camera on the device. */\n  position: CameraPosition;\n  /** A list of all available lenses for this camera device. */\n  lenses: CameraLens[];\n  /** The overall minimum zoom factor available across all lenses on this device. */\n  minZoom: number;\n  /** The overall maximum zoom factor available across all lenses on this device. */\n  maxZoom: number;\n  /** Identifies whether the device is a logical camera (composed of multiple physical lenses). */\n  isLogical: boolean;\n}\n\n/**\n * Represents the detailed information of the currently active lens.\n */\nexport interface LensInfo {\n  /** The focal length of the active lens in millimeters. */\n  focalLength: number;\n  /** The device type of the active lens. */\n  deviceType: DeviceType;\n  /** The base zoom ratio of the active lens (e.g., 0.5x, 1.0x). */\n  baseZoomRatio: number;\n  /** The current digital zoom factor applied on top of the base zoom. */\n  digitalZoom: number;\n}\n\n/**\n * Defines the configuration options for starting the camera preview.\n */\nexport interface CameraPreviewOptions {\n  /**\n   * The parent element to attach the video preview to.\n   * @platform web\n   */\n  parent?: string;\n  /**\n   * A CSS class name to add to the preview element.\n   * @platform web\n   */\n  className?: string;\n  /**\n   * The width of the preview in pixels. Defaults to the screen width.\n   * @platform android, ios, web\n   */\n  width?: number;\n  /**\n   * The height of the preview in pixels. Defaults to the screen height.\n   * @platform android, ios, web\n   */\n  height?: number;\n  /**\n   * The horizontal origin of the preview, in pixels.\n   * @platform android, ios\n   */\n  x?: number;\n  /**\n   * The vertical origin of the preview, in pixels.\n   * @platform android, ios\n   */\n  y?: number;\n  /**\n   * The aspect ratio of the camera preview, '4:3' or '16:9' or 'fill'.\n   * Cannot be set if width or height is provided, otherwise the call will be rejected.\n   * Use setPreviewSize to adjust size after starting.\n   *\n   * @since 2.0.0\n   */\n  aspectRatio?: \"4:3\" | \"16:9\";\n  /**\n   * The grid overlay to display on the camera preview.\n   * @default \"none\"\n   * @since 2.1.0\n   */\n  gridMode?: GridMode;\n  /**\n   * Adjusts the y-position to account for safe areas (e.g., notches).\n   * @platform ios\n   * @default false\n   */\n  includeSafeAreaInsets?: boolean;\n  /**\n   * If true, places the preview behind the webview.\n   * @platform android\n   * @default true\n   */\n  toBack?: boolean;\n  /**\n   * Bottom padding for the preview, in pixels.\n   * @platform android, ios\n   */\n  paddingBottom?: number;\n  /**\n   * Whether to rotate the preview when the device orientation changes.\n   * @platform ios\n   * @default true\n   */\n  rotateWhenOrientationChanged?: boolean;\n  /**\n   * The camera to use.\n   * @default \"rear\"\n   */\n  position?: CameraPosition | string;\n  /**\n   * If true, saves the captured image to a file and returns the file path.\n   * If false, returns a base64 encoded string.\n   * @default false\n   */\n  storeToFile?: boolean;\n  /**\n   * If true, prevents the plugin from rotating the image based on EXIF data.\n   * @platform android\n   * @default false\n   */\n  disableExifHeaderStripping?: boolean;\n  /**\n   * If true, disables the audio stream, preventing audio permission requests.\n   * @default true\n   */\n  disableAudio?: boolean;\n  /**\n   * If true, locks the device orientation while the camera is active.\n   * @platform android\n   * @default false\n   */\n  lockAndroidOrientation?: boolean;\n  /**\n   * If true, allows the camera preview's opacity to be changed.\n   * @platform android, web\n   * @default false\n   */\n  enableOpacity?: boolean;\n\n  /**\n   * If true, disables the visual focus indicator when tapping to focus.\n   * @platform android, ios\n   * @default false\n   */\n  disableFocusIndicator?: boolean;\n  /**\n   * The `deviceId` of the camera to use. If provided, `position` is ignored.\n   * @platform ios\n   */\n  deviceId?: string;\n  /**\n   * The initial zoom level when starting the camera preview.\n   * If the requested zoom level is not available, the native plugin will reject.\n   * @default 1.0\n   * @platform android, ios\n   * @since 2.2.0\n   */\n  initialZoomLevel?: number;\n  /**\n   * The vertical positioning of the camera preview.\n   * @default \"center\"\n   * @platform android, ios, web\n   * @since 2.3.0\n   */\n  positioning?: CameraPositioning;\n  /**\n   * If true, enables video capture capabilities when the camera starts.\n   * @default false\n   * @platform android\n   * @since 7.11.0\n   */\n  enableVideoMode?: boolean;\n}\n\n/**\n * Defines the options for capturing a picture.\n */\nexport interface CameraPreviewPictureOptions {\n  /**\n   * The maximum height of the picture in pixels. The image will be resized to fit within this height while maintaining aspect ratio.\n   * If not specified the captured image will match the preview's visible area.\n   */\n  height?: number;\n  /**\n   * The maximum width of the picture in pixels. The image will be resized to fit within this width while maintaining aspect ratio.\n   * If not specified the captured image will match the preview's visible area.\n   */\n  width?: number;\n  /**\n   * The quality of the captured image, from 0 to 100.\n   * Does not apply to `png` format.\n   * @default 85\n   */\n  quality?: number;\n  /**\n   * The format of the captured image.\n   * @default \"jpeg\"\n   */\n  format?: PictureFormat;\n  /**\n   * If true, the captured image will be saved to the user's gallery.\n   * @default false\n   * @since 7.5.0\n   */\n  saveToGallery?: boolean;\n  /**\n   * If true, the plugin will attempt to add GPS location data to the image's EXIF metadata.\n   * This may prompt the user for location permissions.\n   * @default false\n   * @since 7.6.0\n   */\n  withExifLocation?: boolean;\n  /**\n   * If true, the plugin will embed a timestamp in the top-right corner of the image.\n   * @default false\n   * @since 7.17.0\n   */\n  embedTimestamp?: boolean;\n  /**\n   * If true, the plugin will embed the current location in the top-right corner of the image.\n   * Requires `withExifLocation` to be enabled.\n   * @default false\n   * @since 7.18.0\n   */\n  embedLocation?: boolean;\n}\n\n/** Represents EXIF data extracted from an image. */\nexport interface ExifData {\n  [key: string]: any;\n}\n\nexport type PictureFormat = \"jpeg\" | \"png\";\n\n/** Defines a standard picture size with width and height. */\nexport interface PictureSize {\n  /** The width of the picture in pixels. */\n  width: number;\n  /** The height of the picture in pixels. */\n  height: number;\n}\n\n/** Represents the supported picture sizes for a camera facing a certain direction. */\nexport interface SupportedPictureSizes {\n  /** The camera direction (\"front\" or \"rear\"). */\n  facing: string;\n  /** A list of supported picture sizes for this camera. */\n  supportedPictureSizes: PictureSize[];\n}\n\n/**\n * Defines the options for capturing a sample frame from the camera preview.\n */\nexport interface CameraSampleOptions {\n  /**\n   * The quality of the captured sample, from 0 to 100.\n   * @default 85\n   */\n  quality?: number;\n}\n\n/**\n * The available flash modes for the camera.\n * 'torch' is a continuous light mode.\n */\nexport type CameraPreviewFlashMode = \"off\" | \"on\" | \"auto\" | \"torch\";\n\n/** Reusable exposure mode type for cross-platform support. */\nexport type ExposureMode = \"AUTO\" | \"LOCK\" | \"CONTINUOUS\" | \"CUSTOM\";\n\n/**\n * Defines the options for setting the camera preview's opacity.\n */\nexport interface CameraOpacityOptions {\n  /**\n   * The opacity percentage, from 0.0 (fully transparent) to 1.0 (fully opaque).\n   * @default 1.0\n   */\n  opacity?: number;\n}\n\n/**\n * Represents safe area insets for devices.\n * Android: Values are expressed in logical pixels (dp) to match JS layout units.\n * iOS: Values are expressed in physical pixels and exclude status bar.\n */\nexport interface SafeAreaInsets {\n  /** Current device orientation (1 = portrait, 2 = landscape, 0 = unknown). */\n  orientation: number;\n  /**\n   * Orientation-aware notch/camera cutout inset (excluding status bar).\n   * In portrait mode: returns top inset (notch at top).\n   * In landscape mode: returns left inset (notch at side).\n   * Android: Value in dp, iOS: Value in pixels (status bar excluded).\n   */\n  top: number;\n}\n\n/**\n * Canonical device orientation values across platforms.\n */\nexport type DeviceOrientation =\n  | \"portrait\"\n  | \"landscape-left\"\n  | \"landscape-right\"\n  | \"portrait-upside-down\"\n  | \"unknown\";\n\n/**\n * The main interface for the CameraPreview plugin.\n */\nexport interface CameraPreviewPlugin {\n  /**\n   * Starts the camera preview.\n   *\n   * @param {CameraPreviewOptions} options - The configuration for the camera preview.\n   * @returns {Promise<{ width: number; height: number; x: number; y: number }>} A promise that resolves with the preview dimensions.\n   * @since 0.0.1\n   */\n  start(options: CameraPreviewOptions): Promise<{\n    /** The width of the preview in pixels. */\n    width: number;\n    /** The height of the preview in pixels. */\n    height: number;\n    /** The horizontal origin of the preview, in pixels. */\n    x: number;\n    /** The vertical origin of the preview, in pixels. */\n    y: number;\n  }>;\n\n  /**\n   * Stops the camera preview.\n   *\n   * @returns {Promise<void>} A promise that resolves when the camera preview is stopped.\n   * @since 0.0.1\n   */\n  stop(): Promise<void>;\n\n  /**\n   * Captures a picture from the camera.\n   *\n   * If `storeToFile` was set to `true` when starting the preview, the returned\n   * `value` will be an absolute file path on the device instead of a base64 string. Use getBase64FromFilePath to get the base64 string from the file path.\n   *\n   * @param {CameraPreviewPictureOptions} options - The options for capturing the picture.\n   * @returns {Promise<{ value: string; exif: ExifData }>} Resolves with:\n   *   - `value`: base64 string, or file path if `storeToFile` is true\n   *   - `exif`: extracted EXIF metadata when available\n   * @since 0.0.1\n   */\n  capture(\n    options: CameraPreviewPictureOptions,\n  ): Promise<{ value: string; exif: ExifData }>;\n\n  /**\n   * Captures a single frame from the camera preview stream.\n   *\n   * @param {CameraSampleOptions} options - The options for capturing the sample.\n   * @returns {Promise<{ value: string }>} A promise that resolves with the sample image as a base64 encoded string.\n   * @since 0.0.1\n   */\n  captureSample(options: CameraSampleOptions): Promise<{ value: string }>;\n\n  /**\n   * Gets the flash modes supported by the active camera.\n   *\n   * @returns {Promise<{ result: CameraPreviewFlashMode[] }>} A promise that resolves with an array of supported flash modes.\n   * @since 0.0.1\n   */\n  getSupportedFlashModes(): Promise<{\n    result: CameraPreviewFlashMode[];\n  }>;\n\n  /**\n   * Set the aspect ratio of the camera preview.\n   *\n   * @param {{ aspectRatio: '4:3' | '16:9'; x?: number; y?: number }} options - The desired aspect ratio and optional position.\n   *   - aspectRatio: The desired aspect ratio ('4:3' or '16:9')\n   *   - x: Optional x coordinate for positioning. If not provided, view will be auto-centered horizontally.\n   *   - y: Optional y coordinate for positioning. If not provided, view will be auto-centered vertically.\n   * @returns {Promise<{ width: number; height: number; x: number; y: number }>} A promise that resolves with the actual preview dimensions and position.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  setAspectRatio(options: {\n    aspectRatio: \"4:3\" | \"16:9\";\n    x?: number;\n    y?: number;\n  }): Promise<{\n    width: number;\n    height: number;\n    x: number;\n    y: number;\n  }>;\n\n  /**\n   * Gets the current aspect ratio of the camera preview.\n   *\n   * @returns {Promise<{ aspectRatio: '4:3' | '16:9' }>} A promise that resolves with the current aspect ratio.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  getAspectRatio(): Promise<{ aspectRatio: \"4:3\" | \"16:9\" }>;\n\n  /**\n   * Sets the grid mode of the camera preview overlay.\n   *\n   * @param {{ gridMode: GridMode }} options - The desired grid mode ('none', '3x3', or '4x4').\n   * @returns {Promise<void>} A promise that resolves when the grid mode is set.\n   * @since 8.0.0\n   */\n  setGridMode(options: { gridMode: GridMode }): Promise<void>;\n\n  /**\n   * Gets the current grid mode of the camera preview overlay.\n   *\n   * @returns {Promise<{ gridMode: GridMode }>} A promise that resolves with the current grid mode.\n   * @since 8.0.0\n   */\n  getGridMode(): Promise<{ gridMode: GridMode }>;\n\n  /**\n   * Gets the horizontal field of view (FoV) for the active camera.\n   * Note: This can be an estimate on some devices.\n   *\n   * @returns {Promise<{ result: number }>} A promise that resolves with the horizontal field of view in degrees.\n   * @since 0.0.1\n   */\n  getHorizontalFov(): Promise<{\n    result: number;\n  }>;\n\n  /**\n   * Gets the supported picture sizes for all cameras.\n   *\n   * @returns {Promise<{ supportedPictureSizes: SupportedPictureSizes[] }>} A promise that resolves with the list of supported sizes.\n   * @since 7.4.0\n   */\n  getSupportedPictureSizes(): Promise<{\n    supportedPictureSizes: SupportedPictureSizes[];\n  }>;\n\n  /**\n   * Sets the flash mode for the active camera.\n   *\n   * @param {{ flashMode: CameraPreviewFlashMode | string }} options - The desired flash mode.\n   * @returns {Promise<void>} A promise that resolves when the flash mode is set.\n   * @since 0.0.1\n   */\n  setFlashMode(options: {\n    flashMode: CameraPreviewFlashMode | string;\n  }): Promise<void>;\n\n  /**\n   * Toggles between the front and rear cameras.\n   *\n   * @returns {Promise<void>} A promise that resolves when the camera is flipped.\n   * @since 0.0.1\n   */\n  flip(): Promise<void>;\n\n  /**\n   * Sets the opacity of the camera preview.\n   *\n   * @param {CameraOpacityOptions} options - The opacity options.\n   * @returns {Promise<void>} A promise that resolves when the opacity is set.\n   * @since 0.0.1\n   */\n  setOpacity(options: CameraOpacityOptions): Promise<void>;\n\n  /**\n   * Stops an ongoing video recording.\n   *\n   * @returns {Promise<{ videoFilePath: string }>} A promise that resolves with the path to the recorded video file.\n   * @since 0.0.1\n   */\n  stopRecordVideo(): Promise<{ videoFilePath: string }>;\n\n  /**\n   * Starts recording a video.\n   *\n   * @param {CameraPreviewOptions} options - The options for video recording. Only iOS.\n   * @returns {Promise<void>} A promise that resolves when video recording starts.\n   * @since 0.0.1\n   */\n  startRecordVideo(options: CameraPreviewOptions): Promise<void>;\n\n  /**\n   * Checks if the camera preview is currently running.\n   *\n   * @returns {Promise<{ isRunning: boolean }>} A promise that resolves with the running state.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  isRunning(): Promise<{ isRunning: boolean }>;\n\n  /**\n   * Gets all available camera devices.\n   *\n   * @returns {Promise<{ devices: CameraDevice[] }>} A promise that resolves with the list of available camera devices.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  getAvailableDevices(): Promise<{ devices: CameraDevice[] }>;\n\n  /**\n   * Gets the current zoom state, including min/max and current lens info.\n   *\n   * @returns {Promise<{ min: number; max: number; current: number; lens: LensInfo }>} A promise that resolves with the zoom state.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  getZoom(): Promise<{\n    min: number;\n    max: number;\n    current: number;\n    lens: LensInfo;\n  }>;\n\n  /**\n   * Returns zoom button values for quick switching.\n   * - iOS/Android: includes 0.5 if ultra-wide available; 1 and 2 if wide available; 3 if telephoto available\n   * - Web: unsupported\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  getZoomButtonValues(): Promise<{ values: number[] }>;\n\n  /**\n   * Sets the zoom level of the camera.\n   *\n   * @param {{ level: number; ramp?: boolean; autoFocus?: boolean }} options - The desired zoom level. `ramp` is currently unused. `autoFocus` defaults to true.\n   * @returns {Promise<void>} A promise that resolves when the zoom level is set.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  setZoom(options: {\n    level: number;\n    ramp?: boolean;\n    autoFocus?: boolean;\n  }): Promise<void>;\n\n  /**\n   * Gets the current flash mode.\n   *\n   * @returns {Promise<{ flashMode: FlashMode }>} A promise that resolves with the current flash mode.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  getFlashMode(): Promise<{ flashMode: FlashMode }>;\n\n  /**\n   * Removes all registered listeners.\n   *\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  removeAllListeners(): Promise<void>;\n\n  /**\n   * Switches the active camera to the one with the specified `deviceId`.\n   *\n   * @param {{ deviceId: string }} options - The ID of the device to switch to.\n   * @returns {Promise<void>} A promise that resolves when the camera is switched.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  setDeviceId(options: { deviceId: string }): Promise<void>;\n\n  /**\n   * Gets the ID of the currently active camera device.\n   *\n   * @returns {Promise<{ deviceId: string }>} A promise that resolves with the current device ID.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  getDeviceId(): Promise<{ deviceId: string }>;\n\n  /**\n   * Gets the current preview size and position.\n   * @returns {Promise<{x: number, y: number, width: number, height: number}>}\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  getPreviewSize(): Promise<{\n    x: number;\n    y: number;\n    width: number;\n    height: number;\n  }>;\n  /**\n   * Sets the preview size and position.\n   * @param options The new position and dimensions.\n   * @returns {Promise<{ width: number; height: number; x: number; y: number }>} A promise that resolves with the actual preview dimensions and position.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  setPreviewSize(options: {\n    x?: number;\n    y?: number;\n    width: number;\n    height: number;\n  }): Promise<{\n    width: number;\n    height: number;\n    x: number;\n    y: number;\n  }>;\n\n  /**\n   * Sets the camera focus to a specific point in the preview.\n   *\n   * Note: The plugin does not attach any native tap-to-focus gesture handlers. Handle taps in\n   * your HTML/JS (e.g., on the overlaying UI), then pass normalized coordinates here.\n   *\n   * @param {Object} options - The focus options.\n   * @param {number} options.x - The x coordinate in the preview view to focus on (0-1 normalized).\n   * @param {number} options.y - The y coordinate in the preview view to focus on (0-1 normalized).\n   * @returns {Promise<void>} A promise that resolves when the focus is set.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  setFocus(options: { x: number; y: number }): Promise<void>;\n\n  /**\n   * Adds a listener for screen resize events.\n   * @param {string} eventName - The event name to listen for.\n   * @param {Function} listenerFunc - The function to call when the event is triggered.\n   * @returns {Promise<PluginListenerHandle>} A promise that resolves with a handle to the listener.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  addListener(\n    eventName: \"screenResize\",\n    listenerFunc: (data: {\n      width: number;\n      height: number;\n      x: number;\n      y: number;\n    }) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Adds a listener for orientation change events.\n   * @param {string} eventName - The event name to listen for.\n   * @param {Function} listenerFunc - The function to call when the event is triggered.\n   * @returns {Promise<PluginListenerHandle>} A promise that resolves with a handle to the listener.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  addListener(\n    eventName: \"orientationChange\",\n    listenerFunc: (data: { orientation: DeviceOrientation }) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Deletes a file at the given absolute path on the device.\n   * Use this to quickly clean up temporary images created with `storeToFile`.\n   * On web, this is not supported and will throw.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  deleteFile(options: { path: string }): Promise<{ success: boolean }>;\n\n  /**\n   * Gets the safe area insets for devices.\n   * Returns the orientation-aware notch/camera cutout inset and the current orientation.\n   * In portrait mode: returns top inset (notch at top).\n   * In landscape mode: returns left inset (notch moved to side).\n   * This specifically targets the cutout area (notch, punch hole, etc.) that all modern phones have.\n   *\n   * Android: Values returned in dp (logical pixels).\n   * iOS: Values returned in physical pixels, excluding status bar (only pure notch/cutout size).\n   *\n   * @platform android, ios\n   */\n  getSafeAreaInsets(): Promise<SafeAreaInsets>;\n\n  /**\n   * Gets the current device orientation in a cross-platform format.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  getOrientation(): Promise<{ orientation: DeviceOrientation }>;\n\n  /**\n   * Returns the exposure modes supported by the active camera.\n   * Modes can include: 'locked', 'auto', 'continuous', 'custom'.\n   * @platform android, ios\n   */\n  getExposureModes(): Promise<{ modes: ExposureMode[] }>;\n\n  /**\n   * Returns the current exposure mode.\n   * @platform android, ios\n   */\n  getExposureMode(): Promise<{ mode: ExposureMode }>;\n\n  /**\n   * Sets the exposure mode.\n   * @platform android, ios\n   */\n  setExposureMode(options: { mode: ExposureMode }): Promise<void>;\n\n  /**\n   * Returns the exposure compensation (EV bias) supported range.\n   * @platform ios\n   */\n  getExposureCompensationRange(): Promise<{\n    min: number;\n    max: number;\n    step: number;\n  }>;\n\n  /**\n   * Returns the current exposure compensation (EV bias).\n   * @platform ios\n   */\n  getExposureCompensation(): Promise<{ value: number }>;\n\n  /**\n   * Sets the exposure compensation (EV bias). Value will be clamped to range.\n   * @platform ios\n   */\n  setExposureCompensation(options: { value: number }): Promise<void>;\n}\n"]}

package/ios/Sources/CapgoCameraPreviewPlugin/CameraController.swift

@@ -889,7 +889,7 @@ extension CameraController {
         self.updateVideoOrientation()
     }
 
-    func captureImage(width: Int?, height: Int?, quality: Float, gpsLocation: CLLocation?, embedTimestamp: Bool, completion: @escaping (UIImage?, Data?, [AnyHashable: Any]?, Error?) -> Void) {
+    func captureImage(width: Int?, height: Int?, quality: Float, gpsLocation: CLLocation?, embedTimestamp: Bool, embedLocation: Bool, completion: @escaping (UIImage?, Data?, [AnyHashable: Any]?, Error?) -> Void) {
         guard let photoOutput = self.photoOutput else {
             completion(nil, nil, nil, NSError(domain: "Camera", code: 0, userInfo: [NSLocalizedDescriptionKey: "Photo output is not available"]))
             return
@@ -973,10 +973,21 @@ extension CameraController {
                 print("[CameraPreview] Applied aspect ratio cropping for \(aspectRatio): \(finalImage.size.width)x\(finalImage.size.height)")
             }
 
-            // Embed timestamp if requested
-            if embedTimestamp {
-                let when = self.makeTimestampString(from: photoData, metadata: metadata)
-                finalImage = self.drawTimestamp(text: when, on: finalImage)
+            // Draw overlays if either flag is set (timestamp and/or location)
+            if embedTimestamp || embedLocation {
+                let when: String? = embedTimestamp
+                    ? self.makeTimestampString(from: photoData, metadata: metadata)
+                    : nil
+
+                let whereStr: String? = embedLocation
+                    ? self.makeLocationString(from: gpsLocation, photoData: photoData, metadata: metadata)
+                    : nil
+
+                if (when?.isEmpty ?? true) && (whereStr?.isEmpty ?? true) {
+                    // Nothing to draw (e.g., embedLocation=true but no GPS present) → skip
+                } else {
+                    finalImage = self.drawTimestampAndLocation(on: finalImage, when: when, where: whereStr)
+                }
             }
 
             completion(finalImage, photoData, metadata, nil)
@@ -991,42 +1002,24 @@ extension CameraController {
         photoOutput.capturePhoto(with: settings, delegate: self)
     }
 
-    /// Draws a timestamp bubble at the top-right of the image and returns a new image.
-    func drawTimestamp(text: String, on image: UIImage) -> UIImage {
-        let textColor: UIColor = .white
-        // Slightly lighter/clearer than before (matches iOS feel better)
-        let backgroundColor: UIColor = UIColor(white: 0.12, alpha: 0.22)
-        let paddingH: CGFloat = 16    // horizontal
-        let paddingV: CGFloat = 10    // vertical
-        let cornerRadius: CGFloat = 10
-        let drawsShadow = true
-
+    /// Draws timestamp and/or location pills at the top-right. Pass nil to skip either line.
+    func drawTimestampAndLocation(on image: UIImage, when: String?, where whereStr: String?) -> UIImage {
         let base = image.fixedOrientation() ?? image
         let scale = base.scale
         let size  = base.size
 
-        // ≈3.5% of image width (clamped to ≥10pt)
-        let fontPointSize: CGFloat = max(10, size.width * 0.035)
-        // San Francisco system font is what the Camera/Photos overlays use
-        let font: UIFont = .systemFont(ofSize: fontPointSize, weight: .semibold)
-
-        let attrs: [NSAttributedString.Key: Any] = [
-            .font: font,
-            .foregroundColor: textColor
-        ]
-        let textSize = (text as NSString).size(withAttributes: attrs)
-
-        // Bubble rect (top-right)
-        let bgSize  = CGSize(width: textSize.width + paddingH * 2,
-                             height: textSize.height + paddingV * 2)
-        let margin: CGFloat = 12 // distance from edges of the photo
-        let bgOrigin = CGPoint(x: size.width - bgSize.width - margin,
-                               y: margin)
-        let bgRect = CGRect(origin: bgOrigin, size: bgSize)
+        // Style (match drawTimestamp)
+        let textColor: UIColor = .white
+        let backgroundColor = UIColor(white: 0.12, alpha: 0.22)
+        let paddingH: CGFloat = 16
+        let paddingV: CGFloat = 10
+        let cornerRadius: CGFloat = 10
+        let margin: CGFloat = 12
+        let gap: CGFloat = 8
 
-        // Text origin inside bubble
-        let textOrigin = CGPoint(x: bgRect.minX + paddingH,
-                                 y: bgRect.minY + paddingV)
+        // ≈3.5% of image width (≥10pt)
+        let fontPointSize = max(10, size.width * 0.035)
+        let font: UIFont = .systemFont(ofSize: fontPointSize, weight: .semibold)
 
         let format = UIGraphicsImageRendererFormat.default()
         format.scale = scale
@@ -1035,32 +1028,46 @@ extension CameraController {
         return UIGraphicsImageRenderer(size: size, format: format).image { ctx in
             base.draw(in: CGRect(origin: .zero, size: size))
 
-            // Bubble
-            let bubblePath = UIBezierPath(roundedRect: bgRect, cornerRadius: cornerRadius)
-            if drawsShadow {
+            func drawPill(_ text: String, top: CGFloat) -> CGFloat {
+                let attrs: [NSAttributedString.Key: Any] = [.font: font, .foregroundColor: textColor]
+                let textSize = (text as NSString).size(withAttributes: attrs)
+                let bgSize  = CGSize(width: textSize.width + paddingH * 2,
+                                     height: textSize.height + paddingV * 2)
+                let origin  = CGPoint(x: size.width - bgSize.width - margin, y: top)
+                let rect    = CGRect(origin: origin, size: bgSize)
+
+                // shadowed rounded bg
+                let path = UIBezierPath(roundedRect: rect, cornerRadius: cornerRadius)
                 ctx.cgContext.saveGState()
                 ctx.cgContext.setShadow(offset: CGSize(width: 0, height: 2),
                                         blur: 6,
                                         color: UIColor.black.withAlphaComponent(0.25).cgColor)
                 backgroundColor.setFill()
-                bubblePath.fill()
+                path.fill()
                 ctx.cgContext.restoreGState()
-            } else {
-                backgroundColor.setFill()
-                bubblePath.fill()
-            }
 
-            // High-quality text rendering
-            let g = ctx.cgContext
-            g.setAllowsAntialiasing(true)
-            g.setShouldAntialias(true)
-            g.setAllowsFontSmoothing(true)
-            g.setShouldSmoothFonts(true)
-            g.setShouldSubpixelPositionFonts(true)
-            g.interpolationQuality = .high
+                // high-quality text
+                let g = ctx.cgContext
+                g.setAllowsAntialiasing(true)
+                g.setShouldAntialias(true)
+                g.setAllowsFontSmoothing(true)
+                g.setShouldSmoothFonts(true)
+                g.setShouldSubpixelPositionFonts(true)
+                g.interpolationQuality = .high
+
+                (text as NSString).draw(at: CGPoint(x: rect.minX + paddingH, y: rect.minY + paddingV),
+                                        withAttributes: attrs)
 
-            // Single pass: fill only (no stroke/outline)
-            (text as NSString).draw(at: textOrigin, withAttributes: attrs)
+                return rect.maxY
+            }
+
+            var top = margin
+            if let w = when, !w.isEmpty {
+                top = drawPill(w, top: top) + gap
+            }
+            if let loc = whereStr, !loc.isEmpty {
+                _ = drawPill(loc, top: (top == margin ? margin : top))
+            }
         }
     }
 
@@ -1104,6 +1111,44 @@ extension CameraController {
         return outFmt.string(from: Date())
     }
 
+    func makeLocationString(from location: CLLocation?,
+                            photoData: Data?,
+                            metadata: [AnyHashable: Any]?) -> String? {
+        // 1) Prefer the explicit CLLocation that was just provided
+        if let loc = location {
+            let lat = String(format: "%.5f", loc.coordinate.latitude)
+            let lon = String(format: "%.5f", loc.coordinate.longitude)
+            return "\(lat), \(lon)"
+        }
+
+        // 2) Fall back to EXIF GPS in metadata / photo data
+        func extractGPS(_ meta: [String: Any]) -> (Double, Double)? {
+            guard let gps = meta[kCGImagePropertyGPSDictionary as String] as? [String: Any] else { return nil }
+            if let lat = gps[kCGImagePropertyGPSLatitude as String] as? Double,
+               let latRef = gps[kCGImagePropertyGPSLatitudeRef as String] as? String,
+               let lon = gps[kCGImagePropertyGPSLongitude as String] as? Double,
+               let lonRef = gps[kCGImagePropertyGPSLongitudeRef as String] as? String {
+                let signedLat = (latRef.uppercased() == "S") ? -lat : lat
+                let signedLon = (lonRef.uppercased() == "W") ? -lon : lon
+                return (signedLat, signedLon)
+            }
+            return nil
+        }
+
+        if let md = metadata as? [String: Any], let (lat, lon) = extractGPS(md) {
+            return String(format: "%.5f, %.5f", lat, lon)
+        }
+
+        if let data = photoData,
+           let src = CGImageSourceCreateWithData(data as CFData, nil),
+           let props = CGImageSourceCopyPropertiesAtIndex(src, 0, nil) as? [String: Any],
+           let (lat, lon) = extractGPS(props) {
+            return String(format: "%.5f, %.5f", lat, lon)
+        }
+
+        return nil
+    }
+
     // Create JPEG data from `image`, merging the original EXIF/GPS/etc. and forcing Orientation=1.
     func jpegDataPreservingMetadata(from image: UIImage,
                                     originalPhotoData: Data?,

package/ios/Sources/CapgoCameraPreviewPlugin/Plugin.swift

@@ -856,12 +856,14 @@ public class CameraPreview: CAPPlugin, CAPBridgedPlugin, CLLocationManagerDelega
         let saveToGallery = call.getBool("saveToGallery", false)
         let withExifLocation = call.getBool("withExifLocation", false)
         let embedTimestamp = call.getBool("embedTimestamp", false) ?? false
+        let embedLocationRequested = call.getBool("embedLocation", false) ?? false
+        let effectiveEmbedLocation = (withExifLocation ?? false) && embedLocationRequested
         let width = call.getInt("width")
         let height = call.getInt("height")
 
         print("[CameraPreview] Raw parameter values - width: \(String(describing: width)), height: \(String(describing: height))")
 
-        print("[CameraPreview] Capture params - quality: \(quality), saveToGallery: \(saveToGallery), withExifLocation: \(withExifLocation), embedTimestamp: \(embedTimestamp), width: \(width ?? -1), height: \(height ?? -1)")
+        print("[CameraPreview] Capture params - quality: \(quality), saveToGallery: \(saveToGallery), withExifLocation: \(withExifLocation ?? false), embedTimestamp: \(embedTimestamp), embedLocation: \(effectiveEmbedLocation) (requested=\(embedLocationRequested)), width: \(width ?? -1), height: \(height ?? -1)")
         print("[CameraPreview] Current location: \(self.currentLocation?.description ?? "nil")")
         // Safely read frame from main thread for logging
         let (previewWidth, previewHeight): (CGFloat, CGFloat) = {
@@ -878,7 +880,8 @@ public class CameraPreview: CAPPlugin, CAPBridgedPlugin, CLLocationManagerDelega
         }()
         print("[CameraPreview] Preview dimensions: \(previewWidth)x\(previewHeight)")
 
-        self.cameraController.captureImage(width: width, height: height, quality: quality, gpsLocation: self.currentLocation, embedTimestamp: embedTimestamp) { (image, originalPhotoData, _, error) in
+        let gpsForThisCapture = (withExifLocation ?? false) ? self.currentLocation : nil
+        self.cameraController.captureImage(width: width, height: height, quality: quality, gpsLocation: gpsForThisCapture, embedTimestamp: embedTimestamp, embedLocation: effectiveEmbedLocation) { (image, originalPhotoData, _, error) in
             print("[CameraPreview] captureImage callback received")
             DispatchQueue.main.async {
                 print("[CameraPreview] Processing capture on main thread")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capgo/camera-preview",
-  "version": "7.17.1",
+  "version": "7.18.0",
   "description": "Camera preview",
   "license": "MIT",
   "repository": {