Table of Contents

Class DSDistortionAudioEffect

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

DirectSound Distortion effect adds harmonics to the signal by clipping and squaring off the waveform peaks, creating overdrive and distortion effects commonly used for guitar and creative sound design.

public class DSDistortionAudioEffect : BaseAudioEffect, ISharedAudioEffectX

Inheritance

Implements

Inherited Members

Remarks

Platform: Windows only (DirectX/DirectSound DSP)

Available in: Classic SDKs (VideoCaptureCore, MediaPlayerCore, VideoEditCore)

Effect Type: Harmonic/Dynamic

The distortion effect simulates analog overdrive by clipping signal peaks, adding harmonics and overtones that weren't present in the original signal. Includes pre-lowpass filter and post-EQ for tone shaping.

Typical Applications:

  • Electric guitar overdrive and distortion effects
  • Creative vocal processing
  • Adding grit and character to synthesizers
  • Lo-fi and retro sound design

Parameters:

  • Edge: 0-100% - Amount of distortion/clipping intensity
  • Gain: -60 to 0 dB - Input gain (pre-distortion amplification)
  • PostEQCenterFrequency: 100-8000 Hz - Center frequency of post-distortion EQ
  • PostEQBandwidth: 100-8000 Hz - Bandwidth of post-distortion EQ
  • PreLowpassCutOff: 100-8000 Hz - Pre-distortion low-pass filter cutoff frequency

Usage Tip: Use PreLowpassCutOff to control brightness before distortion, and PostEQ to shape tone after distortion.

Note: No direct cross-platform equivalent available in Media Blocks SDK.

Constructors

DSDistortionAudioEffect(float, float, float, float, float)

Initializes a new instance of the VisioForge.Core.Types.X.AudioEffects.DSDistortionAudioEffect class.

public DSDistortionAudioEffect(float edge, float gain, float postEQBandwidth, float postEQCenterFrequency, float preLowpassCutOff)

Parameters

edge float

Specifies the edge of the filter (0.0 - 100.0).

gain float

Specifies the gain of the filter (-60.0 - 0).

postEQBandwidth float

Specifies the bandwidth of the equalizer (100.0 - 8000.0).

postEQCenterFrequency float

Specifies the center frequency of the distortion equalizer (100.0 - 8000.0).

preLowpassCutOff float

Specifies the low pass cutoff of the filter (100.0 - 8000.0).

Properties

Edge

Gets or sets edge.

public float Edge { get; set; }

Property Value

float

Gain

Gets or sets gain.

public float Gain { get; set; }

Property Value

float

PostEQBandwidth

Gets or sets post EQ bandwidth.

public float PostEQBandwidth { get; set; }

Property Value

float

PostEQCenterFrequency

Gets or sets post EQ center frequency.

public float PostEQCenterFrequency { get; set; }

Property Value

float

PreLowpassCutOff

Gets or sets pre-lowpass cut-off frequency.

public float PreLowpassCutOff { get; set; }

Property Value

float