Table of Contents

Class CVEqualizeHistogramBlock

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

OpenCV histogram equalization block for automatic image contrast enhancement. This block performs histogram equalization to improve image contrast by redistributing pixel intensities across the full dynamic range. The algorithm analyzes the image histogram and applies a transformation that spreads out the most frequent intensity values, resulting in enhanced visual quality. Essential for medical imaging, surveillance systems, and low-light video enhancement where contrast improvement is critical for analysis. Implements the VisioForge.Core.MediaBlocks.MediaBlock. Implements the VisioForge.Core.MediaBlocks.IMediaBlockInternals. Implements the IDisposable.

public class CVEqualizeHistogramBlock : MediaBlock, IMediaBlock, IDisposable, IMediaBlockInternals

Inheritance

Implements

Inherited Members

Extension Methods

Constructors

CVEqualizeHistogramBlock()

Initializes a new instance of the VisioForge.Core.MediaBlocks.OpenCV.CVEqualizeHistogramBlock class. Creates a histogram equalization block with default contrast enhancement settings.

public CVEqualizeHistogramBlock()

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 histogram equalization 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 histogram equalization block.

public override MediaBlockPad[] Outputs { get; }

Property Value

MediaBlockPad[]

Type

Gets the media block type identifier.

public override MediaBlockType Type { get; }

Property Value

MediaBlockType

Methods

Build()

Constructs and initializes the OpenCV histogram equalization element within the pipeline. This method creates the histogram equalization filter with default settings, establishes input and output pads, and prepares the block for contrast enhancement.

public override bool Build()

Returns

bool

true if the histogram equalization element was successfully built and configured; false if initialization failed.

CleanUp()

Releases all resources and performs cleanup operations for this OpenCV histogram equalization block. This method disposes of the histogram equalization 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 histogram equalization element.

public BaseElement GetCore()

Returns

BaseElement

The BaseElement wrapper instance that encapsulates the histogram equalization functionality.

GetElement()

Gets the underlying GStreamer element that performs the histogram equalization operation.

public Element GetElement()

Returns

Element

The GStreamer Element instance representing the OpenCV histogram equalization 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 histogram processing support.

public static bool IsAvailable()

Returns

bool

true if OpenCV histogram equalization functionality is available; otherwise, false.

IMediaBlockInternals.SetContext(MediaBlocksPipeline)

Associates this OpenCV histogram equalization 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