com.vdt.face_recognition.sdk.Capturer Class Reference

Interface object for detecting or tracking of faces in the images or video sequences. More...

Classes
enum	CapturerType
	Capturer types (see also RawSample.SampleType). More...

Public Member Functions
void	dispose ()
	Release internal object.
boolean	isDisposed ()
	Check if an object is released. More...
Vector< RawSample >	capture (final RawImage image)
	Capture faces in a given image or video frame. More...
Vector< RawSample >	capture (final byte[] data)
	Capture faces in a given image or video frame. More...
RawSample	manualCapture (final RawImage image, float left_eye_x, float left_eye_y, float right_eye_x, float right_eye_y)
	Create a sample manually with the marked eye positions. More...
RawSample	manualCapture (final RawImage image, final Vector< Point > points)
	Create a sample manually with the marked positions of all points. Used only to adjust the position of points. More...
RawSample	manualCapture (final byte[] data, float left_eye_x, float left_eye_y, float right_eye_x, float right_eye_y)
	Create a sample manually with the marked eye positions. More...
RawSample	manualCapture (final byte[] data, final Vector< Point > points)
	Create a sample manually with the marked positions of all points. Used only to adjust the position of points. More...
void	resetHistory ()
	Forget all previous frames and faces (only affects trackers).
CapturerType	getType ()
	Get a capturer type. More...
void	setParameter (final String parameter, final double value)
	Change the parameter value in runtime. More...

Detailed Description

Interface object for detecting or tracking of faces in the images or video sequences.

Member Function Documentation

Vector<RawSample> com.vdt.face_recognition.sdk.Capturer.capture ( final RawImage  image )

inline

Capture faces in a given image or video frame.

Parameters

[in]

image

Image or videoframe.

Returns

List of captured face samples.

Warning

Gray-scale images are not supported by the objects created with some configuration files.

Vector<RawSample> com.vdt.face_recognition.sdk.Capturer.capture ( final byte[]  data )

inline

Capture faces in a given image or video frame.

Parameters

[in]

data

An array of bytes of the encoded image or videoframe with 8 or 24 bits per pixel. Supported formats are JPEG, PNG, TIF and BMP.

Returns

List of captured face samples.

Warning

Gray-scale images are not supported by the objects created with some configuration files.

CapturerType com.vdt.face_recognition.sdk.Capturer.getType ( )

inline

Get a capturer type.

Returns

Type of the capturer.

boolean com.vdt.face_recognition.sdk.Capturer.isDisposed ( )

inline

Check if an object is released.

Returns

true if an object is released, false otherwise.

RawSample com.vdt.face_recognition.sdk.Capturer.manualCapture ( final RawImage  image, float  left_eye_x, float  left_eye_y, float  right_eye_x, float  right_eye_y  )

inline

Create a sample manually with the marked eye positions.

Parameters

[in]	image	Image.
[in]	left_eye_x	X coordinate of the left eye.
[in]	left_eye_y	Y coordinate of the left eye.
[in]	right_eye_x	X coordinate of the right eye.
[in]	right_eye_y	Y coordinate of the right eye.

Returns

Captured face sample.

RawSample com.vdt.face_recognition.sdk.Capturer.manualCapture ( final RawImage  image, final Vector< Point >  points  )

inline

Create a sample manually with the marked positions of all points. Used only to adjust the position of points.

Warning

For recognition methods 7.7, 6.7, 8.7: samples that are created with this member function will not contain enough information about facial landmarks (even if given points are from the FDA points set), so the FDA algorithm will be rerun during the Recognizer.processing. If you use this member function in order to avoid using RawSample.save and store the image on your own, it's recommended to use instead the new serialization functions: RawSample.saveWithoutImage and FacerecService.loadRawSampleWithoutImage.

Parameters

[in]	image	Image.
[in]	points	List of points. It should be of the same size and the points should be in the same order as in the list received from RawSample.getLandmarks from the original sample.

Returns

Captured face sample.

RawSample com.vdt.face_recognition.sdk.Capturer.manualCapture ( final byte[]  data, float  left_eye_x, float  left_eye_y, float  right_eye_x, float  right_eye_y  )

inline

Create a sample manually with the marked eye positions.

Parameters

[in]	data	An array of bytes of the encoded image or videoframe with 8 or 24 bits per pixel. Supported formats are JPEG, PNG, TIF and BMP.
[in]	left_eye_x	X coordinate of the left eye.
[in]	left_eye_y	Y coordinate of the left eye.
[in]	right_eye_x	X coordinate of the right eye.
[in]	right_eye_y	Y coordinate of the right eye.

Returns

Captured face sample.

RawSample com.vdt.face_recognition.sdk.Capturer.manualCapture ( final byte[]  data, final Vector< Point >  points  )

inline

Create a sample manually with the marked positions of all points. Used only to adjust the position of points.

Warning

For recognition methods 7.7, 6.7, 8.7: samples that are created with this member function will not contain enough information about facial landmarks (even if given points are from the FDA points set), so the FDA algorithm will be rerun during the Recognizer.processing. If you use this member function in order to avoid using RawSample.save and store the image on your own, it's recommended to use the new serialization functions: RawSample.saveWithoutImage and FacerecService.loadRawSampleWithoutImage.

Parameters

[in]	data	An array of bytes of the encoded image or videoframe with 8 or 24 bits per pixel. Supported formats are JPEG, PNG, TIF and BMP.
[in]	points	List of points. It should be of the same size, and the points should be in the same order as in the list received from RawSample.getLandmarks from the original sample.

Returns

Captured face sample.

void com.vdt.face_recognition.sdk.Capturer.setParameter ( final String  parameter, final double  value  )

inline

Change the parameter value in runtime.

Parameters

[in]	parameter	Parameter name (tag name in the .xml config file).
[in]	value	New parameter value.