rsnbs

一个简单的 Rust 库，用于读取和写入来自 Open Note Block Studio 的 .nbs 文件。

rsnbs 具有与 pynbs 相同的所有功能，例如迭代 Note Block Studio 歌曲

use rsnbs::read_nbs;

let song = read_nbs("song.nbs");
for note in song.notes {
  println!("tick: {}, instrument: {}", note.tick.unwrap(), note.instrument.unwrap())
}

或通过编程生成新歌曲

use rsnbs::{Song, Note};

let song = Song::default();
for i in 0..10 {
  Song.notes.push(Note {
    tick: Some(i), layer: None, instrument: None,
    velocity: 30, panning: None, pitch: None, key: Some(i+35)
  })
}

主要区别在于每个字段都是一个选项（为了版本差异起见），其中 None 作为 0/""。

安装

可以使用 cargo 安装此软件包

$ cargo install rsnbs

读取 / 写入

您可以使用 read_nbs 函数读取并解析任何版本的特定 NBS 文件。

  let song = rsnbs::read_nbs("song.nbs");

这返回一个 rsnbs::Song 对象，然后可以使用 Song::save 来写入

  song.save("song.nbs", version);

Song 结构体

Song 实现了 Default 特性，因此您可以创建一个默认实例，具有 1 层和所有 None 字段

  let song = Song::default();

字段

头部

第一个字段是 header，文件头部，类型为结构体 Header

笔记

notes字段按照顺序存储了所有类型的struct Note笔记。

层

layers字段是按照顺序存储的所有层的struct Layer的vec。

乐器

instruments字段按照顺序存储了歌曲中的所有自定义乐器，在一个vec中。