Scan a Machine Readable Zone (MRZ) from a (camera) image.
This is a fully functional sample app. Just load it with Android Studio, compile and install it on a device and follow the on-screen instructions.
First you need to create a MrzScanner object:
private final MrzScanner mrzScanner = new MrzScanner();
Then, you need to initialize it with you Activity:
Activity activity = getActivity();
if (!mrzScanner.init(activity)) {
throw new RuntimeException("Failed to initialize MrzScanner");
}
After this, you need to set a region of interest within the view coordinates of the camera preview view. This function will map the points of interest in the given camera image to the preview screen:
mrzScanner.setRegionOfInterest(
frameWidth, // native width of camera frame
frameHeight, // native height of camera frame
frameOrientation, // orientation in degrees of camera frame
previewRect, // rectangle of camera preview in view coordinates
roiRect); // region of interest in view coordinates
Finally, to scan a camera image in YUV format do:
final String mrz = mrzScanner.find(
frameData,
frameWidth,
frameHeight,
frameOrientation,
canvas); // null or a canvas over the camera preview to draw into