react-native-rectangle-doc-scanner 11.1.0 → 11.3.0

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

@@ -280,10 +280,11 @@ 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  // Tablet: use display rotation (90°)
+            (displayRotationDegrees + tabletUpsideDownFix) % 360
         } else {
-            sensorOrientation       // Phone: use sensor orientation (90°)
+            sensorOrientation
         }
 
         Log.d(TAG, "[ANALYZE] Sensor: $sensorOrientation°, Display: $displayRotationDegrees°, Effective: $effectiveRotation°")
@@ -387,18 +388,30 @@ class CameraController(
         mlBox: android.graphics.Rect?
     ): Rectangle? {
         return try {
-            if (mlBox != null) {
-                val frameWidth = if (rotation == 90 || rotation == 270) height else width
-                val frameHeight = if (rotation == 90 || rotation == 270) width else height
-                val padX = (mlBox.width() * 0.25f).toInt().coerceAtLeast(32)
-                val padY = (mlBox.height() * 0.25f).toInt().coerceAtLeast(32)
-                val roi = android.graphics.Rect(
-                    (mlBox.left - padX).coerceAtLeast(0),
-                    (mlBox.top - padY).coerceAtLeast(0),
-                    (mlBox.right + padX).coerceAtMost(frameWidth),
-                    (mlBox.bottom + padY).coerceAtMost(frameHeight)
-                )
-                DocumentDetector.detectRectangleInYUVWithRoi(nv21, width, height, rotation, roi)
+            val frameWidth = if (rotation == 90 || rotation == 270) height else width
+            val frameHeight = if (rotation == 90 || rotation == 270) width else height
+            val frameArea = frameWidth.toLong() * frameHeight.toLong()
+            val roiRect = mlBox?.let { box ->
+                val boxArea = box.width().toLong() * box.height().toLong()
+                val aspect = if (box.height() > 0) box.width().toDouble() / box.height().toDouble() else 0.0
+                val isValidSize = boxArea >= (frameArea * 0.08)
+                val isValidAspect = aspect in 0.4..2.5
+                if (!isValidSize || !isValidAspect) {
+                    null
+                } else {
+                    val padX = (box.width() * 0.25f).toInt().coerceAtLeast(32)
+                    val padY = (box.height() * 0.25f).toInt().coerceAtLeast(32)
+                    android.graphics.Rect(
+                        (box.left - padX).coerceAtLeast(0),
+                        (box.top - padY).coerceAtLeast(0),
+                        (box.right + padX).coerceAtMost(frameWidth),
+                        (box.bottom + padY).coerceAtMost(frameHeight)
+                    )
+                }
+            }
+
+            if (roiRect != null) {
+                DocumentDetector.detectRectangleInYUVWithRoi(nv21, width, height, rotation, roiRect)
                     ?: DocumentDetector.detectRectangleInYUV(nv21, width, height, rotation)
             } else {
                 DocumentDetector.detectRectangleInYUV(nv21, width, height, rotation)

package/android/src/common/kotlin/com/reactnativerectangledocscanner/DocumentDetector.kt

@@ -259,7 +259,7 @@ class DocumentDetector {
 
                     var largestRectangle: Rectangle? = null
                     var bestScore = 0.0
-                    val minArea = max(450.0, (srcMat.rows() * srcMat.cols()) * 0.0007)
+                    val minArea = max(350.0, (srcMat.rows() * srcMat.cols()) * 0.0005)
 
                     debugStats.contours = contours.size
 
@@ -289,7 +289,7 @@ class DocumentDetector {
                             val rect = Imgproc.minAreaRect(MatOfPoint2f(*points))
                             val rectArea = rect.size.area()
                             val rectangularity = if (rectArea > 1.0) contourArea / rectArea else 0.0
-                            if (rectangularity >= 0.6 && isCandidateValid(ordered, srcMat)) {
+                            if (rectangularity >= 0.5 && isCandidateValid(ordered, srcMat)) {
                                 debugStats.candidates += 1
                                 val score = contourArea * rectangularity
                                 if (score > bestScore) {
@@ -313,7 +313,7 @@ class DocumentDetector {
                             val rectArea = rotated.size.area()
                             if (rectArea > 1.0) {
                                 val rectangularity = contourArea / rectArea
-                                if (rectangularity >= 0.6) {
+                                if (rectangularity >= 0.5) {
                                     debugStats.candidates += 1
                                     val boxPoints = Array(4) { Point() }
                                     rotated.points(boxPoints)
@@ -497,16 +497,16 @@ class DocumentDetector {
             val rectHeight = max(leftEdgeLength, rightEdgeLength)
             val rectArea = rectWidth * rectHeight
 
-            // Check if rectangle is too small (less than 15% of view area)
-            // or too large (more than 85% - likely detecting screen instead of document)
+            // Check if rectangle is too small (less than 6% of view area)
+            // or too large (more than 95% - likely detecting screen instead of document)
             val areaRatio = rectArea / viewArea
-            if (areaRatio < 0.15) {
+            if (areaRatio < 0.06) {
                 if (BuildConfig.DEBUG) {
                     Log.d(TAG, "[QUALITY] TOO_FAR (small): area=${String.format("%.1f", rectArea)}, ratio=${String.format("%.2f", areaRatio)}")
                 }
                 return RectangleQuality.TOO_FAR
             }
-            if (areaRatio > 0.85) {
+            if (areaRatio > 0.95) {
                 if (BuildConfig.DEBUG) {
                     Log.d(TAG, "[QUALITY] TOO_FAR (large): area=${String.format("%.1f", rectArea)}, ratio=${String.format("%.2f", areaRatio)} - likely detecting screen")
                 }

package/dist/DocScanner.js

@@ -428,7 +428,7 @@ const VisionCameraScanner = (0, react_1.forwardRef)(({ onCapture, overlayColor =
     const overlayIsActive = autoCapture ? isAutoCapturing : (detectedRectangle?.stableCounter ?? 0) > 0;
     return (react_1.default.createElement(react_native_1.View, { style: styles.container, onLayout: handleLayout },
         CameraComponent && device && hasPermission ? (react_1.default.createElement(CameraComponent, { ref: cameraRef, style: styles.scanner, device: device, isActive: true, photo: true, torch: enableTorch ? 'on' : 'off', frameProcessor: frameProcessor, frameProcessorFps: 10 })) : (react_1.default.createElement(react_native_1.View, { style: styles.scanner })),
-        showGrid && overlayPolygon && (react_1.default.createElement(overlay_1.ScannerOverlay, { active: overlayIsActive, color: gridColor ?? overlayColor, lineWidth: gridLineWidth, polygon: overlayPolygon, clipRect: detectedRectangle?.previewViewport ?? null })),
+        showGrid && overlayPolygon && (react_1.default.createElement(overlay_1.ScannerOverlay, { active: overlayIsActive, color: gridColor ?? overlayColor, lineWidth: gridLineWidth, polygon: overlayPolygon, clipRect: react_native_1.Platform.OS === 'android' ? null : (detectedRectangle?.previewViewport ?? null) })),
         showManualCaptureButton && (react_1.default.createElement(react_native_1.TouchableOpacity, { style: styles.button, onPress: () => captureVision('manual') })),
         children));
 });
@@ -640,6 +640,7 @@ const NativeScanner = (0, react_1.forwardRef)(({ onCapture, overlayColor = DEFAU
         let rectangleOnScreen = normalizeRectangle(event.rectangleOnScreen ?? null);
         const density = react_native_1.PixelRatio.get();
         if (react_native_1.Platform.OS === 'android' &&
+            !rectangleOnScreen &&
             rectangleCoordinates &&
             event.imageSize &&
             event.previewSize &&
@@ -715,7 +716,7 @@ const NativeScanner = (0, react_1.forwardRef)(({ onCapture, overlayColor = DEFAU
     const detectionThreshold = autoCapture ? minStableFrames : 99999;
     return (react_1.default.createElement(react_native_1.View, { style: styles.container },
         react_1.default.createElement(react_native_document_scanner_1.default, { ref: scannerRef, style: styles.scanner, detectionCountBeforeCapture: detectionThreshold, overlayColor: overlayColor, enableTorch: enableTorch, quality: normalizedQuality, useBase64: useBase64, manualOnly: false, detectionConfig: detectionConfig, onPictureTaken: handlePictureTaken, onError: handleError, onRectangleDetect: handleRectangleDetect }),
-        showGrid && overlayPolygon && (react_1.default.createElement(overlay_1.ScannerOverlay, { active: overlayIsActive, color: gridColor ?? overlayColor, lineWidth: gridLineWidth, polygon: overlayPolygon, clipRect: detectedRectangle?.previewViewport ?? null })),
+        showGrid && overlayPolygon && (react_1.default.createElement(overlay_1.ScannerOverlay, { active: overlayIsActive, color: gridColor ?? overlayColor, lineWidth: gridLineWidth, polygon: overlayPolygon, clipRect: react_native_1.Platform.OS === 'android' ? null : (detectedRectangle?.previewViewport ?? null) })),
         showManualCaptureButton && (react_1.default.createElement(react_native_1.TouchableOpacity, { style: styles.button, onPress: handleManualCapture })),
         children));
 });

package/package.json

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

package/src/DocScanner.tsx

@@ -616,7 +616,7 @@ const VisionCameraScanner = forwardRef<DocScannerHandle, Props>(
             color={gridColor ?? overlayColor}
             lineWidth={gridLineWidth}
             polygon={overlayPolygon}
-            clipRect={detectedRectangle?.previewViewport ?? null}
+            clipRect={Platform.OS === 'android' ? null : (detectedRectangle?.previewViewport ?? null)}
           />
         )}
         {showManualCaptureButton && (
@@ -896,6 +896,7 @@ const NativeScanner = forwardRef<DocScannerHandle, Props>(
 
         if (
           Platform.OS === 'android' &&
+          !rectangleOnScreen &&
           rectangleCoordinates &&
           event.imageSize &&
           event.previewSize &&
@@ -1017,7 +1018,7 @@ const NativeScanner = forwardRef<DocScannerHandle, Props>(
             color={gridColor ?? overlayColor}
             lineWidth={gridLineWidth}
             polygon={overlayPolygon}
-            clipRect={detectedRectangle?.previewViewport ?? null}
+            clipRect={Platform.OS === 'android' ? null : (detectedRectangle?.previewViewport ?? null)}
           />
         )}
         {showManualCaptureButton && (