Skip to content

Clarify the ADP stream length with an example #134

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
rdw-software merged 1 commit into from
Aug 1, 2025
Merged

Clarify the ADP stream length with an example #134

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 11 additions & 1 deletion docs/arcturus/ADP.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,17 @@ How many channels can be found in the ADPCM-encoded audio stream. Always `2` (fo

#### AudioStreamSizeInBytes

How many bytes can be extracted from the ADPCM-encoded audio stream. Represents the distance until `EOF`.
How many samples can be extracted from the ADPCM-encoded audio stream per channel. Here's an example:

- File: `002.adp`
- `NumInterleavedAudioChannels`: 2
- `AudioStreamSizeInBytes`: `5,232,022` bytes (hexadecimal: `96 D5 4F 00`)
- Total file size: `2,616,027` bytes
- ADPCM stream length: `2,616,027 - 16 = 2,616,011` (subtract `StartingOffset`)
- Distance to end of file: `AudioStreamSizeInBytes / NumInterleavedAudioChannels = 5,232,022 / 2 = 2,616,011`
- Space needed to store the result: `AudioStreamSizeInBytes` per channel (`sizeof(int16_t) = 2` bytes per sample)

The entire stream will have been consumed once you extract `2,616,011` bytes. There should be no leftover bytes.

#### Compressed Audio Stream

Expand Down
Loading