Table of Contents

Class FaceTrackingSettings

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

Represents the settings for configuring face tracking operations within the video processing components. This class allows control over parameters such as minimum face size, color mode, search mode, and scaling factors.

public class FaceTrackingSettings

Inheritance

Inherited Members

Remarks

Proper configuration of these settings is crucial for optimizing face detection and tracking performance and accuracy for various scenarios, such as different camera distances, lighting conditions, or target face sizes. MinimumWindowSize filters out small false positives and defines the minimum detectable face size in pixels. ColorMode determines the color space used by the tracking algorithm (RGB, HSL, or Mixed), affecting robustness to lighting changes. SearchMode controls whether to detect a single face or multiple faces in each frame. ScaleFactor determines step size when resizing the search window: smaller values provide finer search but slower performance. ScalingMode defines search direction (larger-to-smaller or smaller-to-larger), optimized based on expected face sizes. Highlight enables visual overlay rendering of detected faces for debugging and user feedback. Optimal settings depend on use case: security cameras benefit from multiple face detection, selfie apps may use single mode. Smaller MinimumWindowSize detects distant faces but increases false positives and processing time. ScaleFactor of 1.05-1.1 provides thorough search, 1.3-1.5 prioritizes speed over accuracy. These settings directly impact CPU/GPU usage and detection latency, requiring balance for real-time applications.

Constructors

FaceTrackingSettings()

Initializes a new instance of the VisioForge.Core.Types.VideoProcessing.FaceTrackingSettings class with default values. Default values are: VisioForge.Core.Types.VideoProcessing.FaceTrackingSettings.MinimumWindowSize = 25, VisioForge.Core.Types.VideoProcessing.FaceTrackingSettings.SearchMode = VisioForge.Core.Types.VideoProcessing.ObjectDetectorSearchMode.Single, VisioForge.Core.Types.VideoProcessing.FaceTrackingSettings.ScaleFactor = 1.2f, VisioForge.Core.Types.VideoProcessing.FaceTrackingSettings.ScalingMode = VisioForge.Core.Types.VideoProcessing.ObjectDetectorScalingMode.GreaterToSmaller.

public FaceTrackingSettings()

Properties

ColorMode

Gets or sets the color mode to be used by the face tracking algorithm.

public CamshiftMode ColorMode { get; set; }

Property Value

CamshiftMode

See Also

Highlight

Gets or sets a value indicating whether visual highlighting of detected faces is enabled.

public bool Highlight { get; set; }

Property Value

bool

MinimumWindowSize

Gets or sets the minimum window size (in pixels) to consider when searching for objects (faces). Objects smaller than this size will be ignored. Default value is 25.

public int MinimumWindowSize { get; set; }

Property Value

int

ScaleFactor

Gets or sets the scaling factor used to rescale the search window during the detection process. A smaller value (e.g., 1.05) means a finer search, potentially more accurate but slower. Default value is 1.2f.

public float ScaleFactor { get; set; }

Property Value

float

ScalingMode

Gets or sets the scaling mode to use when re-scaling the search window during detection. Default is VisioForge.Core.Types.VideoProcessing.ObjectDetectorScalingMode.GreaterToSmaller.

public ObjectDetectorScalingMode ScalingMode { get; set; }

Property Value

ObjectDetectorScalingMode

See Also

SearchMode

Gets or sets the search mode for face tracking, determining whether to detect a single face or multiple faces.

public ObjectDetectorSearchMode SearchMode { get; set; }

Property Value

ObjectDetectorSearchMode

See Also