diff --git a/emulator/pod-launch/Options.cs b/emulator/pod-launch/Options.cs index 962a42e..034c0e6 100644 --- a/emulator/pod-launch/Options.cs +++ b/emulator/pod-launch/Options.cs @@ -160,7 +160,9 @@ namespace VwePod --bridge-size w,h main render window size (default 800,600) --dosbox-xy x,y DOSBox window position + focus (default 10,10) --no-bridge pod only, no GL render window - --no-sound skip the ~4-min SoundFont upload + --no-sound skip the ~4-min SoundFont upload. WARNING: no AWE32 = + no SOS ticks; bt/rp FREEZE at RIO init on the default + FAST-clock confs (only safe with a SLOW-clock conf) --mipmap VRVIEW_MIPMAP=1 (RP floor shimmer fix; non-authentic) --no-focus skip the window layout/focus pass --dry-run resolve paths + print the launch plan, then exit"); diff --git a/emulator/pod-launch/Program.cs b/emulator/pod-launch/Program.cs index 207e856..b282d0c 100644 --- a/emulator/pod-launch/Program.cs +++ b/emulator/pod-launch/Program.cs @@ -93,6 +93,11 @@ namespace VwePod Console.WriteLine($"pod PID {dosbox.Id} conf={Path.GetFileName(opt.Conf)} work={opt.Work}"); if (!opt.NoSound) Console.WriteLine("sound ON: boot adds ~4 min for the SoundFont upload"); + else + Console.WriteLine( + "WARNING: --no-sound removes the AWE32, and BT/RP's FAST SOS clock is\n" + + " sound-driven -- the game FREEZES at RIO init (Now() never ticks).\n" + + " Use only with a conf that selects the SLOW clock (setenv arg2=s)."); // ---- Render bridge (Dave's GL): also into the job. ---- if (!opt.NoBridge) diff --git a/emulator/pod-launch/README.md b/emulator/pod-launch/README.md index aacc7ef..5bf8525 100644 --- a/emulator/pod-launch/README.md +++ b/emulator/pod-launch/README.md @@ -43,8 +43,7 @@ dotnet publish -c Release -r win-x64 --self-contained true -p:PublishSingleFile= `pod-launch [mode] [options]` — the single installed entry-point. The product is installed once; the console activates features by the args it passes. The per-rig -layout is fixed at `postinstall` time, so a typical call is just `pod-launch bt` -(± `--no-sound`). +layout is fixed at `postinstall` time, so a typical call is just `pod-launch bt`. ### Mode — the primary feature selector (positional, or `--mode `) @@ -65,7 +64,7 @@ see `../CAMERA-REVIEW-NOTES.md`. Default mode: `bt`. | Arg | Effect | |---|---| -| `--no-sound` | skip the ~4-min AWE32 SoundFont upload (fast boot, no audio) | +| `--no-sound` | skip the ~4-min AWE32 SoundFont upload — **freezes bt/rp**: no AWE32 = no SOS ticks, and the default confs use the FAST (SOS) clock, so BTL4 hangs in the RIO-reset busy-wait (`L4RIO.cpp` `SetDTR`/`Now()`; root-caused 2026-07-10). Only safe with a SLOW-clock conf (`setenv` arg2=`s`) | | `--mipmap` | mip-filter minified textures (fixes RP floor shimmer; non-authentic) | | `--layout cockpit\|explode` | `cockpit` = borderless VDB head windows (default); `explode` = 7-window debug | | `--no-bridge` | pod only, no GL render window |