XbadPCM

Safe (and optionally no-std) Rust crate for encoding and decoding Xbox ADPCM blocks.

Decoding example

Here is example code for decoding stereo audio.

```rust use xbadpcm::{XboxADPCMDecoder, XboxADPCMDecodeSink};

let adpcmdata = readsomeadpcmblocks(); let mut output = [Vec::new(), Vec::new()];

// Two channels let mut encoder = XboxADPCMDecoder::new(2, &mut output);

// Decode encoder.decode(&adpcm_data).unwrap();

assert!(!output[0].is_empty() && output[0].len() == output[1].len()); ```

Encoding example

Here is example code for encoding stereo audio.

```rust use xbadpcm::{XboxADPCMEncoder, XboxADPCMEncodeSink};

let (leftchannel, rightchannel) = readsomepcm_samples(); let mut output = Vec::new();

// Two channels with a lookahead of three samples let mut encoder = XboxADPCMEncoder::new(2, 3, &mut output);

// Encode encoder.encode(&[&leftchannel, &rightchannel]).unwrap();

// Finish encoding encoder.finish().unwrap();

assert!(!output.is_empty()); ```

No-std support

The crate is fully functional without the Rust Standard Library, but it is enabled automatically to provide traits for XboxADPCMEncodeSink and XboxADPCMDecodeSink on vectors.

To disable using the standard library, put default-features = false in the dependency declaration in your Cargo.toml. See Features - The Cargo Book for more information.

Acknowledgements

The encoder is based off of David Bryant's ADPCM-XQ encoder, an IMA-ADPCM encoder which can be found on GitHub at dbry/adpcm-xq.