net.doo.snap.camera

Class AutoSnappingController

java.lang.Object

net.doo.snap.camera.AutoSnappingController

public class AutoSnappingController
extends java.lang.Object

Controls auto-snapping process by observing contour detection results from ContourDetectorFrameHandler.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	AutoSnappingController.AutoSnappingCallback Called right before auto-snapping routine takes picture.

Constructor Summary

Constructors

Constructor and Description
AutoSnappingController(ScanbotCameraView cameraView, ContourDetectorFrameHandler contourDetectorFrameHandler)

Method Summary

Methods

Modifier and Type	Method and Description
static AutoSnappingController	attach(ScanbotCameraView cameraView) Same as attach(ScanbotCameraView, ContourDetectorFrameHandler), but creates new ContourDetectorFrameHandler which will be attached to camera.
static AutoSnappingController	attach(ScanbotCameraView cameraView, ContourDetectorFrameHandler contourDetectorFrameHandler) Convenience method for attaching AutoSnappingController to camera view and ContourDetectorFrameHandler.
boolean	isEnabled()
void	setAutoSnappingCallback(AutoSnappingController.AutoSnappingCallback callback)
void	setEnabled(boolean enabled)
void	setSensitivity(float sensitivity) Changes sensitivity of auto-snapping.

Methods inherited from class java.lang.Object

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

Constructor Detail

AutoSnappingController

public AutoSnappingController(ScanbotCameraView cameraView,
                      ContourDetectorFrameHandler contourDetectorFrameHandler)

Method Detail

attach

public static AutoSnappingController attach(ScanbotCameraView cameraView)

Same as attach(ScanbotCameraView, ContourDetectorFrameHandler), but creates new ContourDetectorFrameHandler which will be attached to camera.

Use this method if you don't need to control contour detection routine. However, be careful to not accidentally attach several ContourDetectorFrameHandler to camera therefore causing contour detection to be executed more than once.

attach

public static AutoSnappingController attach(ScanbotCameraView cameraView,
                            ContourDetectorFrameHandler contourDetectorFrameHandler)

Convenience method for attaching AutoSnappingController to camera view and ContourDetectorFrameHandler.

Auto-snapping is enabled by default as soon as you create new instance of AutoSnappingController. You can manually enable or disable auto-snapping by calling setEnabled(boolean).

Parameters:

cameraView - camera view which is used for snapping

contourDetectorFrameHandler - ContourDetectorFrameHandler which will be attached to camera.

Returns:

new AutoSnappingController

setEnabled

public void setEnabled(boolean enabled)

Parameters:

enabled - true to enable auto-snapping. false to disable auto-snapping.

isEnabled

public boolean isEnabled()

Returns:

true if auto-snapping is enabled. false if auto-snapping is disabled.

setSensitivity

public void setSensitivity(float sensitivity)

Changes sensitivity of auto-snapping. That is: the more sensitive it is the faster it shoots. This comes at the cost of precision as with high sensitivity auto-snapping controller might suffer from false-positives.

Lower sensitivity reduces effect of false-positives at the cost of slower shooting.

Sensitivity must be within [0..1] range.

Default value is 1

Parameters:

sensitivity - sensitivity within [0..1] range. If given value is outside of this range it is clamped

setAutoSnappingCallback

public void setAutoSnappingCallback(AutoSnappingController.AutoSnappingCallback callback)

Parameters:

callback - callback which will be called right before auto-snapping routine takes picture.