Face Recognition
An extension of Face Detection that compares detected faces against enrolled faces to identify who they are. Enrolling and deleting faces is also done through this action's commands.
Commands
| Command | Description |
|---|---|
| Recognize Face | Identifies which enrolled face the current face is and writes the name and similarity. |
| Get Enrolled Count | Writes the total number of enrolled faces. |
| Get Enrolled List | Writes the enrolled face names as a comma-separated string. |
| Enroll Face | Enrolls the face currently on screen under Face Name. |
| Delete Face | Deletes the enrolled face whose name equals Face Name. |
| Clear All Faces | Deletes every enrolled face. |
Settings
| Setting | Description |
|---|---|
| Threshold (%) | Similarity threshold. 0 to 100, default 70. A face counts as matched only when the similarity is at or above this value. |
| Min Face Area (px²) | Minimum pixel area of a face to recognize. Faces smaller (farther) than this are excluded. 0 means no limit. The input is normalized to 112×112, so very small faces lose accuracy when upscaled. The default 6400 (80×80) is a balanced value; raise it to 12544 (112×112) for close-range, high-precision recognition only. |
| Face Name | Name of the face to enroll or delete. Example: john, Alice. |
The face store is chosen by the analyzer setting DB Name (default
default); analyzers with the same name share data. Anti-Spoofing,
which blocks faces shown on photos or screens, is also an analyzer setting
(Part 6, AI Analyzer).
Enroll Face enrolls the largest face when several faces are on screen, and enrolls nothing when no face is detected. Enrolling again under a name that already exists does not overwrite the existing face; it adds another face sample to that name. Enrolling the same name from several angles, such as front and side, makes recognition more stable. To start a name over, delete it with Delete Face and then enroll it.
Output Variables
| Field | Type | Value |
|---|---|---|
| Face Detected | Digital | True when a face is detected. |
| Matched | Digital | True when an enrolled face matches at or above the threshold. |
| Recognized Name | Text | Name of the matched face. An empty string when there is no face; Unknown when a face is present but matches no enrolled face. |
| Similarity (%) | Number | Similarity to the closest enrolled face, 0 to 100. |
| Enrolled Count | Number | Number of enrolled faces. |
| Enrolled List | Text | Enrolled names, comma-separated. |
This type has no JSON output.