Table of Contents

Class VideoEffectSharpen

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

Represents a sharpening effect that enhances edge definition and fine details in the video image.

public class VideoEffectSharpen : VideoEffect, IVideoEffectSharpen, IVideoEffect

Inheritance

Implements

Inherited Members

Remarks

The sharpen effect emphasizes edges and fine details by detecting and enhancing areas of rapid intensity change in the image. This is achieved through high-pass filtering or unsharp masking techniques that increase local contrast along edges.

Common applications include:

  • Enhancing slightly out-of-focus footage
  • Improving perceived image quality
  • Compensating for softness introduced by compression
  • Creating crisp, detailed video output
  • Preparing video for display on high-resolution screens

The effect has no adjustable intensity parameters - it applies a standard sharpening filter. Be aware that excessive sharpening can introduce visual artifacts such as halos around edges or enhanced noise. For GPU-accelerated sharpening with better performance, consider using VisioForge.Core.Types.VideoEffects.GPUVideoEffectSharpen.

Constructors

VideoEffectSharpen(bool, string, TimeSpan, TimeSpan)

Initializes a new instance of the VisioForge.Core.Types.VideoEffects.VideoEffectSharpen class with specified parameters.

public VideoEffectSharpen(bool enabled, string name = "Sharpen", TimeSpan startTime = default, TimeSpan stopTime = default)

Parameters

enabled bool

true to enable the effect immediately; false to create the effect in a disabled state.

name string

An optional name identifier for this effect instance. Default is "Sharpen". Used to retrieve specific effect instances from a collection.

startTime TimeSpan

The time at which the effect should start being applied. Default is Zero, which applies the effect from the beginning.

stopTime TimeSpan

The time at which the effect should stop being applied. Default is Zero, which applies the effect until the end.

Remarks

The sharpening effect applies a fixed-strength filter. If both startTime and stopTime are zero (default), the effect will be applied for the entire video duration.

Note: Sharpening should be applied judiciously as it can amplify both details and noise. It works best on slightly soft footage rather than already-sharp or noisy video.

Methods

GetEffectType()

Gets the specific type of this video effect.

public VideoEffectType GetEffectType()

Returns

VideoEffectType

Returns VisioForge.Core.Types.VideoEffects.VideoEffectType.Sharpen to identify this as a sharpening effect.

Remarks

This method is used by the video processing pipeline to route the effect to the appropriate sharpening filter processor.