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, IMediaBlockInternalsInheritance
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
Inputs
Gets all input pads for this histogram equalization block.
public override MediaBlockPad[] Inputs { get; }Property Value
Output
Gets the output pad for connecting to downstream processing blocks.
public override MediaBlockPad Output { get; }Property Value
Outputs
Gets all output pads for this histogram equalization block.
public override MediaBlockPad[] Outputs { get; }Property Value
Type
Gets the media block type identifier.
public override MediaBlockType Type { get; }Property Value
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
-
trueif the histogram equalization element was successfully built and configured;falseif 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
disposingbool-
trueto release both managed and unmanaged resources;falseto 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
-
trueif 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
pipelineMediaBlocksPipeline-
The MediaBlocksPipeline instance that will manage this block.