PS1AudioClip¶
An audio resource (not a scene-tree node — a Resource you
reference from PS1Scene.AudioClips). Declares the source .wav
plus which PS1 backend the runtime should route it through.
Where it goes¶
Created as a .tres file under res://, then referenced from a
PS1Scene's AudioClips array. Multiple
scenes can share a single .tres.
Key fields¶
- ClipName — the string Lua passes to play this clip
(
Audio.PlaySfx("door_creak")). - Source — the source
.wavresource. Sample rate gets resampled at import; bit depth gets ADPCM-encoded for SPU clips. - Route —
SPU/XA/CDDA/Auto. SPU is the in-VRAM channel for short clips. XA streams from disc (~minutes-long music, voice acting). CDDA is Red Book audio at the end of the disc (highest quality, fixed track slots). - Residency — when the runtime keeps the clip's bytes loaded:
Always/GameplayOnly/MenuOnly/OnDemand.
Auto route asks the exporter to pick based on size + duration
heuristics — see Audio Routing dock
for what it resolves to.
Workflows¶
- Drop-in import — drop a
.wavinto the FileSystem dock, right-click → New Resource → PS1AudioClip, set the wav as Source. The auto-importer (PS1WavDropHelper) can also create these for you on .wav drops. - Audition — use the Play button in the Audio Routing dock to hear the SPU-encoded version before exporting.
- Volume / pan — runtime parameters on
Audio.PlaySfx, not baked into the clip. The clip holds source bytes; loudness decisions are call-site.
Route status¶
| Route | Implementation |
|---|---|
| SPU | Fully implemented. |
| XA | Scaffolded (runtime logs "not implemented" + falls back to silence). Phase 3 streaming. |
| CDDA | Fully implemented; track number assigned at ISO build. |