ImageProperties
The ImageProperties message contains the properties of an image as calculated by the BioID Web Service for a single input image of video frame.
Message definition
message ImageProperties {
int32 rotated = 1;
repeated Face faces = 2;
double quality_score = 3;
repeated QualityAssessment quality_assessments = 4;
int32 frame_number = 5;
}}
message Face {
PointD left_eye = 2;
PointD right_eye = 3;
double texture_liveness_score = 11;
double motion_liveness_score = 12;
double movement_direction = 13;
}
message PointD {
double x = 1;
double y = 2;
}
ImageProperties fields
rotated-
Rotation of the input image. If not 0, all coordinates mentioned here relate to an image rotated clockwise by this amount of degrees.
Possible values are 90, 180 or 270 degrees.
Note that any rotation EXIF metadata embedded in the image is applied before this rotation is calculated!
faces-
List of faces found in the image.
quality_score-
An optionally calculated quality assessment score.
Not yet implemented (will be added with quality-check API).
quality_assessments-
List of quality checks and other checks performed. See QualityAssessment message.
frame_number-
Optional frame number. If the input is a video, this is the number of the processed frame within the video. For input images, this number is typically kept at 0.
Face fields
The Face message describes some landmarks of a found face within an image together with some optional scores generated by additional DCNNs.
Note: It is important to know that we assume, that the face image is typically mirrored, i.e. the right eye is on the left side of the image and vice versa!
left_eye- Position of the center of the left eye.
right_eye- Position of the center of the right eye.
texture_liveness_score-
A score in the range ]0.0, 1.0] for the probability that the detected face is from a live person.
The higher the score, the more likely the person is a live person.
A value of 0.0 indicates that a liveness detection was not performed on this face yet (or failed).
motion_liveness_score-
A score in the range ]0.0, 1.0] for the probability that the face motion (calculated with the help of previous images) is a natural 3D motion.
The higher the score, the more likely the motion is in 3D.
A value of 0.0 indicates that this score has not been calculated.
movement_direction-
Calculated movement direction of this face relative to the position of this face in a previous image in the range ]0, 360] degrees.
A value of 0.0 indicates that no movement direction has been calculated.
PointD
Represents an ordered pair of double precision floating point x- and y-coordinates that defines a point in a two-dimensional plane.
x- The x-coordinate of the point.
y- The y-coordinate of the point.
