Method WaveOAL

engine/PoseidonOpenAL/WaveOAL.cpp:28–87

}

WaveOAL::WaveOAL(SoundSystemOAL* sys, RString name, bool is3D) : IWave(name), _sys(sys), _is3D(is3D), _createdAs3D(is3D)
{
    // Match DX8 WaveBuffers8::Reset() — initialize _volumeAdjust from current mixer state
    _volumeAdjust = _sys->_volumeAdjustEffect;

    // Phase A measurement: file-open + decoder-init cost (the
    // `SoundLoadFile` → `ov_open_callbacks` path for OGG; the
    // equivalent header parse for WAV/WSS).  Split out from the
    // bigger `WaveOAL::Load` decode so we can see open vs full-decode
    // separately.  Threshold filters voice-line noise.
    const auto _perfOpenStart = ::Poseidon::Dev::Perf::Now();

    const char* nameStr = static_cast<const char*>(name);
    if (!nameStr || !nameStr[0])
    {
        // Empty sound name — a config slot with no sound assigned (common for
        // some weapons/vehicles). Nothing to load; not an error. Logging it trips
        // --strict during mass combat where many such slots are touched.
        _loadError = true;
        return;
    }
    _stream = SoundLoadFile(nameStr);
    if (!_stream)
    {
        _loadError = true;
        LOG_ERROR(Audio, "Load failed: '{}' (file not found or unsupported format)", nameStr);
        return;
    }
    LoadHeader();

    // Phase 3g: route OGG sources through the chunked streaming
    // path.  Case-insensitive .ogg suffix is the cheap test that
    // catches every music + voice OGG asset in the demo and the
    // full game.  WSS / WAV stay on the Phase 3c/3d full-decode
    // path because they're small and decode fast — streaming
    // would add a frame of playback latency without a perceptual
    // win.
    const char* n = static_cast<const char*>(name);
    if (const size_t nlen = n ? std::strlen(n) : 0; nlen >= 4)
    {
        const char* ext = n + nlen - 4;
        if ((ext[0] == '.' || ext[0] == 0) &&
            (ext[1] == 'o' || ext[1] == 'O') &&
            (ext[2] == 'g' || ext[2] == 'G') &&
            (ext[3] == 'g' || ext[3] == 'G'))
        {
            _isStreamed = true;
        }
    }

    _sys->RegisterWave(this);

    const double _perfOpenMs = ::Poseidon::Dev::Perf::ElapsedMs(_perfOpenStart);
    if (_perfOpenMs >= 1.0)
    {
        LOG_DEBUG(Audio, "PERF: WaveOAL::Open {} took {:.2f}ms", static_cast<const char*>(name), _perfOpenMs);
    }
    ::Poseidon::Dev::Perf::EmitTraceEventAsset(Poseidon::Foundation::LogCategory::Audio, "WaveOAL::Open", _perfOpenStart,