@capgo/camera-preview 7.4.0-beta.12 → 7.4.0-beta.15

package/README.md

@@ -241,6 +241,7 @@ Documentation for the [uploader](https://github.com/Cap-go/capacitor-uploader)
 * [`getDeviceId()`](#getdeviceid)
 * [`getPreviewSize()`](#getpreviewsize)
 * [`setPreviewSize(...)`](#setpreviewsize)
+* [`setFocus(...)`](#setfocus)
 * [Interfaces](#interfaces)
 * [Type Aliases](#type-aliases)
 * [Enums](#enums)
@@ -561,14 +562,14 @@ Gets the current zoom state, including min/max and current lens info.
 ### setZoom(...)
 
 ```typescript
-setZoom(options: { level: number; ramp?: boolean; }) => Promise<void>
+setZoom(options: { level: number; ramp?: boolean; autoFocus?: boolean; }) => Promise<void>
 ```
 
-Sets the camera's zoom level.
+Sets the zoom level of the camera.
 
-| Param         | Type                                            | Description                                           |
-| ------------- | ----------------------------------------------- | ----------------------------------------------------- |
-| **`options`** | <code>{ level: number; ramp?: boolean; }</code> | - The desired zoom level. `ramp` is currently unused. |
+| Param         | Type                                                                 | Description                                                                         |
+| ------------- | -------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
+| **`options`** | <code>{ level: number; ramp?: boolean; autoFocus?: boolean; }</code> | - The desired zoom level. `ramp` is currently unused. `autoFocus` defaults to true. |
 
 **Since:** 7.4.0
 
@@ -651,20 +652,37 @@ Gets the current preview size and position.
 ### setPreviewSize(...)
 
 ```typescript
-setPreviewSize(options: { x: number; y: number; width: number; height: number; }) => Promise<{ width: number; height: number; x: number; y: number; }>
+setPreviewSize(options: { x?: number; y?: number; width: number; height: number; }) => Promise<{ width: number; height: number; x: number; y: number; }>
 ```
 
 Sets the preview size and position.
 
-| Param         | Type                                                                  | Description                      |
-| ------------- | --------------------------------------------------------------------- | -------------------------------- |
-| **`options`** | <code>{ x: number; y: number; width: number; height: number; }</code> | The new position and dimensions. |
+| Param         | Type                                                                    | Description                      |
+| ------------- | ----------------------------------------------------------------------- | -------------------------------- |
+| **`options`** | <code>{ x?: number; y?: number; width: number; height: number; }</code> | The new position and dimensions. |
 
 **Returns:** <code>Promise&lt;{ width: number; height: number; x: number; y: number; }&gt;</code>
 
 --------------------
 
 
+### setFocus(...)
+
+```typescript
+setFocus(options: { x: number; y: number; }) => Promise<void>
+```
+
+Sets the camera focus to a specific point in the preview.
+
+| Param         | Type                                   | Description          |
+| ------------- | -------------------------------------- | -------------------- |
+| **`options`** | <code>{ x: number; y: number; }</code> | - The focus options. |
+
+**Since:** 8.1.0
+
+--------------------
+
+
 ### Interfaces
 
 
@@ -689,13 +707,13 @@ Defines the configuration options for starting the camera preview.
 | **`position`**                     | <code>string</code>                           | The camera to use.                                                                                                                                                                                      | <code>"rear"</code> |       |
 | **`storeToFile`**                  | <code>boolean</code>                          | If true, saves the captured image to a file and returns the file path. If false, returns a base64 encoded string.                                                                                       | <code>false</code>  |       |
 | **`disableExifHeaderStripping`**   | <code>boolean</code>                          | If true, prevents the plugin from rotating the image based on EXIF data.                                                                                                                                | <code>false</code>  |       |
-| **`enableHighResolution`**         | <code>boolean</code>                          | If true, enables high-resolution image capture.                                                                                                                                                         | <code>false</code>  |       |
 | **`disableAudio`**                 | <code>boolean</code>                          | If true, disables the audio stream, preventing audio permission requests.                                                                                                                               | <code>true</code>   |       |
 | **`lockAndroidOrientation`**       | <code>boolean</code>                          | If true, locks the device orientation while the camera is active.                                                                                                                                       | <code>false</code>  |       |
 | **`enableOpacity`**                | <code>boolean</code>                          | If true, allows the camera preview's opacity to be changed.                                                                                                                                             | <code>false</code>  |       |
 | **`enableZoom`**                   | <code>boolean</code>                          | If true, enables pinch-to-zoom functionality on the preview.                                                                                                                                            | <code>false</code>  |       |
 | **`enableVideoMode`**              | <code>boolean</code>                          | If true, uses the video-optimized preset for the camera session.                                                                                                                                        | <code>false</code>  |       |
 | **`deviceId`**                     | <code>string</code>                           | The `deviceId` of the camera to use. If provided, `position` is ignored.                                                                                                                                |                     |       |
+| **`initialZoomLevel`**             | <code>number</code>                           | The initial zoom level when starting the camera preview. If the requested zoom level is not available, the native plugin will reject.                                                                   | <code>1.0</code>    | 2.2.0 |
 
 
 #### ExifData

package/android/src/main/java/com/ahm/capacitor/camera/preview/CameraPreview.java

@@ -10,6 +10,7 @@ import android.util.DisplayMetrics;
 import android.util.Log;
 import android.util.Size;
 import android.view.ViewGroup;
+import android.webkit.WebView;
 import com.ahm.capacitor.camera.preview.model.CameraDevice;
 import com.ahm.capacitor.camera.preview.model.CameraSessionConfiguration;
 import com.ahm.capacitor.camera.preview.model.LensInfo;
@@ -277,14 +278,44 @@ public class CameraPreview
       call.reject("level parameter is required");
       return;
     }
+    Boolean autoFocus = call.getBoolean("autoFocus", true);
     try {
-      cameraXView.setZoom(level);
+      cameraXView.setZoom(level, autoFocus);
       call.resolve();
     } catch (Exception e) {
       call.reject("Failed to set zoom: " + e.getMessage());
     }
   }
 
+  @PluginMethod
+  public void setFocus(PluginCall call) {
+    if (cameraXView == null || !cameraXView.isRunning()) {
+      call.reject("Camera is not running");
+      return;
+    }
+    Float x = call.getFloat("x");
+    Float y = call.getFloat("y");
+    if (x == null || y == null) {
+      call.reject("x and y parameters are required");
+      return;
+    }
+    // Reject if values are outside 0-1 range
+    if (x < 0f || x > 1f || y < 0f || y > 1f) {
+      call.reject("Focus coordinates must be between 0 and 1");
+      return;
+    }
+
+    getActivity()
+      .runOnUiThread(() -> {
+        try {
+          cameraXView.setFocus(x, y);
+          call.resolve();
+        } catch (Exception e) {
+          call.reject("Failed to set focus: " + e.getMessage());
+        }
+      });
+  }
+
   @PluginMethod
   public void setDeviceId(PluginCall call) {
     String deviceId = call.getString("deviceId");
@@ -412,8 +443,30 @@ public class CameraPreview
         "back".equals(positionParam))
       ? "back"
       : "front";
-    final int x = call.getInt("x", 0);
-    final int y = call.getInt("y", 0);
+    // Use -1 as default to indicate centering is needed when x/y not provided
+    final Integer xParam = call.getInt("x");
+    final Integer yParam = call.getInt("y");
+    final int x = xParam != null ? xParam : -1;
+    final int y = yParam != null ? yParam : -1;
+
+    Log.d("CameraPreview", "========================");
+    Log.d("CameraPreview", "CAMERA POSITION TRACKING START:");
+    Log.d(
+      "CameraPreview",
+      "1. RAW PARAMS - xParam: " + xParam + ", yParam: " + yParam
+    );
+    Log.d(
+      "CameraPreview",
+      "2. AFTER DEFAULT - x: " +
+      x +
+      " (center=" +
+      (x == -1) +
+      "), y: " +
+      y +
+      " (center=" +
+      (y == -1) +
+      ")"
+    );
     final int width = call.getInt("width", 0);
     final int height = call.getInt("height", 0);
     final int paddingBottom = call.getInt("paddingBottom", 0);
@@ -438,6 +491,7 @@ public class CameraPreview
     );
     final String aspectRatio = call.getString("aspectRatio", "4:3");
     final String gridMode = call.getString("gridMode", "none");
+    final float initialZoomLevel = call.getFloat("initialZoomLevel", 1.0f);
 
     // Check for conflict between aspectRatio and size
     if (
@@ -450,7 +504,7 @@ public class CameraPreview
       return;
     }
 
-    float targetZoom = 1.0f;
+    float targetZoom = initialZoomLevel;
     // Check if the selected device is a physical ultra-wide
     if (originalDeviceId != null) {
       List<CameraDevice> devices = CameraXView.getAvailableDevicesStatic(
@@ -521,10 +575,84 @@ public class CameraPreview
         // Calculate pixel ratio
         float pixelRatio = metrics.density;
 
-        // Try using just the pixel ratio without any webview offset for now
-        int computedX = (int) (x * pixelRatio);
-        int computedY = (int) (y * pixelRatio);
+        // Calculate position - center if x or y is -1
+        int computedX;
+        int computedY;
+
+        // Calculate dimensions first
+        int computedWidth = width != 0
+          ? (int) (width * pixelRatio)
+          : getBridge().getWebView().getWidth();
+        int computedHeight = height != 0
+          ? (int) (height * pixelRatio)
+          : getBridge().getWebView().getHeight();
+        computedHeight -= (int) (paddingBottom * pixelRatio);
 
+        Log.d("CameraPreview", "Positioning logic - x: " + x + ", y: " + y);
+
+        if (x == -1) {
+          // Center horizontally
+          int screenWidth = metrics.widthPixels;
+          computedX = (screenWidth - computedWidth) / 2;
+          Log.d(
+            "CameraPreview",
+            "Centering horizontally: screenWidth=" +
+            screenWidth +
+            ", computedWidth=" +
+            computedWidth +
+            ", computedX=" +
+            computedX
+          );
+        } else {
+          computedX = (int) (x * pixelRatio);
+          Log.d(
+            "CameraPreview",
+            "Using provided X position: " +
+            x +
+            " * " +
+            pixelRatio +
+            " = " +
+            computedX
+          );
+        }
+
+        if (y == -1) {
+          // Center vertically using full screen height
+          int screenHeight = metrics.heightPixels;
+          computedY = (screenHeight - computedHeight) / 2;
+          Log.d(
+            "CameraPreview",
+            "Centering vertically: screenHeight=" +
+            screenHeight +
+            ", computedHeight=" +
+            computedHeight +
+            ", computedY=" +
+            computedY
+          );
+        } else {
+          computedY = (int) (y * pixelRatio);
+          Log.d(
+            "CameraPreview",
+            "Using provided Y position: " +
+            y +
+            " * " +
+            pixelRatio +
+            " = " +
+            computedY
+          );
+        }
+
+        Log.d(
+          "CameraPreview",
+          "3. COMPUTED POSITION - x=" + computedX + ", y=" + computedY
+        );
+        Log.d(
+          "CameraPreview",
+          "4. COMPUTED SIZE - width=" +
+          computedWidth +
+          ", height=" +
+          computedHeight
+        );
         Log.d("CameraPreview", "=== COORDINATE DEBUG ===");
         Log.d(
           "CameraPreview",
@@ -579,14 +707,11 @@ public class CameraPreview
           computedY +
           ")"
         );
+        Log.d("CameraPreview", "5. IS_CENTERED - " + (x == -1 || y == -1));
         Log.d("CameraPreview", "========================");
-        int computedWidth = width != 0
-          ? (int) (width * pixelRatio)
-          : getBridge().getWebView().getWidth();
-        int computedHeight = height != 0
-          ? (int) (height * pixelRatio)
-          : getBridge().getWebView().getHeight();
-        computedHeight -= (int) (paddingBottom * pixelRatio);
+
+        // Pass along whether we're centering so CameraXView knows not to add insets
+        boolean isCentered = (x == -1 || y == -1);
 
         CameraSessionConfiguration config = new CameraSessionConfiguration(
           finalDeviceId,
@@ -607,6 +732,7 @@ public class CameraPreview
           gridMode
         );
         config.setTargetZoom(finalTargetZoom);
+        config.setCentered(isCentered);
 
         bridge.saveCall(call);
         cameraStartCallbackId = call.getCallbackId();
@@ -650,11 +776,70 @@ public class CameraPreview
         .getDisplayMetrics();
       float pixelRatio = metrics.density;
 
+      // Check if edge-to-edge mode is active by looking at WebView insets
+      // If the WebView has a top margin, it means edge-to-edge is active
+      // and JavaScript positions are relative to WebView content area
+      int webViewTopInset = 0;
+      boolean isEdgeToEdgeActive = false;
+      WebView webView = getBridge().getWebView();
+      if (
+        webView != null &&
+        webView.getLayoutParams() instanceof ViewGroup.MarginLayoutParams
+      ) {
+        webViewTopInset =
+          ((ViewGroup.MarginLayoutParams) webView.getLayoutParams()).topMargin;
+        isEdgeToEdgeActive = webViewTopInset > 0;
+      }
+
+      // Only convert to relative position if edge-to-edge is active
+      int relativeY = isEdgeToEdgeActive ? (y - webViewTopInset) : y;
+
+      Log.d("CameraPreview", "========================");
+      Log.d("CameraPreview", "CAMERA STARTED - POSITION RETURNED:");
+      Log.d(
+        "CameraPreview",
+        "7. RETURNED (pixels) - x=" +
+        x +
+        ", y=" +
+        y +
+        ", width=" +
+        width +
+        ", height=" +
+        height
+      );
+      Log.d(
+        "CameraPreview",
+        "8. EDGE-TO-EDGE - " + (isEdgeToEdgeActive ? "ACTIVE" : "INACTIVE")
+      );
+      Log.d("CameraPreview", "9. WEBVIEW INSET - " + webViewTopInset);
+      Log.d(
+        "CameraPreview",
+        "10. RELATIVE Y - " +
+        relativeY +
+        " (y=" +
+        y +
+        (isEdgeToEdgeActive ? " - inset=" + webViewTopInset : " unchanged") +
+        ")"
+      );
+      Log.d(
+        "CameraPreview",
+        "11. RETURNED (logical) - x=" +
+        (x / pixelRatio) +
+        ", y=" +
+        (relativeY / pixelRatio) +
+        ", width=" +
+        (width / pixelRatio) +
+        ", height=" +
+        (height / pixelRatio)
+      );
+      Log.d("CameraPreview", "12. PIXEL RATIO - " + pixelRatio);
+      Log.d("CameraPreview", "========================");
+
       JSObject result = new JSObject();
       result.put("width", width / pixelRatio);
       result.put("height", height / pixelRatio);
       result.put("x", x / pixelRatio);
-      result.put("y", y / pixelRatio);
+      result.put("y", relativeY / pixelRatio);
       call.resolve(result);
       bridge.releaseCall(call);
       cameraStartCallbackId = null; // Prevent re-use