Class ChebyshevLimitBlock
- Assembly
- VisioForge.Core.dll
Chebyshev low pass and high pass filter block for frequency range limiting and audio cleanup. This block implements high-quality Chebyshev filters that can operate in low-pass or high-pass modes to remove unwanted frequency content from audio signals. Chebyshev filters provide steeper roll-off characteristics compared to Butterworth filters with configurable ripple and cutoff frequency. Essential for anti-aliasing, noise reduction, audio cleanup, and frequency band limiting applications in professional audio processing and broadcast systems. Implements the VisioForge.Core.MediaBlocks.MediaBlock. Implements the VisioForge.Core.MediaBlocks.IMediaBlockInternals. Implements the IDisposable.
public class ChebyshevLimitBlock : MediaBlock, IMediaBlock, IDisposable, IMediaBlockInternalsInheritance
Implements
Inherited Members
Extension Methods
Constructors
ChebyshevLimitBlock(ChebyshevLimitAudioEffect)
Initializes a new instance of the VisioForge.Core.MediaBlocks.AudioProcessing.ChebyshevLimitBlock class with specified Chebyshev filter settings for low-pass or high-pass operation.
public ChebyshevLimitBlock(ChebyshevLimitAudioEffect settings)Parameters
settingsChebyshevLimitAudioEffect-
The Chebyshev filter configuration settings defining mode, cutoff frequency, and filter characteristics.
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
Settings
Gets or sets the Chebyshev limit filter settings. Contains configuration for filter mode (low-pass or high-pass), cutoff frequency, filter order, ripple amount, and other parameters for precise frequency limiting.
public ChebyshevLimitAudioEffect Settings { get; set; }Property Value
Type
Gets the type.
public override MediaBlockType Type { get; }Property Value
Methods
Build()
Constructs and initializes the Chebyshev limit filter and its associated GStreamer elements. This method creates the filter with the specified settings, establishes input and output pads, and prepares the block for frequency limiting with steep roll-off characteristics.
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 Chebyshev limit filter 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 Chebyshev limit filter element.
public BaseElement GetCore()Returns
- BaseElement
-
The BaseElement wrapper instance that encapsulates the GStreamer Chebyshev filter.
GetElement()
Gets the underlying GStreamer element that performs the Chebyshev low-pass/high-pass filtering.
public Element GetElement()Returns
- Element
-
The GStreamer Element instance representing the Chebyshev filter.
IsAvailable()
Determines whether this media block is available. Correct NuGet SDK redist should be included into your project.
public static bool IsAvailable()Returns
- bool
-
trueif this media block is available; otherwise,false.
IMediaBlockInternals.SetContext(MediaBlocksPipeline)
Associates this Chebyshev limit filter 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.