Class Equalizer10Block
- Assembly
- VisioForge.Core.dll
10-band graphic equalizer block for precise frequency response control and audio tone shaping. This block provides a traditional 10-band graphic equalizer with fixed frequency bands covering the full audio spectrum from bass to treble. Each band can be independently adjusted to boost or cut specific frequency ranges, allowing for detailed audio tone control and frequency correction. Essential for audio mastering, sound system tuning, music production, and broadcast audio processing. Implements the VisioForge.Core.MediaBlocks.MediaBlock. Implements the VisioForge.Core.MediaBlocks.IMediaBlockInternals. Implements the IDisposable.
public class Equalizer10Block : MediaBlock, IMediaBlock, IDisposable, IMediaBlockInternalsInheritance
Implements
Inherited Members
Extension Methods
Constructors
Equalizer10Block()
Initializes a new instance of the VisioForge.Core.MediaBlocks.AudioProcessing.Equalizer10Block class with all bands set to 0dB (flat frequency response).
public Equalizer10Block()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
Type
Gets the type.
public override MediaBlockType Type { get; }Property Value
Methods
Build()
Constructs and initializes the 10-band equalizer filter and its associated GStreamer elements. This method creates the filter with the specified band settings, establishes input and output pads, and prepares the block for frequency response adjustment across 10 fixed frequency bands.
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 10-band equalizer 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 10-band equalizer filter element.
public BaseElement GetCore()Returns
- BaseElement
-
The BaseElement wrapper instance that encapsulates the GStreamer equalizer filter.
GetElement()
Gets the underlying GStreamer element that performs the 10-band equalization processing.
public Element GetElement()Returns
- Element
-
The GStreamer Element instance representing the equalizer 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.
SetBand(int, double)
Sets the gain level for a specific frequency band.
public void SetBand(int id, double value)Parameters
idint-
The band identifier (0-9) corresponding to specific frequencies.
valuedouble-
The gain value in decibels (-24dB to +12dB).
Remarks
Ranging from -24 dB to +12 dB. Band 0: 29 Hz. Band 1: 59 Hz. Band 2: 119 Hz. Band 3: 237 Hz. Band 4: 474 Hz. Band 5: 947 Hz. Band 6: 1889 Hz. Band 7: 3770 Hz. Band 8: 7523 Hz. Band 9: 15011 Hz.
IMediaBlockInternals.SetContext(MediaBlocksPipeline)
Associates this 10-band equalizer 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.