Class GaussianBlurBlock
- Assembly
- VisioForge.Core.dll
MediaBlock that applies Gaussian blur or sharpening effects to video. Gaussian blur is a widely used image processing technique that reduces noise and detail by averaging neighboring pixels using a Gaussian distribution. Positive sigma values create blur effects, while negative values create sharpening effects. This filter is commonly used for creating artistic blur effects, privacy masking, or image enhancement. Implements the VisioForge.Core.MediaBlocks.MediaBlock. Implements the VisioForge.Core.MediaBlocks.IMediaBlockInternals. Implements the IDisposable.
public class GaussianBlurBlock : MediaBlock, IMediaBlock, IDisposable, IMediaBlockInternalsInheritance
Implements
Inherited Members
Extension Methods
Constructors
GaussianBlurBlock(double)
Initializes a new instance of the VisioForge.Core.MediaBlocks.VideoProcessing.GaussianBlurBlock class with the specified sigma value.
public GaussianBlurBlock(double sigma = 1.2)Parameters
sigmadouble-
The sigma value controlling blur intensity. Default value is 1.2. Positive values blur, negative values sharpen.
Properties
Input
Gets the input.
public override MediaBlockPad Input { get; }Property Value
Inputs
Gets the inputs.
public override MediaBlockPad[] Inputs { get; }Property Value
Output
Gets the output.
public override MediaBlockPad Output { get; }Property Value
Outputs
Gets the outputs.
public override MediaBlockPad[] Outputs { get; }Property Value
Sigma
Gets or sets the sigma value that controls the blur intensity and direction. Positive values create blur effects (larger values = more blur), negative values create sharpening effects. Default value is 1.2. Typical range is -3.0 to 10.0.
public double Sigma { get; set; }Property Value
Type
Gets the type.
public override MediaBlockType Type { get; }Property Value
Methods
Build()
Constructs and initializes the Gaussian blur filter and its associated GStreamer elements. This method creates the filter with the specified sigma value, establishes input and output pads, and prepares the block for video blur or sharpening processing.
public override bool Build()Returns
- bool
-
trueif the filter was successfully built and configured;falseif initialization failed.
CleanUp()
Releases all resources and performs cleanup operations for this Gaussian blur block. This method disposes of the GStreamer elements 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 GStreamer Gaussian blur filter element.
public BaseElement GetCore()Returns
- BaseElement
-
The BaseElement wrapper instance that encapsulates the GStreamer Gaussian blur filter.
GetElement()
Gets the underlying GStreamer element that performs the Gaussian blur or sharpening processing.
public Element GetElement()Returns
- Element
-
The GStreamer Element instance representing the Gaussian blur filter.
IsAvailable()
Determines whether the Gaussian blur filter is available on the current system. This checks if the required GStreamer video processing plugins are installed and accessible. The correct NuGet SDK redistribution package should be included in your project.
public static bool IsAvailable()Returns
- bool
-
trueif the Gaussian blur filter is available and can be used; otherwise,false.
IMediaBlockInternals.SetContext(MediaBlocksPipeline)
Associates this Gaussian 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
pipelineMediaBlocksPipeline-
The MediaBlocksPipeline instance that will manage this block.