lti::faceThreshold Class Reference

The ltiFaceThreshold-class calculates for a given skin probability mask of an image an extraction-threshold that allows to 'cut-out' the face (blob) of the shown person. More...

#include <ltiFaceThreshold.h>

Inheritance diagram for lti::faceThreshold:

[legend]

Collaboration diagram for lti::faceThreshold:

[legend]

List of all members.

Classes
class	parameters
	The parameters for the class faceThreshold. More...
Public Member Functions
	faceThreshold ()
	faceThreshold (const parameters &par)
	faceThreshold (const faceThreshold &other)
virtual	~faceThreshold ()
virtual const char *	getTypeName () const
bool	apply (const channel &input, float &threshold) const
bool	apply (const channel &input, float &threshold, borderPoints &faceBlob) const
bool	apply (const channel8 &input, int &threshold) const
bool	apply (const channel8 &input, int &threshold, borderPoints &faceBlob) const
faceThreshold &	copy (const faceThreshold &other)
faceThreshold &	operator= (const faceThreshold &other)
virtual functor *	clone () const
const faceThreshold::parameters &	getParameters () const

---

Detailed Description

The ltiFaceThreshold-class calculates for a given skin probability mask of an image an extraction-threshold that allows to 'cut-out' the face (blob) of the shown person.

Depending on the apply()-method that is being called, the resulting face-blob is also returned.
In order to do so, a blob-ranking is performed, which can be done in two ways:

• linear mode: every n-th threshold is tested
• time-optimized mode: binary search like threshold testing

For every regarded threshold, all blobs (with size greater than a specified minimum) are extracted and then ranked considering the following criteria:

1. the compactness
2. the main axis orientation
3. the relation of the the bounding box's edges' lengths
4. the horizontal position in the image
5. the vertical position in the image
6. the size (relative to image size)
7. the skin-probability

The result is the threshold that causes the blob with the highest score. For a detailed description of the functions that benchmark the above mentioned criteria see the individual parameters (lti::faceThreshold::parameters) that determine computation.

---

Constructor & Destructor Documentation

lti::faceThreshold::faceThreshold

(

)

default constructor

lti::faceThreshold::faceThreshold

(

const parameters &

par

)

Construct a functor using the given parameters.

lti::faceThreshold::faceThreshold

(

const faceThreshold &

other

)

copy constructor

Parameters:

other

the object to be copied

virtual lti::faceThreshold::~faceThreshold

(

)

[virtual]

destructor

---

Member Function Documentation

bool lti::faceThreshold::apply	(	const channel8 &	input,
		int &	threshold,
		borderPoints &	faceBlob
	)			const

Apply.

Parameters:

	input	channel8 with the source data
	threshold	resulting threshold
	faceBlob	resulting face blob

Returns:

true if apply successful or false otherwise.

bool lti::faceThreshold::apply	(	const channel8 &	input,
		int &	threshold
	)			const

Apply.

Parameters:

	input	channel8 with the source data
	threshold	resulting threshold

Returns:

true if apply successful or false otherwise.

bool lti::faceThreshold::apply	(	const channel &	input,
		float &	threshold,
		borderPoints &	faceBlob
	)			const

Apply.

Parameters:

	input	channel with the source data
	threshold	resulting threshold
	faceBlob	resulting face blob

Returns:

true if apply successful or false otherwise.

bool lti::faceThreshold::apply	(	const channel &	input,
		float &	threshold
	)			const

Apply.

Parameters:

	input	channel with the source data
	threshold	resulting threshold

Returns:

true if apply successful or false otherwise.

virtual functor* lti::faceThreshold::clone

(

)

const [virtual]

returns a pointer to a clone of this functor.

Implements lti::functor.

faceThreshold& lti::faceThreshold::copy

(

const faceThreshold &

other

)

Copy data of "other" functor.

Parameters:

other

the functor to be copied

Returns:

a reference to this functor object

Reimplemented from lti::functor.

const faceThreshold::parameters& lti::faceThreshold::getParameters

(

)

const

returns used parameters

Reimplemented from lti::functor.

virtual const char* lti::faceThreshold::getTypeName

(

)

const [virtual]

returns the name of this type ("faceThreshold")

Reimplemented from lti::functor.

faceThreshold& lti::faceThreshold::operator=

(

const faceThreshold &

other

)

alias for copy member

Parameters:

other

the functor to be copied

Returns:

a reference to this functor object

Reimplemented from lti::functor.

---

The documentation for this class was generated from the following file:

• ltiFaceThreshold.h