XWB files
Generated from engine/audio/xwb_file.h at 0f4f503. The text under each declaration is the header's own comment, word for word. About the reference says how these pages are made.
Audience: game code.
#include "engine/audio/xwb_file.h" · namespace labrador
enum class WaveEncoding
Section titled “enum class WaveEncoding”{ pcm8, pcm16, adpcm};How a wave was stored in its bank. The samples are 16-bit whatever this says; it is kept so that a caller can tell content that was always exact from content that came through a lossy codec.
struct WaveData
Section titled “struct WaveData”One wave out of a bank, decoded to signed 16-bit PCM.
std::string name;The wave's name in the bank's name table, or empty when the bank was packed without one. This engine finds waves by name, so a bank with no table can be read and cannot be resolved against.
encoding
Section titled “encoding”channels
Section titled “channels”int channels = 0;sample_rate
Section titled “sample_rate”int sample_rate = 0;loop_start
Section titled “loop_start”uint32_t loop_start = 0;loop_length
Section titled “loop_length”uint32_t loop_length = 0;The loop region, in frames. A length of zero means the wave carries none, and a looping voice then loops the whole wave.
samples
Section titled “samples”std::vector<int16_t> samples;Interleaved: a frame is channels consecutive samples.
frames
Section titled “frames”size_t frames() const;struct WaveBankData
Section titled “struct WaveBankData”A whole bank: its own name and every wave in it, in the bank's order. The index of a wave here is the index its entry has in the file.
std::string name;read_xwb_file
Section titled “read_xwb_file”Reads the XACT wave bank (.xwb) at path.
THE ENGINE READS IT, NOT A BACKEND, for the reason dds_file.h gives for textures: a reader inside a library that exists for one audio API is the only description of what this engine's sound content is, and every other backend would have to find another reader and hope it agreed. This one is where the format is written down, once, for any backend whose API has no reader of its own. The seam still takes a bank name rather than a file (audio_device.h), so a backend that has a reader may keep it.
EVERYTHING COMES OUT AS SIGNED 16-BIT PCM, WHICH IS WHERE THIS DIFFERS FROM A TEXTURE. TextureData keeps a compressed format compressed because a GPU samples it that way. No audio API this engine is likely to sit on outside Windows plays MS-ADPCM or 8-bit unsigned PCM from a buffer - Web Audio and AAudio take 16-bit or float - so every caller of this reader would decode at once, and decoding here makes that one decoder rather than one per backend. The cost is memory: an ADPCM wave occupies about four times its file size once read, which is stated rather than hidden.
WHAT IT READS: little-endian banks of version 44 with standard (not compact) entries, in-memory or streaming, holding PCM at 8 or 16 bits or MS-ADPCM with the standard seven coefficient pairs - which is what xwbtool -nc writes. Names are read when the bank carries a name table.
WHAT IT REFUSES, EACH BY NAME (T6), and what to do about it: xWMA and XMA entries, which are codecs this engine does not decode; compact entries, which xwbtool -nc does not write; a big-endian (Xbox 360) bank; and an ADPCM entry that does not end on a whole block, which no XAudio2 voice can play either. Seek tables exist only for xWMA and are not read.
Throws std::out_of_range naming the path if there is no file there, and std::runtime_error naming the path AND what is wrong with it otherwise, including the index and name of the entry when one entry is at fault.
In the samples and tests
Section titled “In the samples and tests”The files that include this header directly. A file can also reach it through another header.
tests/audio/xwb_file_tests.cpp
Explained in
Section titled “Explained in”No guide or concept page links to this header yet.
Documentation for Labrador v0.3.0. Built from Labrador 0f4f503 of 2026-11-03.