This crate provides functionality for decoding & encoding (Open)NoteBlockStudio buffers. It supports the original NBS format, aswell as version 1-4 of the unofficial new format introduced in OpenNoteBlockStudio. Documentation on the NBS format can be found at NoteBlockStudio and OpenNoteBlockStudio.
```rust use nbs::{ noteblocks::{instrument, note::Note}, Nbs, }; use std::fs::File;
fn main() {
let mut file = File::open("tests/1.nbs").unwrap();
let mut nbs = Nbs::decode(&mut file).unwrap();
nbs.noteblocks.layers[2].name = String::from("Cows"); // Renaming the 3rd layer "Cows".
nbs.noteblocks.layers[2].volume = 25; // Setting its volume to 25%.
// Insert a Note in the 3rd layer at tick 0
nbs.noteblocks.layers[2].notes.insert(
0,
Note::new(instrument::COW_BELL, 33, Some(100), Some(100), Some(0)),
);
// Write the changes to out1.nbs.
nbs.encode(&mut File::create("out1.nbs").unwrap()).unwrap();
}
```
```rust use nbs::{ header::Header, noteblocks::{instrument, instrument::CustomInstruments, layer::Layer, note::Note, NoteBlocks}, Nbs, NbsFormat, }; use std::fs::File;
fn main() {
let mut file = File::create("out2.nbs").unwrap();
let mut header = Header::new(NbsFormat::OpenNoteBlockStudio(4)); // Create a header.
header.songname = String::from("test"); // Change the name to test.
let mut noteblocks = NoteBlocks::new();
// Create a new Layer.
noteblocks
.layers
.push(Layer::fromformat(NbsFormat::OpenNoteBlockStudio(4)));
// Insert 20 notes into the first layer
for i in 0..20 {
noteblocks.layers[0].notes.insert(
i,
Note::new(
instrument::PIANO,
(33 + i) as i8,
Some(100),
Some(100),
Some(0),
),
);
}
let custominstruments = CustomInstruments::new(); // Create a empty list of custom instruments.
let mut nbs = Nbs::fromcomponets(header, noteblocks, custom_instruments); // Assamble everything together.
nbs.update(); // Update certian fields in the header to match the rest of the file.
nbs.encode(&mut file); // save!
}
```