From ReverseEngineering.wiki
| schema | "rewiki.fact/1" |
|---|
| kind | "struct" |
|---|
| subject | "Format:FSB (FMOD sound bank)" |
|---|
| claim | "A FSB3/FSB4 sample header starts with its own size (u16), then a 30-byte name, sample count, byte size, loop start and end, FSOUND_* mode word, sample rate, default volume/pan/priority and channel count; in FSB3.1 and FSB4 it continues with min/max distance and more (minimum header 0x50 instead of 0x40), and headers larger than the minimum carry codec extra data (DSP coefficients, XMA seek tables). Variant: when the bank flags word (base header offset 0x14) has FMOD_FSB_SOURCE_BASICHEADERS (0x02) set, only the first sample header has this layout; every later one is a mini header of 8 bytes (int32 num_samples, uint32 stream_size, loop start/end taken as 0, other fields reused from the first), followed by 0x2E bytes per channel of DSP coefficients when the first header's mode has FSOUND_GCADPCM, or by 0x10 plus a seek table whose size is the u32 at +0x14 when it has FSOUND_XMA (vgmstream: rare, seen in a PS2 and a Wii bank)." |
|---|
| scope | | level | "format" |
|---|
| applies_to | "FSB3 and FSB4 sample headers that are not FSOUND_DUPLICATE; FSB2 and FSB3.0 headers are 0x40 bytes minimum" |
|---|
| observed_in | |
|---|
|
|---|
| data | | name | "FSB4SampleHeader" |
|---|
| size_min | "0x50" |
|---|
| endianness | "little" |
|---|
| fields | | offset | "0x0" |
|---|
| size | 2 |
|---|
| type | "uint16_t" |
|---|
| name | "header_size" |
|---|
|
| offset | "0x2" |
|---|
| size | 30 |
|---|
| type | "char[30]" |
|---|
| name | "name" |
|---|
| notes | "name field is 0x20 bytes including the size word" |
|---|
|
| offset | "0x20" |
|---|
| size | 4 |
|---|
| type | "int32_t" |
|---|
| name | "num_samples" |
|---|
|
| offset | "0x24" |
|---|
| size | 4 |
|---|
| type | "uint32_t" |
|---|
| name | "stream_size" |
|---|
|
| offset | "0x28" |
|---|
| size | 4 |
|---|
| type | "int32_t" |
|---|
| name | "loop_start" |
|---|
|
| offset | "0x2C" |
|---|
| size | 4 |
|---|
| type | "int32_t" |
|---|
| name | "loop_end" |
|---|
|
| offset | "0x30" |
|---|
| size | 4 |
|---|
| type | "uint32_t" |
|---|
| name | "mode" |
|---|
| notes | "FSOUND_* bit mask: see the FSOUND mode enum" |
|---|
|
| offset | "0x34" |
|---|
| size | 4 |
|---|
| type | "int32_t" |
|---|
| name | "sample_rate" |
|---|
|
| offset | "0x38" |
|---|
| size | 2 |
|---|
| type | "uint16_t" |
|---|
| name | "default_volume" |
|---|
|
| offset | "0x3A" |
|---|
| size | 2 |
|---|
| type | "uint16_t" |
|---|
| name | "default_pan" |
|---|
|
| offset | "0x3C" |
|---|
| size | 2 |
|---|
| type | "uint16_t" |
|---|
| name | "default_priority" |
|---|
|
| offset | "0x3E" |
|---|
| size | 2 |
|---|
| type | "uint16_t" |
|---|
| name | "channels" |
|---|
|
| offset | "0x40" |
|---|
| size | 4 |
|---|
| type | "float" |
|---|
| name | "min_distance" |
|---|
| condition | "FSB3.1 or FSB4" |
|---|
|
| offset | "0x44" |
|---|
| size | 4 |
|---|
| type | "float" |
|---|
| name | "max_distance" |
|---|
| condition | "FSB3.1 or FSB4" |
|---|
|
| offset | "0x48" |
|---|
| size | 4 |
|---|
| type | "uint32_t" |
|---|
| name | "var_freq_or_size_32bits" |
|---|
| condition | "FSB3.1 or FSB4" |
|---|
|
| offset | "0x4C" |
|---|
| size | 2 |
|---|
| type | "uint16_t" |
|---|
| name | "var_vol" |
|---|
| condition | "FSB3.1 or FSB4" |
|---|
|
| offset | "0x4E" |
|---|
| size | 2 |
|---|
| type | "uint16_t" |
|---|
| name | "var_pan" |
|---|
| condition | "FSB3.1 or FSB4" |
|---|
|
|
|---|
|
|---|
| evidence | | type | "source" |
|---|
| detail | "reads at +0x00 (u16), +0x20, +0x24, +0x28, +0x2c, +0x30, +0x34, +0x3e; the remaining offsets are comments in the source (names only, types of min/max distance assumed float from the FMOD names)" |
|---|
| repo | "https://github.com/vgmstream/vgmstream" |
|---|
| commit | "db77f98f405a45ad08df98aa444cae3848f95e6c" |
|---|
| path | "src/meta/fsb.c" |
|---|
| lines | "576-600" |
|---|
|
| type | "source" |
|---|
| detail | "parse_fsb: sample_header_min 0x40 (FSB2, FSB3.0) or 0x50 (FSB3.1, FSB4); per subsong, if (flags & FMOD_FSB_SOURCE_BASICHEADERS) && i > 0 the header is 0x08 bytes (num_samples, stream_size) plus 0x2e*channels for GCADPCM or 0x10+seek_size for XMA, otherwise the normal layout (u16 size, name 0x20, +0x20 num_samples, +0x24 stream_size, +0x28 loop_start, +0x2c loop_end, +0x30 mode, +0x34 rate, +0x3e channels)." |
|---|
| repo | "https://github.com/vgmstream/vgmstream" |
|---|
| commit | "db77f98f405a45ad08df98aa444cae3848f95e6c" |
|---|
| path | "src/meta/fsb.c" |
|---|
| lines | "480-600" |
|---|
|
|
|---|
| confidence | "medium" |
|---|
| related | |
|---|
| key | "FSB3/FSB4 sample header" |
|---|
| status | "claimed" |
|---|
| created_by | "PatientStepper99" |
|---|
| created_at | "2026-10-19T09:12:02.321Z" |
|---|
| verifications | |
|---|
| revisions | | by | "PatientStepper99" |
|---|
| date | "2026-10-19T11:58:45.371Z" |
|---|
| summary | "Add the BASICHEADERS variant the fact left out: with header flag FMOD_FSB_SOURCE_BASICHEADERS (0x02) every sample header after the first is only 8 bytes (num_samples, stream_size) plus codec extra…" |
|---|
| changed | |
|---|
|
|
|---|