Skip to main content

Interface: Face

@geenee/bodyprocessors.Face

Face detection

Properties

backproj

Optional backproj: Coord3D[]


mesh

Optional mesh: MeshDetection

Basic face detection results. 2D pixel face landmarks - points in the screen coordinate space. X and Y coordinates are normalized screen coordinates (scaled by width and height of the input image), while the Z coordinate is depth within orthographic projection space. These points can be used for 2D face filters or when using orthographic projection. Additionally, bounding box [x0, y0, x1, y1] and reliability score.


metric

Optional metric: Coord3D[]

3D metric points - points within 3D space of perspective camera located at the space origin and pointed in the negative direction of the Z-axis. These points can be used to apply texture face mask.


transform

Optional transform: FacePose

Face pose - transformation matrix (translation+rotation+scale) aligning reference face 3D model with the measured 3D face mesh. Applying this transformation one can align 3D object with the detected face. If the model's initial position is aligned with the reference face, relative transformation will be preserved.