react-native-rectangle-doc-scanner 13.0.0 → 13.1.0

package/android/src/camera2/kotlin/com/reactnativerectangledocscanner/CameraController.kt

@@ -123,6 +123,7 @@ class CameraController(
         Log.d(TAG, "[CAMERAX] Setting target rotation to ROTATION_0 (portrait-only app)")
 
         preview = Preview.Builder()
+            .setTargetAspectRatio(AspectRatio.RATIO_4_3)
             .setTargetRotation(targetRotation)  // Force portrait
             .build()
             .also { previewUseCase ->
@@ -185,7 +186,8 @@ class CameraController(
         // ImageAnalysis UseCase for document detection
         imageAnalyzer = ImageAnalysis.Builder()
             .setBackpressureStrategy(ImageAnalysis.STRATEGY_KEEP_ONLY_LATEST)
-            .setTargetResolution(android.util.Size(1920, 1440))  // Higher resolution for better small-edge detection
+            // Match preview aspect ratio to avoid square analysis frames on some devices.
+            .setTargetAspectRatio(AspectRatio.RATIO_4_3)
             .setTargetRotation(targetRotation)  // Match preview rotation
             .build()
             .also {
@@ -201,6 +203,7 @@ class CameraController(
         // ImageCapture UseCase
         imageCapture = ImageCapture.Builder()
             .setCaptureMode(ImageCapture.CAPTURE_MODE_MAXIMIZE_QUALITY)
+            .setTargetAspectRatio(AspectRatio.RATIO_4_3)
             .setTargetRotation(targetRotation)  // Match preview rotation
             .build()
 
@@ -265,10 +268,11 @@ class CameraController(
             return
         }
 
-        val rotationDegrees = imageProxy.imageInfo.rotationDegrees
         val imageWidth = imageProxy.width
         val imageHeight = imageProxy.height
 
+        val rotationDegrees = imageProxy.imageInfo.rotationDegrees
+
         // Calculate rotation using the same logic as TextureView transform
         val sensorOrientation = getCameraSensorOrientation()
         val displayRotationDegrees = when (textureView.display?.rotation ?: Surface.ROTATION_0) {
@@ -281,16 +285,16 @@ class CameraController(
 
         // Use the same rotation logic as updateTextureViewTransform
         val tabletUpsideDownFix = if (sensorOrientation == 0 && displayRotationDegrees == 90) 180 else 0
-        val effectiveRotation = if (sensorOrientation == 0) {
-            (displayRotationDegrees + tabletUpsideDownFix) % 360
-        } else {
-            sensorOrientation
-        }
+        val effectiveRotation = (displayRotationDegrees + tabletUpsideDownFix) % 360
 
-        Log.d(TAG, "[ANALYZE] Sensor: $sensorOrientation°, Display: $displayRotationDegrees°, Effective: $effectiveRotation°")
+        Log.d(
+            TAG,
+            "[ANALYZE] Sensor: $sensorOrientation°, Display: $displayRotationDegrees°, " +
+                "ImageProxy: $rotationDegrees°, Effective: $effectiveRotation°"
+        )
 
-        // Try ML Kit first
-        val inputImage = InputImage.fromMediaImage(mediaImage, rotationDegrees)
+        // Try ML Kit first (use the same rotation as preview/OpenCV)
+        val inputImage = InputImage.fromMediaImage(mediaImage, effectiveRotation)
 
         objectDetector.process(inputImage)
             .addOnSuccessListener { objects ->

package/android/src/camera2/kotlin/com/reactnativerectangledocscanner/DocumentScannerView.kt

@@ -67,6 +67,7 @@ class DocumentScannerView(context: ThemedReactContext) : FrameLayout(context), L
 
     companion object {
         private const val TAG = "DocumentScannerView"
+        private const val PREVIEW_ASPECT_RATIO = 3f / 4f // width:height (matches 3:4)
     }
 
     override val lifecycle: Lifecycle
@@ -111,6 +112,9 @@ class DocumentScannerView(context: ThemedReactContext) : FrameLayout(context), L
         addView(overlayView, 1)  // Add at index 1 (front)
         Log.d(TAG, "[INIT] OverlayView added, childCount: $childCount")
 
+        // Match camera UI look with letterboxing when preview doesn't fill the view.
+        setBackgroundColor(android.graphics.Color.BLACK)
+
         Log.d(TAG, "╔════════════════════════════════════════╗")
         Log.d(TAG, "║  DocumentScannerView INIT COMPLETE     ║")
         Log.d(TAG, "╚════════════════════════════════════════╝")
@@ -137,11 +141,35 @@ class DocumentScannerView(context: ThemedReactContext) : FrameLayout(context), L
     override fun onLayout(changed: Boolean, left: Int, top: Int, right: Int, bottom: Int) {
         super.onLayout(changed, left, top, right, bottom)
         if (changed) {
+            layoutPreviewAndOverlay(right - left, bottom - top)
             Log.d(TAG, "[LAYOUT] View size: ${right - left}x${bottom - top}, PreviewView: ${previewView.width}x${previewView.height}")
             cameraController?.refreshTransform()
         }
     }
 
+    private fun layoutPreviewAndOverlay(viewWidth: Int, viewHeight: Int) {
+        if (viewWidth <= 0 || viewHeight <= 0) return
+
+        val targetWidth: Int
+        val targetHeight: Int
+        val aspectHeight = (viewWidth / PREVIEW_ASPECT_RATIO).toInt()
+        if (aspectHeight <= viewHeight) {
+            targetWidth = viewWidth
+            targetHeight = aspectHeight
+        } else {
+            targetWidth = (viewHeight * PREVIEW_ASPECT_RATIO).toInt()
+            targetHeight = viewHeight
+        }
+
+        val left = (viewWidth - targetWidth) / 2
+        val top = if (targetHeight < viewHeight) 0 else (viewHeight - targetHeight) / 2
+        val right = left + targetWidth
+        val bottom = top + targetHeight
+
+        previewView.layout(left, top, right, bottom)
+        overlayView.layout(left, top, right, bottom)
+    }
+
     private fun initializeCameraWhenReady() {
         // If view is already laid out, start camera immediately
         if (width > 0 && height > 0) {
@@ -213,17 +241,26 @@ class DocumentScannerView(context: ThemedReactContext) : FrameLayout(context), L
             lastDetectedImageHeight = imageHeight
         }
 
-        val rectangleOnScreen = if (rectangle != null && width > 0 && height > 0) {
+        val previewWidth = previewView.width
+        val previewHeight = previewView.height
+
+        val rectangleOnScreen = if (rectangle != null && previewWidth > 0 && previewHeight > 0) {
             cameraController?.mapRectangleToView(rectangle, imageWidth, imageHeight)
-                ?: DocumentDetector.transformRectangleToViewCoordinates(rectangle, imageWidth, imageHeight, width, height)
+                ?: DocumentDetector.transformRectangleToViewCoordinates(
+                    rectangle,
+                    imageWidth,
+                    imageHeight,
+                    previewWidth,
+                    previewHeight
+                )
         } else {
             null
         }
-        val smoothedRectangleOnScreen = smoothRectangle(rectangleOnScreen, width, height)
+        val smoothedRectangleOnScreen = smoothRectangle(rectangleOnScreen, previewWidth, previewHeight)
         lastRectangleOnScreen = smoothedRectangleOnScreen
         val quality = when {
-            smoothedRectangleOnScreen != null && width > 0 && height > 0 ->
-                DocumentDetector.evaluateRectangleQualityInView(smoothedRectangleOnScreen, width, height)
+            smoothedRectangleOnScreen != null && previewWidth > 0 && previewHeight > 0 ->
+                DocumentDetector.evaluateRectangleQualityInView(smoothedRectangleOnScreen, previewWidth, previewHeight)
             rectangle != null -> DocumentDetector.evaluateRectangleQuality(rectangle, imageWidth, imageHeight)
             else -> RectangleQuality.TOO_FAR
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-rectangle-doc-scanner",
-  "version": "13.0.0",
+  "version": "13.1.0",
   "description": "Native-backed document scanner for React Native with customizable overlays.",
   "license": "MIT",
   "main": "dist/index.js",