react-native-rectangle-doc-scanner 10.48.0 → 10.50.0

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

@@ -471,8 +471,8 @@ class DocumentDetector {
         }
 
         /**
-         * Evaluate rectangle quality in view coordinates (closer to iOS behavior).
-         * Improved thresholds for better detection accuracy.
+         * Evaluate rectangle quality in view coordinates (iOS-like behavior).
+         * Focuses on rectangle size and angle quality.
          */
         fun evaluateRectangleQualityInView(
             rectangle: Rectangle,
@@ -484,6 +484,7 @@ class DocumentDetector {
             }
 
             val minDim = kotlin.math.min(viewWidth.toDouble(), viewHeight.toDouble())
+            val viewArea = viewWidth.toDouble() * viewHeight.toDouble()
 
             // Calculate actual edge lengths for better angle evaluation
             val topEdgeLength = distance(rectangle.topLeft, rectangle.topRight)
@@ -491,40 +492,59 @@ class DocumentDetector {
             val leftEdgeLength = distance(rectangle.topLeft, rectangle.bottomLeft)
             val rightEdgeLength = distance(rectangle.topRight, rectangle.bottomRight)
 
-            // Use more lenient threshold: 12% of minimum dimension (reduced from 18%)
-            // This allows for more realistic perspective angles
-            val angleThreshold = max(80.0, minDim * 0.12)
+            // Calculate rectangle area (approximate using bounding box)
+            val rectWidth = max(topEdgeLength, bottomEdgeLength)
+            val rectHeight = max(leftEdgeLength, rightEdgeLength)
+            val rectArea = rectWidth * rectHeight
 
-            val topYDiff = abs(rectangle.topRight.y - rectangle.topLeft.y)
-            val bottomYDiff = abs(rectangle.bottomLeft.y - rectangle.bottomRight.y)
-            val leftXDiff = abs(rectangle.topLeft.x - rectangle.bottomLeft.x)
-            val rightXDiff = abs(rectangle.topRight.x - rectangle.bottomRight.x)
+            // Check if rectangle is too small (less than 15% of view area)
+            val areaRatio = rectArea / viewArea
+            if (areaRatio < 0.15) {
+                if (BuildConfig.DEBUG) {
+                    Log.d(TAG, "[QUALITY] TOO_FAR: area=${String.format("%.1f", rectArea)}, ratio=${String.format("%.2f", areaRatio)}")
+                }
+                return RectangleQuality.TOO_FAR
+            }
+
+            // Check angle quality using angle ratio instead of absolute difference
+            // Edges should be roughly horizontal/vertical (not too skewed)
+            val topAngleRatio = if (topEdgeLength > 0) abs(rectangle.topRight.y - rectangle.topLeft.y) / topEdgeLength else 0.0
+            val bottomAngleRatio = if (bottomEdgeLength > 0) abs(rectangle.bottomLeft.y - rectangle.bottomRight.y) / bottomEdgeLength else 0.0
+            val leftAngleRatio = if (leftEdgeLength > 0) abs(rectangle.topLeft.x - rectangle.bottomLeft.x) / leftEdgeLength else 0.0
+            val rightAngleRatio = if (rightEdgeLength > 0) abs(rectangle.topRight.x - rectangle.bottomRight.x) / rightEdgeLength else 0.0
+
+            // Allow up to 30% skew (sin(~17°) ≈ 0.3)
+            val maxSkewRatio = 0.3
 
-            // Check if edges are too skewed (perspective too extreme)
-            if (topYDiff > angleThreshold || bottomYDiff > angleThreshold ||
-                leftXDiff > angleThreshold || rightXDiff > angleThreshold) {
+            if (topAngleRatio > maxSkewRatio ||
+                bottomAngleRatio > maxSkewRatio ||
+                leftAngleRatio > maxSkewRatio ||
+                rightAngleRatio > maxSkewRatio) {
+                if (BuildConfig.DEBUG) {
+                    Log.d(TAG, "[QUALITY] BAD_ANGLE (skew): top=${String.format("%.2f", topAngleRatio)}, " +
+                        "bottom=${String.format("%.2f", bottomAngleRatio)}, " +
+                        "left=${String.format("%.2f", leftAngleRatio)}, " +
+                        "right=${String.format("%.2f", rightAngleRatio)} > $maxSkewRatio")
+                }
                 return RectangleQuality.BAD_ANGLE
             }
 
-            // Additional check: opposite edges should be somewhat similar in length
-            // Allow up to 60% difference (more lenient for perspective)
+            // Check opposite edge ratio (perspective check)
+            // More lenient: allow 3x difference
             val topBottomRatio = if (bottomEdgeLength > 0) topEdgeLength / bottomEdgeLength else 0.0
             val leftRightRatio = if (rightEdgeLength > 0) leftEdgeLength / rightEdgeLength else 0.0
-            if (topBottomRatio < 0.4 || topBottomRatio > 2.5 ||
-                leftRightRatio < 0.4 || leftRightRatio > 2.5) {
+            if (topBottomRatio < 0.33 || topBottomRatio > 3.0 ||
+                leftRightRatio < 0.33 || leftRightRatio > 3.0) {
+                if (BuildConfig.DEBUG) {
+                    Log.d(TAG, "[QUALITY] BAD_ANGLE (ratio): topBottom=${String.format("%.2f", topBottomRatio)}, " +
+                        "leftRight=${String.format("%.2f", leftRightRatio)}")
+                }
                 return RectangleQuality.BAD_ANGLE
             }
 
-            // More lenient margin check: 8% of minimum dimension (increased from 5%)
-            val margin = max(80.0, minDim * 0.08)
-            if (rectangle.topLeft.y > margin ||
-                rectangle.topRight.y > margin ||
-                rectangle.bottomLeft.y < (viewHeight - margin) ||
-                rectangle.bottomRight.y < (viewHeight - margin)
-            ) {
-                return RectangleQuality.TOO_FAR
+            if (BuildConfig.DEBUG) {
+                Log.d(TAG, "[QUALITY] GOOD: area=${String.format("%.1f", rectArea)}, ratio=${String.format("%.2f", areaRatio)}")
             }
-
             return RectangleQuality.GOOD
         }
 

package/package.json

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