Method StartEAXPreview

engine/PoseidonOpenAL/SoundSystemOAL.cpp:1006–1052

    _previewCategory.Free();
    // _previewDevice is also cut so a focus-leave from the Output Device
    // row stops audio.  Reset the anchor — re-focusing and re-clicking
    // starts a brand new wall-clock-tracked session from offset 0.
    _previewDevice.Free();
    _devicePreviewAnchorMs = 0;
    _devicePreviewLengthSec = 0.0f;
    _previewEax.Free();
    _doPreview = false;
    LOG_DEBUG(Audio, "TerminatePreview");
}

void SoundSystemOAL::StartEAXPreview()
{
    if (!_enablePreview)
        return;

    // Cut anything else; this is a focused A/B test where the user
    // toggles EAX on/off.
    _previewSpeech.Free();
    _previewEffect.Free();
    _previewMusic.Free();
    _previewCategory.Free();
    _previewDevice.Free();
    _previewEax.Free();
    _doPreview = false;

    // Use one of the environments the game actually exposes at
    // runtime (SoundSystemOAL::ApplyEFXPreset maps SEPlain / SEForest /
    // SECity / SEMountains / SERoom — that's the full set of reverbs
    // shipping in stock missions).  SERoom is the most audibly distinct
    // from the default outdoor SEPlain so the on/off diff is obvious;
    // toggling EAX off plays the sample dry, which is exactly the
    // contrast we want the user to hear.
    if (_canEAX && _eaxEnabled)
        SetEnvironment(SoundEnvironment{SERoom, 1.9f, 0.5f});

    const ParamEntry& cfg = Pars >> "CfgSFX" >> "Preview" >> "effect";
    RStringB name = cfg[0];
    IWave* wave = CreateWave(name, true, false);
    _previewEax = wave;
    if (!wave)
    {
        LOG_WARN(Audio, "StartEAXPreview: failed to create wave '{}'", static_cast<const char*>(name));
        return;
    }
    wave->SetKind(WaveEffect);
    wave->EnableAccommodation(false);
    wave->SetSticky(true);
    wave->SetVolume((float)cfg[1], cfg[2], true);
    // 3D position close to the listener so the effect's reverb tail
    // is fully audible (the EFX send is per-source distance-attenuated;