Table of Contents

Class DSReverbAudioEffect

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

DirectSound I3DL2 (Interactive 3D Audio Level 2) Reverb effect simulates environmental reverberation with comprehensive room acoustics modeling, including early reflections, diffusion, and decay characteristics.

public class DSReverbAudioEffect : BaseAudioEffect, ISharedAudioEffectX

Inheritance

Implements

Inherited Members

Remarks

Platform: Windows only (DirectX/DirectSound DSP)

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

Effect Type: Spatial/Reverb

The I3DL2 reverb is a professional-quality environmental reverb algorithm that models realistic room acoustics with separate control over early reflections and late reverberation. Supports preset-based configuration for common acoustic environments or detailed manual parameter adjustment.

Typical Applications:

  • Simulating room acoustics (small room to large hall)
  • Adding depth and space to vocals and instruments
  • Creating environmental audio for games and multimedia
  • Professional music production and mixing

Parameters:

  • Room: -10000 to 0 mB - Master room gain (attenuation)
  • RoomHF: -10000 to 0 mB - High-frequency room gain
  • DecayTime: 0.1-20.0 seconds - Reverberation decay time
  • DecayHFRatio: 0.1-2.0 - Ratio of high-frequency to full-spectrum decay time
  • Reflections: -10000 to 1000 mB - Early reflections level
  • ReflectionsDelay: 0.0-0.3 seconds - Delay before early reflections
  • ReverbValue: -10000 to 2000 mB - Late reverberation level
  • ReverbDelay: 0.0-0.1 seconds - Delay before late reverberation
  • Diffusion: 0-100% - Echo density in late reverberation
  • Density: 0-100% - Modal density in late reverberation
  • HFReference: 20-20000 Hz - Reference high-frequency cutoff
  • Quality: 0-3 - Processing quality (0=low, 3=high)
  • RoomRollOffFactor: 0.0-10.0 - Distance-based attenuation factor
  • Preset: Predefined acoustic environments (Room, Hall, Cathedral, etc.)

Cross-Platform Alternative: Use ReverberationAudioEffect for cross-platform Freeverb-based reverb.

Constructors

DSReverbAudioEffect()

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

public DSReverbAudioEffect()

Properties

DecayHFRatio

Gets or sets the decay HF ratio for the filter (0.1 - 2.0, 0.83 by default).

public float DecayHFRatio { get; set; }

Property Value

float

DecayTime

Gets or sets the decay time for the filter (0.1 - 20.0, 1.49 by default).

public float DecayTime { get; set; }

Property Value

float

Density

Gets or sets the density value for the filter (0 - 100.0, 100.0 by default).

public float Density { get; set; }

Property Value

float

Diffusion

Gets or sets the diffusion value for the filter (0 - 100.0, 100.0 by default).

public float Diffusion { get; set; }

Property Value

float

HFReference

Gets or sets the HF reference for the filter (20.0 - 20000.0, 5000.0 by default).

public float HFReference { get; set; }

Property Value

float

Preset

Gets or sets the preset name.

public DSI3DL2ReverbPreset Preset { get; set; }

Property Value

DSI3DL2ReverbPreset

Quality

Gets or sets the quality of the filter (0 - 3, 2 by default).

public int Quality { get; set; }

Property Value

int

Reflections

Gets or sets the reflections value for the filter (-10000 - -1000, -2602 by default).

public int Reflections { get; set; }

Property Value

int

ReflectionsDelay

Gets or sets the reflections delay for the filter (0.0 - 0.3, 0.007 by default).

public float ReflectionsDelay { get; set; }

Property Value

float

ReverbDelay

Gets or sets the reverb delay for the filter (0.0 - 0.1, 0.011 by default).

public float ReverbDelay { get; set; }

Property Value

float

ReverbValue

Gets or sets the reverb value for the filter (-10000 - 2000, 200 by default).

public int ReverbValue { get; set; }

Property Value

int

Room

Gets or sets the room value for the filter (-10000 - 0, -1000 by default).

public int Room { get; set; }

Property Value

int

RoomHF

Gets or sets the room HF value of the filter (-10000 - 0, -100 by default).

public int RoomHF { get; set; }

Property Value

int

RoomRollOffFactor

Gets or sets the room roll off factor for the filter (0.0 - 10.0, 0.0 by default).

public int RoomRollOffFactor { get; set; }

Property Value

int