@capgo/camera-preview 7.4.0-beta.3 → 7.4.0-beta.5

package/README.md

@@ -220,6 +220,8 @@ Documentation for the [uploader](https://github.com/Cap-go/capacitor-uploader)
 * [`capture(...)`](#capture)
 * [`captureSample(...)`](#capturesample)
 * [`getSupportedFlashModes()`](#getsupportedflashmodes)
+* [`setAspectRatio(...)`](#setaspectratio)
+* [`getAspectRatio()`](#getaspectratio)
 * [`getHorizontalFov()`](#gethorizontalfov)
 * [`getSupportedPictureSizes()`](#getsupportedpicturesizes)
 * [`setFlashMode(...)`](#setflashmode)
@@ -249,7 +251,7 @@ The main interface for the CameraPreview plugin.
 ### start(...)
 
 ```typescript
-start(options: CameraPreviewOptions) => Promise<void>
+start(options: CameraPreviewOptions) => Promise<{ width: number; height: number; x: number; y: number; }>
 ```
 
 Starts the camera preview.
@@ -258,6 +260,8 @@ Starts the camera preview.
 | ------------- | --------------------------------------------------------------------- | ------------------------------------------- |
 | **`options`** | <code><a href="#camerapreviewoptions">CameraPreviewOptions</a></code> | - The configuration for the camera preview. |
 
+**Returns:** <code>Promise&lt;{ width: number; height: number; x: number; y: number; }&gt;</code>
+
 **Since:** 0.0.1
 
 --------------------
@@ -329,6 +333,38 @@ Gets the flash modes supported by the active camera.
 --------------------
 
 
+### setAspectRatio(...)
+
+```typescript
+setAspectRatio(options: { aspectRatio: '4:3' | '16:9' | 'fill'; }) => Promise<void>
+```
+
+Set the aspect ratio of the camera preview.
+
+| Param         | Type                                                     | Description                 |
+| ------------- | -------------------------------------------------------- | --------------------------- |
+| **`options`** | <code>{ aspectRatio: '4:3' \| '16:9' \| 'fill'; }</code> | - The desired aspect ratio. |
+
+**Since:** 7.4.0
+
+--------------------
+
+
+### getAspectRatio()
+
+```typescript
+getAspectRatio() => Promise<{ aspectRatio: '4:3' | '16:9' | 'fill'; }>
+```
+
+Gets the current aspect ratio of the camera preview.
+
+**Returns:** <code>Promise&lt;{ aspectRatio: '4:3' | '16:9' | 'fill'; }&gt;</code>
+
+**Since:** 7.4.0
+
+--------------------
+
+
 ### getHorizontalFov()
 
 ```typescript
@@ -568,28 +604,30 @@ Gets the ID of the currently active camera device.
 
 Defines the configuration options for starting the camera preview.
 
-| Prop                               | Type                 | Description                                                                                                       | Default             |
-| ---------------------------------- | -------------------- | ----------------------------------------------------------------------------------------------------------------- | ------------------- |
-| **`parent`**                       | <code>string</code>  | The parent element to attach the video preview to.                                                                |                     |
-| **`className`**                    | <code>string</code>  | A CSS class name to add to the preview element.                                                                   |                     |
-| **`width`**                        | <code>number</code>  | The width of the preview in pixels. Defaults to the screen width.                                                 |                     |
-| **`height`**                       | <code>number</code>  | The height of the preview in pixels. Defaults to the screen height.                                               |                     |
-| **`x`**                            | <code>number</code>  | The horizontal origin of the preview, in pixels.                                                                  |                     |
-| **`y`**                            | <code>number</code>  | The vertical origin of the preview, in pixels.                                                                    |                     |
-| **`includeSafeAreaInsets`**        | <code>boolean</code> | Adjusts the y-position to account for safe areas (e.g., notches).                                                 | <code>false</code>  |
-| **`toBack`**                       | <code>boolean</code> | If true, places the preview behind the webview.                                                                   | <code>true</code>   |
-| **`paddingBottom`**                | <code>number</code>  | Bottom padding for the preview, in pixels.                                                                        |                     |
-| **`rotateWhenOrientationChanged`** | <code>boolean</code> | Whether to rotate the preview when the device orientation changes.                                                | <code>true</code>   |
-| **`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.                                          |                     |
+| Prop                               | Type                                          | Description                                                                                                        | Default             | Since |
+| ---------------------------------- | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | ------------------- | ----- |
+| **`parent`**                       | <code>string</code>                           | The parent element to attach the video preview to.                                                                 |                     |       |
+| **`className`**                    | <code>string</code>                           | A CSS class name to add to the preview element.                                                                    |                     |       |
+| **`width`**                        | <code>number</code>                           | The width of the preview in pixels. Defaults to the screen width.                                                  |                     |       |
+| **`height`**                       | <code>number</code>                           | The height of the preview in pixels. Defaults to the screen height.                                                |                     |       |
+| **`x`**                            | <code>number</code>                           | The horizontal origin of the preview, in pixels.                                                                   |                     |       |
+| **`y`**                            | <code>number</code>                           | The vertical origin of the preview, in pixels.                                                                     |                     |       |
+| **`aspectRatio`**                  | <code>'4:3' \| '16:9' \| 'fill'</code>        | The aspect ratio of the camera preview, '4:3' or '16:9'. If not set, the camera will use the default aspect ratio. |                     | 2.0.0 |
+| **`gridMode`**                     | <code><a href="#gridmode">GridMode</a></code> | The grid overlay to display on the camera preview.                                                                 | <code>"none"</code> | 2.1.0 |
+| **`includeSafeAreaInsets`**        | <code>boolean</code>                          | Adjusts the y-position to account for safe areas (e.g., notches).                                                  | <code>false</code>  |       |
+| **`toBack`**                       | <code>boolean</code>                          | If true, places the preview behind the webview.                                                                    | <code>true</code>   |       |
+| **`paddingBottom`**                | <code>number</code>                           | Bottom padding for the preview, in pixels.                                                                         |                     |       |
+| **`rotateWhenOrientationChanged`** | <code>boolean</code>                          | Whether to rotate the preview when the device orientation changes.                                                 | <code>true</code>   |       |
+| **`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.                                           |                     |       |
 
 
 #### ExifData
@@ -693,6 +731,11 @@ Represents the detailed information of the currently active lens.
 ### Type Aliases
 
 
+#### GridMode
+
+<code>"none" | "3x3" | "4x4"</code>
+
+
 #### CameraPosition
 
 <code>"rear" | "front"</code>

package/android/src/main/AndroidManifest.xml

@@ -1,7 +1,7 @@
 
   <manifest xmlns:android="http://schemas.android.com/apk/res/android">
     <uses-permission android:name="android.permission.CAMERA" />
+    <uses-permission android:name="android.permission.RECORD_AUDIO" />
     <uses-feature android:name="android.hardware.camera" />
     <uses-feature android:name="android.hardware.camera.autofocus" />
   </manifest>
-  

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

@@ -30,6 +30,14 @@ import org.json.JSONObject;
 import android.location.Location;
 import com.getcapacitor.Logger;
 
+interface CameraPreviewListener {
+  void onPictureTaken(String base64, JSONObject exif);
+  void onPictureTakenError(String message);
+  void onCameraStarted(int width, int height, int x, int y);
+  void onCameraStopped();
+  void onCaptureStarted();
+}
+
 @CapacitorPlugin(
   name = "CameraPreview",
   permissions = {
@@ -49,7 +57,7 @@ import com.getcapacitor.Logger;
 )
 public class CameraPreview
   extends Plugin
-  implements CameraXView.CameraXViewListener {
+  implements CameraPreviewListener {
 
   static final String CAMERA_WITH_AUDIO_PERMISSION_ALIAS = "cameraWithAudio";
   static final String CAMERA_ONLY_PERMISSION_ALIAS = "cameraOnly";
@@ -146,7 +154,7 @@ public class CameraPreview
     final boolean saveToGallery = call.getBoolean("saveToGallery", false);
     Integer width = call.getInt("width");
     Integer height = call.getInt("height");
-    
+
     cameraXView.capturePhoto(quality, saveToGallery, width, height, location);
   }
 
@@ -291,7 +299,7 @@ public class CameraPreview
     }
     rear.put("supportedPictureSizes", rearSizesJs);
     supportedPictureSizesResult.put(rear);
-    
+
     List<Size> frontSizes = CameraXView.getSupportedPictureSizes("front");
     JSObject front = new JSObject();
     front.put("facing", "front");
@@ -304,7 +312,7 @@ public class CameraPreview
     }
     front.put("supportedPictureSizes", frontSizesJs);
     supportedPictureSizesResult.put(front);
-    
+
     JSObject ret = new JSObject();
     ret.put("supportedPictureSizes", supportedPictureSizesResult);
     call.resolve(ret);
@@ -389,7 +397,9 @@ public class CameraPreview
     final boolean disableExifHeaderStripping = Boolean.TRUE.equals(call.getBoolean("disableExifHeaderStripping", false));
     final boolean lockOrientation = Boolean.TRUE.equals(call.getBoolean("lockAndroidOrientation", false));
     final boolean disableAudio = Boolean.TRUE.equals(call.getBoolean("disableAudio", true));
-    
+    final String aspectRatio = call.getString("aspectRatio", "fill");
+    final String gridMode = call.getString("gridMode", "none");
+
     float targetZoom = 1.0f;
     // Check if the selected device is a physical ultra-wide
     if (originalDeviceId != null) {
@@ -401,7 +411,7 @@ public class CameraPreview
                         Log.d("CameraPreview", "Ultra-wide lens selected. Targeting 0.5x zoom on logical camera.");
                         targetZoom = 0.5f;
                         // Force the use of the logical camera by clearing the specific deviceId
-                        deviceId = null; 
+                        deviceId = null;
                         break;
                     }
                 }
@@ -412,7 +422,7 @@ public class CameraPreview
 
     previousOrientationRequest = getBridge().getActivity().getRequestedOrientation();
     cameraXView = new CameraXView(getContext(), getBridge().getWebView());
-    cameraXView.setListener(this);
+    cameraXView.setListener((CameraXView.CameraXViewListener) this);
 
     String finalDeviceId = deviceId;
     float finalTargetZoom = targetZoom;
@@ -427,9 +437,9 @@ public class CameraPreview
         int computedHeight = height != 0 ? (int) TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_DIP, height, metrics) : getBridge().getWebView().getHeight();
         computedHeight -= (int) TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_DIP, paddingBottom, metrics);
 
-        CameraSessionConfiguration config = new CameraSessionConfiguration(finalDeviceId, position, computedX, computedY, computedWidth, computedHeight, paddingBottom, toBack, storeToFile, enableOpacity, enableZoom, disableExifHeaderStripping, disableAudio, 1.0f);
+        CameraSessionConfiguration config = new CameraSessionConfiguration(finalDeviceId, position, computedX, computedY, computedWidth, computedHeight, paddingBottom, toBack, storeToFile, enableOpacity, enableZoom, disableExifHeaderStripping, disableAudio, 1.0f, aspectRatio, gridMode);
         config.setTargetZoom(finalTargetZoom);
-        
+
         bridge.saveCall(call);
         cameraStartCallbackId = call.getCallbackId();
         cameraXView.startSession(config);
@@ -463,33 +473,50 @@ public class CameraPreview
   }
 
   @Override
-  public void onSampleTaken(String result) {
-    JSObject jsObject = new JSObject();
-    jsObject.put("value", result);
-    bridge.getSavedCall(snapshotCallbackId).resolve(jsObject);
+  public void onCaptureStarted() {
+    Log.i("CameraPreview", "Capture started");
   }
 
   @Override
-  public void onSampleTakenError(String message) {
-    bridge.getSavedCall(snapshotCallbackId).reject(message);
+  public void onCameraStarted(int width, int height, int x, int y) {
+    PluginCall call = bridge.getSavedCall(cameraStartCallbackId);
+    if (call != null) {
+        JSObject result = new JSObject();
+        result.put("width", width);
+        result.put("height", height);
+        result.put("x", x);
+        result.put("y", y);
+        call.resolve(result);
+        bridge.releaseCall(call);
+        cameraStartCallbackId = null; // Prevent re-use
+    }
   }
 
   @Override
-  public void onCameraStarted() {
-    PluginCall pluginCall = bridge.getSavedCall(cameraStartCallbackId);
-    if (pluginCall != null) {
-      pluginCall.resolve();
-      bridge.releaseCall(pluginCall);
-    }
+  public void onCameraStopped() {
+    // This method is no longer needed as onCameraStarted handles the promise resolution.
   }
 
-  @Override
-  public void onCameraStartError(String message) {
-    PluginCall pluginCall = bridge.getSavedCall(cameraStartCallbackId);
-    if (pluginCall != null) {
-      pluginCall.reject(message);
-      bridge.releaseCall(pluginCall);
+  @PluginMethod
+  public void setAspectRatio(PluginCall call) {
+    if (cameraXView == null || !cameraXView.isRunning()) {
+      call.reject("Camera is not running");
+      return;
     }
+    String aspectRatio = call.getString("aspectRatio", "fill");
+    cameraXView.setAspectRatio(aspectRatio);
+    call.resolve();
   }
 
+  @PluginMethod
+  public void getAspectRatio(PluginCall call) {
+    if (cameraXView == null || !cameraXView.isRunning()) {
+      call.reject("Camera is not running");
+      return;
+    }
+    String aspectRatio = cameraXView.getAspectRatio();
+    JSObject ret = new JSObject();
+    ret.put("aspectRatio", aspectRatio);
+    call.resolve(ret);
+  }
 }

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

@@ -18,6 +18,8 @@ import androidx.camera.core.ImageCapture;
 import androidx.camera.core.ImageCaptureException;
 import androidx.camera.core.ImageProxy;
 import androidx.camera.core.Preview;
+import androidx.camera.core.AspectRatio;
+import androidx.camera.core.resolutionselector.AspectRatioStrategy;
 import androidx.camera.core.resolutionselector.ResolutionSelector;
 import androidx.camera.core.resolutionselector.ResolutionStrategy;
 import androidx.camera.lifecycle.ProcessCameraProvider;
@@ -27,6 +29,7 @@ import androidx.lifecycle.Lifecycle;
 import androidx.lifecycle.LifecycleOwner;
 import androidx.lifecycle.LifecycleRegistry;
 import com.ahm.capacitor.camera.preview.model.CameraSessionConfiguration;
+import android.widget.FrameLayout;
 import com.ahm.capacitor.camera.preview.model.LensInfo;
 import com.ahm.capacitor.camera.preview.model.ZoomFactors;
 import com.google.common.util.concurrent.ListenableFuture;
@@ -61,8 +64,12 @@ import android.graphics.Bitmap;
 import android.graphics.Matrix;
 import java.io.ByteArrayOutputStream;
 import android.location.Location;
+import android.widget.FrameLayout;
+import androidx.lifecycle.LifecycleObserver;
+import androidx.lifecycle.OnLifecycleEvent;
+import android.util.Rational;
 
-public class CameraXView implements LifecycleOwner {
+public class CameraXView implements LifecycleOwner, LifecycleObserver {
     private static final String TAG = "CameraPreview CameraXView";
 
     public interface CameraXViewListener {
@@ -79,6 +86,8 @@ public class CameraXView implements LifecycleOwner {
     private ImageCapture imageCapture;
     private ImageCapture sampleImageCapture;
     private PreviewView previewView;
+    private GridOverlayView gridOverlayView;
+    private FrameLayout previewContainer;
     private CameraSelector currentCameraSelector;
     private String currentDeviceId;
     private int currentFlashMode = ImageCapture.FLASH_MODE_OFF;
@@ -179,23 +188,47 @@ public class CameraXView implements LifecycleOwner {
         if (sessionConfig.isToBack()) {
             webView.setBackgroundColor(android.graphics.Color.TRANSPARENT);
         }
+
+        // Create a container to hold both the preview and grid overlay
+        previewContainer = new FrameLayout(context);
+
+        // Create and setup the preview view
         previewView = new PreviewView(context);
         previewView.setScaleType(PreviewView.ScaleType.FILL_CENTER);
+        previewContainer.addView(previewView, new FrameLayout.LayoutParams(
+            FrameLayout.LayoutParams.MATCH_PARENT,
+            FrameLayout.LayoutParams.MATCH_PARENT
+        ));
+
+        // Create and setup the grid overlay
+        gridOverlayView = new GridOverlayView(context);
+        gridOverlayView.setGridMode(sessionConfig.getGridMode());
+        previewContainer.addView(gridOverlayView, new FrameLayout.LayoutParams(
+            FrameLayout.LayoutParams.MATCH_PARENT,
+            FrameLayout.LayoutParams.MATCH_PARENT
+        ));
+
         ViewGroup parent = (ViewGroup) webView.getParent();
         if (parent != null) {
-            parent.addView(previewView, new ViewGroup.LayoutParams(sessionConfig.getWidth(), sessionConfig.getHeight()));
+            parent.addView(previewContainer, new ViewGroup.LayoutParams(sessionConfig.getWidth(), sessionConfig.getHeight()));
             if(sessionConfig.isToBack()) webView.bringToFront();
         }
     }
 
     private void removePreviewView() {
-        if (previewView != null) {
-            ViewGroup parent = (ViewGroup) previewView.getParent();
+        if (previewContainer != null) {
+            ViewGroup parent = (ViewGroup) previewContainer.getParent();
             if (parent != null) {
-                parent.removeView(previewView);
+                parent.removeView(previewContainer);
             }
+            previewContainer = null;
+        }
+        if (previewView != null) {
             previewView = null;
         }
+        if (gridOverlayView != null) {
+            gridOverlayView = null;
+        }
         webView.setBackgroundColor(android.graphics.Color.WHITE);
     }
 
@@ -206,9 +239,22 @@ public class CameraXView implements LifecycleOwner {
             try {
                 Log.d(TAG, "Building camera selector with deviceId: " + sessionConfig.getDeviceId() + " and position: " + sessionConfig.getPosition());
                 currentCameraSelector = buildCameraSelector();
-                ResolutionSelector resolutionSelector = new ResolutionSelector.Builder()
-                        .setResolutionStrategy(ResolutionStrategy.HIGHEST_AVAILABLE_STRATEGY)
-                        .build();
+
+                ResolutionSelector.Builder resolutionSelectorBuilder = new ResolutionSelector.Builder()
+                        .setResolutionStrategy(ResolutionStrategy.HIGHEST_AVAILABLE_STRATEGY);
+
+                if (sessionConfig.getAspectRatio() != null) {
+                    int aspectRatio;
+                    if ("16:9".equals(sessionConfig.getAspectRatio())) {
+                        aspectRatio = AspectRatio.RATIO_16_9;
+                    } else { // "4:3"
+                        aspectRatio = AspectRatio.RATIO_4_3;
+                    }
+                    resolutionSelectorBuilder.setAspectRatioStrategy(new AspectRatioStrategy(aspectRatio, AspectRatioStrategy.FALLBACK_RULE_AUTO));
+                }
+
+                ResolutionSelector resolutionSelector = resolutionSelectorBuilder.build();
+
                 Preview preview = new Preview.Builder().setResolutionSelector(resolutionSelector).build();
                 imageCapture = new ImageCapture.Builder().setResolutionSelector(resolutionSelector).setCaptureMode(ImageCapture.CAPTURE_MODE_MINIMIZE_LATENCY).setFlashMode(currentFlashMode).build();
                 sampleImageCapture = imageCapture;
@@ -347,13 +393,18 @@ public class CameraXView implements LifecycleOwner {
                 @Override
                 public void onImageSaved(@NonNull ImageCapture.OutputFileResults output) {
                     try {
-                        byte[] bytes = Files.readAllBytes(tempFile.toPath());
-                        ExifInterface exifInterface = new ExifInterface(tempFile.getAbsolutePath());
+                        // Read file using FileInputStream for compatibility
+                        byte[] bytes = new byte[(int) tempFile.length()];
+                        java.io.FileInputStream fis = new java.io.FileInputStream(tempFile);
+                        fis.read(bytes);
+                        fis.close();
                         
+                        ExifInterface exifInterface = new ExifInterface(tempFile.getAbsolutePath());
+
                         if (location != null) {
                             exifInterface.setGpsInfo(location);
                         }
-                        
+
                         JSONObject exifData = getExifData(exifInterface);
 
                         if (width != null && height != null) {
@@ -363,13 +414,13 @@ public class CameraXView implements LifecycleOwner {
                             resizedBitmap.compress(Bitmap.CompressFormat.JPEG, quality, stream);
                             bytes = stream.toByteArray();
                         }
-                        
+
                         if (saveToGallery) {
                             saveImageToGallery(bytes);
                         }
 
                         String base64 = Base64.encodeToString(bytes, Base64.NO_WRAP);
-                        
+
                         tempFile.delete();
 
                         if (listener != null) {
@@ -389,7 +440,7 @@ public class CameraXView implements LifecycleOwner {
     private Bitmap resizeBitmap(Bitmap bitmap, int width, int height) {
         return Bitmap.createScaledBitmap(bitmap, width, height, true);
     }
-    
+
     private JSONObject getExifData(ExifInterface exifInterface) {
         JSONObject exifData = new JSONObject();
         try {
@@ -615,7 +666,7 @@ public class CameraXView implements LifecycleOwner {
             for (CameraInfo cameraInfo : cameraProvider.getAvailableCameraInfos()) {
                 String logicalCameraId = Camera2CameraInfo.from(cameraInfo).getCameraId();
                 String position = isBackCamera(cameraInfo) ? "rear" : "front";
-                
+
                 // Add logical camera
                 float minZoom = Objects.requireNonNull(cameraInfo.getZoomState().getValue()).getMinZoomRatio();
                 float maxZoom = cameraInfo.getZoomState().getValue().getMaxZoomRatio();
@@ -651,7 +702,7 @@ public class CameraXView implements LifecycleOwner {
                                 if (focalLengths[0] < 3.0f) deviceType = "ultraWide";
                                 else if (focalLengths[0] > 5.0f) deviceType = "telephoto";
                             }
-                            
+
                             float physicalMinZoom = 1.0f;
                             float physicalMaxZoom = 1.0f;
                             if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.R) {
@@ -661,11 +712,11 @@ public class CameraXView implements LifecycleOwner {
                                     physicalMaxZoom = zoomRange.getUpper();
                                 }
                             }
-                            
+
                             String label = "Physical " + deviceType + " (" + position + ")";
                             List<LensInfo> physicalLenses = new ArrayList<>();
                             physicalLenses.add(new LensInfo(focalLengths != null ? focalLengths[0] : 4.25f, deviceType, 1.0f, physicalMaxZoom));
-                            
+
                             devices.add(new com.ahm.capacitor.camera.preview.model.CameraDevice(
                                 physicalId, label, position, physicalLenses, physicalMinZoom, physicalMaxZoom, false
                             ));
@@ -969,7 +1020,9 @@ public class CameraXView implements LifecycleOwner {
             sessionConfig.isEnableZoom(), // enableZoom
             sessionConfig.isDisableExifHeaderStripping(), // disableExifHeaderStripping
             sessionConfig.isDisableAudio(), // disableAudio
-            sessionConfig.getZoomFactor() // zoomFactor
+            sessionConfig.getZoomFactor(), // zoomFactor
+            sessionConfig.getAspectRatio(), // aspectRatio
+            sessionConfig.getGridMode() // gridMode
         );
 
         // Clear current device ID to force position-based selection
@@ -987,4 +1040,64 @@ public class CameraXView implements LifecycleOwner {
             previewView.setAlpha(opacity);
         }
     }
+
+    private void updateLayoutParams() {
+        if (sessionConfig == null) return;
+
+        FrameLayout.LayoutParams layoutParams = new FrameLayout.LayoutParams(
+                sessionConfig.getWidth(),
+                sessionConfig.getHeight()
+        );
+        layoutParams.leftMargin = sessionConfig.getX();
+        layoutParams.topMargin = sessionConfig.getY();
+
+        if (sessionConfig.getAspectRatio() != null && !sessionConfig.getAspectRatio().equals("fill")) {
+            String[] ratios = sessionConfig.getAspectRatio().split(":");
+            float ratio = Float.parseFloat(ratios[0]) / Float.parseFloat(ratios[1]);
+            if (sessionConfig.getWidth() > 0) {
+                layoutParams.height = (int) (sessionConfig.getWidth() / ratio);
+            } else if (sessionConfig.getHeight() > 0) {
+                layoutParams.width = (int) (sessionConfig.getHeight() * ratio);
+            }
+        } else {
+            previewView.setScaleType(PreviewView.ScaleType.FILL_CENTER);
+        }
+
+        previewView.setLayoutParams(layoutParams);
+
+        if (listener != null) {
+            listener.onCameraStarted();
+        }
+    }
+
+    public String getAspectRatio() {
+        if (sessionConfig != null) {
+            return sessionConfig.getAspectRatio();
+        }
+        return "fill";
+    }
+
+    public void setAspectRatio(String aspectRatio) {
+        if (sessionConfig != null) {
+            sessionConfig = new CameraSessionConfiguration(
+                    sessionConfig.getDeviceId(),
+                    sessionConfig.getPosition(),
+                    sessionConfig.getX(),
+                    sessionConfig.getY(),
+                    sessionConfig.getWidth(),
+                    sessionConfig.getHeight(),
+                    sessionConfig.getPaddingBottom(),
+                    sessionConfig.getToBack(),
+                    sessionConfig.getStoreToFile(),
+                    sessionConfig.getEnableOpacity(),
+                    sessionConfig.getEnableZoom(),
+                    sessionConfig.getDisableExifHeaderStripping(),
+                    sessionConfig.getDisableAudio(),
+                    sessionConfig.getZoomFactor(),
+                    aspectRatio,
+                    sessionConfig.getGridMode()
+            );
+            updateLayoutParams();
+        }
+    }
 }