-
Notifications
You must be signed in to change notification settings - Fork 3.1k
Description
Describe the bug
On small Android tablets (specifically 8.7-inch screens), the Document Scanner UI forces a "Split-Pane" layout which is likely intended for larger tablets (10"+). In Portrait mode, the black control area occupies approximately 60% of the screen, leaving a very small and unusable viewfinder at the top. This makes it extremely difficult for users to scan documents effectively.
This layout also negatively impacts scan quality.
To verify that the entire document is within the tiny viewable area, users are forced to move the tablet physically further away from the paper. This results in lower resolution captures.
Conversely, if users hold the device at an optimal distance for better clarity, the document borders (especially the bottom edge) are completely obscured by the large control panel. Users cannot tell if the document is fully in frame or if the edges are cut off.
To Reproduce
- Launch GmsDocumentScanner (using GmsDocumentScannerOptions) on an 8.7-inch tablet.
- Hold the device in Portrait orientation.
- Observe the UI layout.
- The viewfinder is too small because the control panel takes up the majority of the screen space.
Expected behavior
On compact tablets (under 10 inches), the UI should utilize a full-screen viewfinder or an overlay layout (similar to the mobile phone UI) to maximize the camera preview area. The split-pane layout should only be triggered on larger screens where space permits.
SDK Info:
- com.google.android.gms:play-services-mlkit-document-scanner:16.0.0
Smartphone:
- Device: Samsung Galaxy Tab A9 (SM-X115) and Samsung Galaxy Tab A7 Lite (SM-T225)
- Device OS: Android 11 - Android 15
Development Environment:
- IDE Eversion: Android Studio Narwhal 3 Feature Drop | 2025.1.3
- Laptop/Desktop: Macbook Pro M3 2023
- Laptop/Desktop OS/version: Tahoe 26.0.1
Screenshots:
