Table of Contents

Class GaussianBlurVideoEffect

Namespace
VisioForge.Core.Types.X.VideoEffects
Assembly
VisioForge.Core.dll

Represents a cross-platform Gaussian blur video effect with adjustable blur intensity.

public class GaussianBlurVideoEffect : BaseVideoEffect, IBaseVideoEffect, IVideoEditXVideoEffect

Inheritance

Implements

Inherited Members

Remarks

SDK Availability: VideoCaptureCoreX, MediaPlayerCoreX, VideoEditCoreX, Media Blocks SDK (Cross-platform)

Platforms: Windows, Linux, macOS, Android, iOS

Gaussian blur applies a smooth blur effect using a Gaussian function, which provides natural-looking softening without artifacts. The effect is controlled by a sigma parameter that determines the blur radius.

Unique Feature: This effect supports negative sigma values for sharpening, making it versatile for both blur and sharpen operations in a single effect.

Use Cases:

  • Privacy protection (blur faces, license plates, sensitive information)
  • Depth-of-field simulation
  • Noise reduction
  • Artistic soft-focus effects
  • Sharpening (using negative sigma values)

Performance: Computational cost increases with higher sigma values. Consider using lower values for real-time applications on mobile devices.

See Also: For Windows-only applications, see VideoEffectBlur and GPUVideoEffectBlur for Classic SDK implementations.

Constructors

GaussianBlurVideoEffect(double, string)

Initializes a new instance of the VisioForge.Core.Types.X.VideoEffects.GaussianBlurVideoEffect class.

public GaussianBlurVideoEffect(double sigma, string name = "gaussian_blur")

Parameters

sigma double

The sigma value controlling blur intensity and direction.

  • Positive values (0.1 to 20.0): Apply blur effect. Higher values create stronger blur.
  • Zero (0.0): No effect applied.
  • Negative values (-20.0 to -0.1): Apply sharpening effect. More negative values create stronger sharpening.
  • Default: 1.2 (subtle blur)
name string

The unique name identifier for this effect instance. Default value is "gaussian_blur".

Fields

DefaultName

The default name for the Gaussian blur effect.

public static string DefaultName

Field Value

string

Properties

Sigma

Gets or sets the sigma value controlling blur intensity and direction.

public double Sigma { get; set; }

Property Value

double

Remarks

The sigma parameter determines the standard deviation of the Gaussian distribution used for blurring. Larger positive values create a wider blur radius, while negative values invert the process to enhance edges. Performance impact increases with the absolute value of sigma.

StartTime

Gets or sets the time when the effect should start being applied.

public TimeSpan StartTime { get; set; }

Property Value

TimeSpan

StopTime

Gets or sets the time when the effect should stop being applied.

public TimeSpan StopTime { get; set; }

Property Value

TimeSpan

Methods

GenerateDescription()

Generates the description.

public string GenerateDescription()

Returns

string

A string containing the GStreamer element description for the gaussianblur effect.