Frequently Asked Questions

Why does the returned image appear almost square on some android devices instead of the full screen as seen in the preview?

The aspect ratio of the camera sensor can differ from that of the device's screen. This can cause the preview to fill the screen while the final captured image does not.

The Captur camera does not enforce any implementation, but in the reference implementation, you can see a difference between the scanning preview, and the decision image review.

While the live camera preview is designed to fill the entire screen for an optimal user experience, the actual images captured by the camera retain the sensor's native aspect ratio.

As a result, the captured image may appear almost square or not fill the full screen when displayed.

During scanning and in the final decision, Captur's on device models do use all of the camera pixels to scan the scene.

Recommendations for Implementation: Cropping During Scanning and Full Final Image Preview

1. Provide a Full-Screen Experience During Scanning
   1. Crop the Preview
      Implement cropping of the camera preview to match the screen's aspect ratio. This creates a seamless, full-screen experience during scanning.
      Benefit: Offers a better-looking UI with minimal image processing overhead.
      Trade-off: The final image may display slightly more content than was visible in the scanning preview, introducing minor UX differences.
2. Display the Entire, Undistorted Image for Review
   1. Maintain Original Aspect Ratio
      When presenting the final captured image, display it in its original aspect ratio to avoid distortion.
      1. Benefit: Ensures users see the complete, undistorted image, which is important for accuracy and any subsequent customer service interactions.
   2. Enhance UI Consistency
      1. Use background fills or complementary design elements around the image to maintain a cohesive UI without stretching or distorting the image.

By carefully managing how images are displayed during scanning and review, you can provide an optimal user experience that balances aesthetic design with functional accuracy.

This approach ensures that users have a full-screen scanning experience while still receiving the same complete and undistorted final image as the image recorded for proof of compliance.