Package com.anlavn.opencv

Class FaceRecognition

java.lang.Object

com.anlavn.opencv.FaceRecognition

public final class FaceRecognition
extends Object

The FaceRecognition class supports to face recognition in java, using python program compiled.

Constructor Summary

Constructors

Constructor	Description
FaceRecognition()

Method Summary

Modifier and Type	Method	Description
static final Double	getPercent()	Use this method to get facial recognition percentage.
static final Boolean	isMatch()	Use this method to check if the face matches the original face?
static final void	loadModule()	Use this method to check Module support for face recognition. Run this method first.
static final String	Recognition()	Use this method to recognition and get result after setup successfully all parameter.
static final void	setImageOrginal(BufferedImage buff)	Use this method to set image for original face from BufferedImage.
static final void	setImageOrginal(String image)	Use this method to set image for original face from File or URL.
static final void	setImageTesting(BufferedImage buff)	Use this method to set image for testing face from BufferedImage.
static final void	setImageTesting(String image)	Use this method to set image for testing face from File or URL.
static final void	setRequirementPercent(Double per)	Use this method to set the required percentage for face recognition.

Methods inherited from class java.lang.Object

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

Constructor Details

FaceRecognition

public FaceRecognition()

Method Details

loadModule

public static final void loadModule()

Use this method to check Module support for face recognition.
Run this method first.

See Also:

• setImageOrginal(java.lang.String)
• setImageOrginal(java.awt.image.BufferedImage)
• setImageTesting(java.lang.String)
• setImageTesting(java.awt.image.BufferedImage)
• setRequirementPercent(java.lang.Double)

setImageOrginal

public static final void setImageOrginal(String image)
                                  throws IOException

Use this method to set image for original face from File or URL.

Parameters:

image - is specific location of face image, it can be local path in computer or link address of image.
Example: "C:/Users/Admin/Pictures/funfact.jpg"
or "https://www.onthisday.com/images/people/rowan-atkinson-medium.jpg"

Throws:

IOException - throw an exception if there is no internet connection or can't download image from link.

See Also:

• setImageOrginal(java.awt.image.BufferedImage)
• setImageTesting(java.lang.String)
• setImageTesting(java.awt.image.BufferedImage)
• setRequirementPercent(java.lang.Double)

setImageTesting

public static final void setImageTesting(String image)
                                  throws IOException

Use this method to set image for testing face from File or URL.

Parameters:

image - is specific location of face image, it can be local path in computer or link address of image.
Example: "C:/Users/Admin/Pictures/funfact.jpg"
or "https://www.onthisday.com/images/people/rowan-atkinson-medium.jpg"

Throws:

IOException - throw an exception if there is no internet connection or can't download image from link.

See Also:

• setImageOrginal(java.lang.String)
• setImageOrginal(java.awt.image.BufferedImage)
• setImageTesting(java.awt.image.BufferedImage)
• setRequirementPercent(java.lang.Double)

setImageOrginal

public static final void setImageOrginal(BufferedImage buff)
                                  throws IOException

Use this method to set image for original face from BufferedImage.

Parameters:

buff - is BufferedImage of face image.

Throws:

IOException - throw an exception if can't write BufferedImage to file.

See Also:

• setImageOrginal(java.lang.String)
• setImageTesting(java.lang.String)
• setImageTesting(java.awt.image.BufferedImage)
• setRequirementPercent(java.lang.Double)

setImageTesting

public static final void setImageTesting(BufferedImage buff)
                                  throws IOException

Use this method to set image for testing face from BufferedImage.

Parameters:

buff - is BufferedImage of face image.

Throws:

IOException - throw an exception if can't write BufferedImage to file.

See Also:

• setImageOrginal(java.lang.String)
• setImageOrginal(java.awt.image.BufferedImage)
• setImageTesting(java.lang.String)
• setRequirementPercent(java.lang.Double)

setRequirementPercent

public static final void setRequirementPercent(Double per)

Use this method to set the required percentage for face recognition. More high more hard. 65 is typical best performance and the default value also.

Parameters:

per - is percentage required for face recognition to return true.

See Also:

• setImageOrginal(java.lang.String)
• setImageOrginal(java.awt.image.BufferedImage)
• setImageTesting(java.lang.String)
• setImageTesting(java.awt.image.BufferedImage)

Recognition

public static final String Recognition()

Use this method to recognition and get result after setup successfully all parameter.

Returns:

Result after recognition:
[True] if Testing Face match Original Face and Percent greater than or equal to RequirementPercent.
[False] if Testing Face does not match Original Face or Percent less than RequirementPercent.
[Empty Error] if Original Face or Testing Face not exists.
[Invalid Version] if the current version of FaceRecognition does not match the requirements version. Then the program will stop immediately.
[Connection Error] if an exception occurs when checking the requirements version. Then the program will stop immediately.
[Face Recognition Error] if an exception occurs when recognizing face. Like:
1. No or too many faces in the frame.
2. Brightness is too low.
3. The distance between the face and the camera is too far.
4. There are masks, glasses, hair covering the face...

See Also:

• getPercent()
• isMatch()

getPercent

public static final Double getPercent()

Use this method to get facial recognition percentage.

Returns:

Percent accuracy of face after recognition.

See Also:

• Recognition()
• isMatch()

isMatch

public static final Boolean isMatch()

Use this method to check if the face matches the original face?

Returns:

true if Testing Face match Original Face.
false if Testing Face does not match Original Face

See Also:

• Recognition()
• getPercent()