net.doo.snap.dcscanner

Class DCScannerFrameHandler

java.lang.Object

net.doo.snap.dcscanner.DCScannerFrameHandler

All Implemented Interfaces:

PreviewBuffer.FrameHandler

public class DCScannerFrameHandler
extends java.lang.Object
implements PreviewBuffer.FrameHandler

Performs Disability Certificates data detection on camera preview frames. Outputs results via DCScannerFrameHandler.ResultHandler (addResultHandler(ResultHandler)).

Preview frame considered intercepted if at least one DCScannerFrameHandler.ResultHandler returns true from DCScannerFrameHandler.ResultHandler.handleResult(DisabilityCertificateRecognizerResultInfo)

See Also:

PreviewBuffer

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	DCScannerFrameHandler.ResultHandler Continuously notified about DC data detection results.

Constructor Summary

Constructors

Constructor and Description
DCScannerFrameHandler(android.content.Context context, DCScanner dcScanner)

Method Summary

Modifier and Type	Method and Description
void	addResultHandler(DCScannerFrameHandler.ResultHandler handler) Registers result handler which will be notified about DC data detection results.
static DCScannerFrameHandler	attach(ScanbotCameraView cameraView, DCScanner dcScanner) Convenience method for creating new DCScannerFrameHandler and adding it as PreviewBuffer.FrameHandler to given camera view.
boolean	handleFrame(byte[] frame, int width, int height, int frameOrientation, android.graphics.Rect finderRect) Invoked for every new camera preview frame
boolean	isEnabled()
void	removeResultHandler(DCScannerFrameHandler.ResultHandler handler) Unregisters handler.
void	setEnabled(boolean enabled)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DCScannerFrameHandler

public DCScannerFrameHandler(android.content.Context context,
                             DCScanner dcScanner)

Method Detail

attach

public static DCScannerFrameHandler attach(ScanbotCameraView cameraView,
                                           DCScanner dcScanner)

Convenience method for creating new DCScannerFrameHandler and adding it as PreviewBuffer.FrameHandler to given camera view.

Parameters:

cameraView - camera view to which new DC data detector will be attached

Returns:

new DCScannerFrameHandler

handleFrame

public boolean handleFrame(byte[] frame,
                           int width,
                           int height,
                           int frameOrientation,
                           android.graphics.Rect finderRect)

Description copied from interface: PreviewBuffer.FrameHandler

Invoked for every new camera preview frame

Specified by:

handleFrame in interface PreviewBuffer.FrameHandler

Parameters:

frame - image in NV21 format

width - width of the image

height - height of the image

frameOrientation - orientation of the image (in degrees)

finderRect - finder overlay area

Returns:

true if frame should be considered as "intercepted", i.e. no further processing should be performed on it. false to allow other frame handlers to process this frame.

addResultHandler

public void addResultHandler(DCScannerFrameHandler.ResultHandler handler)

Registers result handler which will be notified about DC data detection results.

Results are coming on the worker thread. Don't forget to move execution to main thread before updating UI.

Parameters:

handler - handler to register. Must not be null. If handler was already registered, nothing happens.

removeResultHandler

public void removeResultHandler(DCScannerFrameHandler.ResultHandler handler)

Unregisters handler.

Parameters:

handler - handler to unregister. If it was not registered before, nothing happens.

isEnabled

public boolean isEnabled()

Returns:

true if DC data detection is enabled. false if DC data detection is disabled, i.e. incoming frames are skipped.

setEnabled

public void setEnabled(boolean enabled)

Parameters:

enabled - true to enable DC data detection. false to disable DC data detection.