Class ChebyshevBandPassRejectBlock
- Assembly
- VisioForge.Core.dll
Chebyshev band pass and band reject audio filter block for precise frequency domain processing. This block implements high-quality Chebyshev filters that can operate in band-pass or band-reject modes to selectively allow or remove specific frequency ranges from audio signals. Chebyshev filters provide steeper roll-off characteristics compared to Butterworth filters, making them ideal for applications requiring precise frequency separation. The block supports configurable ripple, cutoff frequencies, and filter order for optimal audio filtering performance. Essential for audio cleanup, noise reduction, frequency isolation, and professional audio processing applications. Implements the VisioForge.Core.MediaBlocks.MediaBlock. Implements the VisioForge.Core.MediaBlocks.IMediaBlockInternals. Implements the IDisposable.
public class ChebyshevBandPassRejectBlock : MediaBlock, IMediaBlock, IDisposable, IMediaBlockInternalsInheritance
Implements
Inherited Members
Extension Methods
Constructors
ChebyshevBandPassRejectBlock(ChebyshevBandPassRejectAudioEffect)
Initializes a new instance of the VisioForge.Core.MediaBlocks.AudioProcessing.ChebyshevBandPassRejectBlock class with specified Chebyshev filter settings for band-pass or band-reject operation.
public ChebyshevBandPassRejectBlock(ChebyshevBandPassRejectAudioEffect settings)Parameters
settingsChebyshevBandPassRejectAudioEffect-
The Chebyshev filter configuration settings defining mode, cutoff frequencies, 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 band-pass/reject filter settings. Contains configuration for filter mode (band-pass or band-reject), lower and upper cutoff frequencies, filter order, ripple amount, and other parameters for precise frequency domain control.
public ChebyshevBandPassRejectAudioEffect Settings { get; set; }Property Value
Type
Gets the type.
public override MediaBlockType Type { get; }Property Value
Methods
Build()
Constructs and initializes the Chebyshev band-pass/reject 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 domain audio processing 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 band-pass/reject 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 band-pass/reject 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 band-pass/reject 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 band-pass/reject 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.