Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The description of the FIRSERVER object commands:

CommandDescription
GET_IMAGE
Getting
Get the image by its ID
SET_SOURCES
Rearranging

Rearrange the Recognition channel objects in the Axxon PSIM objects tree. The existing Recognition channel objects will be deleted, the new ones will be created and configured for the face detection objects whose IDs are specified in the sources<> parameter.

Note. If the sources<> parameter contains non-existing IDs of face detection objects, the Recognition channel objects will be created with the default settings (as configured in Axxon PSIM)

VERIFY_START

User verification. It compares the face captured in the frame with the user photo, which is stored on the disk at the path: <Axxon PSIM installation directory>\Bmp\<Person>

ADD_PERSON_FROM_FILE
Adding

Add of a reference face from a file to the reference face database

PHOTO_ADDED
Updating

Update a photo for an existing face in

the reference

the reference face database

START_CAM_FACECAPTURE
Starting the
Start face detection
STOP_CAM_FACECAPTURE
Stopping the
Stop face detection
CHECK_QUALITY_START
Checking
Check the quality of the saved user photo. Compares the quality of the user photo to the specified minimum quality of the face on the Face Recognition Server. Determines the quality of the photo or its absence
QUERY_RECOGNIZE_STARTRecognition upon request

The list of the commands command parameters:

ParameterParameter description
requestId<>The request ID (is required to uniquely associate the request with the response on the client side)
id<>The image ID
sources<>
The list of existing Face detection objects IDs
biggestFace<1>

If there are several faces in the added photo, then the reference face with the biggest size in the frame will be added to the database

person_id<>

The face identifier in the reference face database

image<>The image in the "base64" format
delay<>

The command execution delay in seconds

cam_id<>The camera ID
p_id<>

The name of the photo file in the <Axxon PSIM installation directory>\Bmp\<Person> folder without permission

wait<>Timeout in seconds
filename<>

The full name of the photo file. Files with the JPG, BMP, GIF, PNG extensions are allowed

name<>First name of the added user
surname<>Last name of the added user
department<>The department to which the user will be added
comment<>Commentary
cam_
facecapture<>
facecapture<id> Face detection<id>
p_id<>The ID of the user whose photo quality is checked

The Example of a command example for getting the an image by its ID:

Code Block
DoReact(FIRSERVER|1|GET_IMAGE|id<052B723D-5C29-E811-88D3-005056C00008>,requestId<76C5B293-FD2F-4F25-B1D7-7B62442D2E89>);

In response to this request, a message will be received, where the "image" parameter will contain an image in the "base64" format (for the details on the event generated by the request, see FIRSERVER events).

The command example for Example of a command for rearranging the Recognition channel objects in the Axxon PSIM objects tree:

Code Block
DoReact(FIRSERVER|1|SET_SOURCES|sources<2.1,3.1>);

The command example for updating Example of a command for updating a user's photo by his identifier:

Code Block
DoReactStr("FIRSERVER",1,"PHOTO_ADDED","person_id<1>,biggestFace<1>,image<base64>,delay<1>");

The Example of a command example for the user verification:

Code Block
DoReactStr("FIRSERVER","1","VERIFY_START","cam_id<1>,p_id<15>,wait<10>");

The command example for adding Example of a command for adding a face from a file to the reference face database:

Code Block
DoReactStr("FIRSERVER","1","ADD_PERSON_FROM_FILE","filename<c:\\iso_small.jpg>,name<Jane>,surname<Kramer>,department<Department 1>,comment<>");

The Example of a command example for stopping the face detection:

Code Block
FIRSERVER|1|STOP_CAM_FACECAPTURE|cam_facecapture<3.1>

The Example of a command example for starting the face detection:

Code Block
FIRSERVER|1|START_CAM_FACECAPTURE|cam_facecapture<3.1>

The Example of a command example for checking the quality of a saved user photo:

Code Block
DoReactStr("FIRSERVER","1","CHECK_QUALITY_START","p_id<1>");

Example of a command for face recognition upon request for a specific camera:

Code Block
DoReactStr("FIRSERVER","1","QUERY_RECOGNIZE_START","from_script<1>, cam_facecapture<3.1>");