Table of Contents

Class CVFaceBlurBlock

Namespace
VisioForge.Core.MediaBlocks.OpenCV
Assembly
VisioForge.Core.dll

OpenCV face blur block for automatic privacy protection in video streams. This block combines face detection with blur effects to automatically obscure faces for privacy compliance. Uses machine learning algorithms to detect human faces in real-time and applies configurable blur effects to protect individual privacy. Essential for surveillance systems, social media platforms, and video conferencing applications where privacy regulations require face anonymization. Supports multiple blur algorithms and adjustable detection sensitivity for various lighting conditions. Implements the VisioForge.Core.MediaBlocks.MediaBlock. Implements the VisioForge.Core.MediaBlocks.IMediaBlockInternals. Implements the IDisposable.

public class CVFaceBlurBlock : MediaBlock, IMediaBlock, IDisposable, IMediaBlockInternals

Inheritance

Implements

Inherited Members

Extension Methods

Constructors

CVFaceBlurBlock(CVFaceBlurSettings)

Initializes a new instance of the VisioForge.Core.MediaBlocks.OpenCV.CVFaceBlurBlock class with the specified face detection and blurring settings.

public CVFaceBlurBlock(CVFaceBlurSettings settings)

Parameters

settings CVFaceBlurSettings

The face blur configuration settings containing detection and privacy parameters.

Properties

Input

Gets the input pad for connecting video sources to be processed.

public override MediaBlockPad Input { get; }

Property Value

MediaBlockPad

Inputs

Gets all input pads for this face blur block.

public override MediaBlockPad[] Inputs { get; }

Property Value

MediaBlockPad[]

Output

Gets the output pad for connecting to downstream processing blocks.

public override MediaBlockPad Output { get; }

Property Value

MediaBlockPad

Outputs

Gets all output pads for this face blur block.

public override MediaBlockPad[] Outputs { get; }

Property Value

MediaBlockPad[]

Settings

Gets or sets the face blur configuration settings. Defines detection sensitivity, blur parameters, and privacy protection options.

public CVFaceBlurSettings Settings { get; set; }

Property Value

CVFaceBlurSettings

Type

Gets the media block type identifier.

public override MediaBlockType Type { get; }

Property Value

MediaBlockType

Methods

Build()

Constructs and initializes the OpenCV face blur element within the pipeline. This method creates the face blur filter with the specified detection and blurring settings, establishes input and output pads, and prepares the block for privacy protection processing.

public override bool Build()

Returns

bool

true if the face blur element was successfully built and configured; false if initialization failed.

CleanUp()

Releases all resources and performs cleanup operations for this OpenCV face blur block. This method disposes of the face blur element and resets the build state.

public void CleanUp()

Dispose(bool)

Releases unmanaged and - optionally - managed resources.

protected override void Dispose(bool disposing)

Parameters

disposing bool

true to release both managed and unmanaged resources; false to release only unmanaged resources.

GetCore()

Gets the core BaseElement wrapper that provides additional functionality around the OpenCV face blur element.

public BaseElement GetCore()

Returns

BaseElement

The BaseElement wrapper instance that encapsulates the face blur functionality.

GetElement()

Gets the underlying GStreamer element that performs the face blur operation.

public Element GetElement()

Returns

Element

The GStreamer Element instance representing the OpenCV face blur filter.

IsAvailable()

Determines whether this media block is available. Correct NuGet SDK redist should be included into your project. Checks for OpenCV library availability and face detection/blurring support.

public static bool IsAvailable()

Returns

bool

true if OpenCV face blur functionality is available; otherwise, false.

IMediaBlockInternals.SetContext(MediaBlocksPipeline)

Associates this OpenCV face blur block with a pipeline and initializes its internal context. This method is called internally when the block is added to a pipeline.

void IMediaBlockInternals.SetContext(MediaBlocksPipeline pipeline)

Parameters

pipeline MediaBlocksPipeline

The MediaBlocksPipeline instance that will manage this block.

See Also