Method Load

engine/PoseidonOpenAL/WaveOAL.cpp:711–742

    // before decode completes.
    LOG_DEBUG(Audio, "WaveOAL::KickAsyncLoad async-dispatch: {} ({} bytes)",
              static_cast<const char*>(Name()), _state.size);
    AddRef();
    pool->Submit([this]()
    {
        DecodePcm();
        Release();
    });
}

void WaveOAL::Load()
{
    if (!_stream || _loaded || _loadError)
        return;

    // Phase A measurement.  `WaveOAL::Load` is the dominant cause of
    // the first-touch hitch in the demo intro (full Vorbis decode of
    // a music track lands here synchronously on the main thread).
    // Phase 3c split this into Decode (worker-safe) + Upload (main-
    // thread).  This wrapper preserves the synchronous contract so
    // the lazy-load-on-DoPlay call site keeps working unchanged.
    // Phase 3d will route around this wrapper to dispatch Decode
    // asynchronously while leaving Upload synchronous on Commit.
    const auto _perfLoadStart = ::Poseidon::Dev::Perf::Now();

    DecodePcm();
    if (_loadError)
    {
        return;
    }
    UploadAlBuffer();
    if (_loadError)
    {
        return;
    }