Table of Contents

Class CVFace

Namespace
VisioForge.Core.Types.VideoProcessing
Assembly
VisioForge.Core.dll

Represents a detected face in a video frame, including its bounding box and the positions of key facial features like eyes, nose, and mouth.

public class CVFace

Inheritance

Inherited Members

Remarks

This class is used in conjunction with face detection and tracking functionalities to provide detailed information about each identified face. It can be used for various applications such as facial recognition, emotion analysis, or augmented reality overlays. Position property defines the overall face bounding box in the video frame. Eyes list typically contains two Rect objects for left and right eye positions, enabling gaze tracking and eye-based features. Nose and Mouth properties provide additional facial landmarks for expression analysis and face alignment. Timestamp indicates when the face was detected, enabling temporal tracking and synchronization. Facial landmarks enable advanced features: eye tracking, emotion detection, face mesh generation, AR filters, and liveness detection. Detection accuracy depends on face angle, lighting, occlusion, resolution, and the detection algorithm used. Feature positions are relative to the frame coordinates and can be used for overlay rendering or geometric analysis. This information is fundamental for face recognition systems, requiring alignment and normalization for comparison. Applications include access control, attendance systems, emotion analytics, AR effects, and user interface control. Privacy considerations are important when storing or processing facial feature data.

Constructors

CVFace()

Initializes a new instance of the VisioForge.Core.Types.VideoProcessing.CVFace class. Initializes VisioForge.Core.Types.VideoProcessing.CVFace.Eyes with two empty VisioForge.Core.Types.Rect instances.

public CVFace()

Properties

Eyes

Gets a list of VisioForge.Core.Types.Rect objects, typically representing the bounding boxes of the detected eyes. This list usually contains two elements for the left and right eyes.

public List<Rect> Eyes { get; }

Property Value

List<Rect>

Mouth

Gets or sets the bounding rectangle of the detected mouth.

public Rect Mouth { get; set; }

Property Value

Rect

Nose

Gets or sets the bounding rectangle of the detected nose.

public Rect Nose { get; set; }

Property Value

Rect

Position

Gets or sets the bounding rectangle of the detected face.

public Rect Position { get; set; }

Property Value

Rect

Timestamp

Gets or sets the timestamp of the video frame in which the face was detected.

public TimeSpan Timestamp { get; set; }

Property Value

TimeSpan

Methods

ToString()

Returns a string that represents the current VisioForge.Core.Types.VideoProcessing.CVFace instance. The string includes the face's position and, if available, the positions of the mouth, nose, and eyes.

public override string ToString()

Returns

string

A String that represents this instance.