-----
apicula can rip, view, and convert the [NSBMD model
files](https://github.com/scurest/apicula/wiki/FILETYPES) found in many Nintendo
DS games.
* [Tutorial](https://github.com/scurest/apicula/wiki/TUTORIAL)
* [Hallow's tutorial on VG Resource](https://www.vg-resource.com/thread-32332.html)
* [Common Blender issues](https://github.com/scurest/apicula/wiki/IMPORT:-Blender)
* [Programmer's documentation on .nsbXX files](https://raw.githubusercontent.com/scurest/nsbmd_docs/master/nsbmd_docs.txt)
### Compatibility
apicula recognized these file types (called Nitro files). See [the
wiki](https://github.com/scurest/apicula/wiki/FILETYPES) for more info.
* `.nsbmd`, `.BMD`, or `.BMD0`: 3D models, textures, palettes
* `.nsbtx`, `.BTX`, or `.BTX0`: textures, palettes
* `.nsbca`, `.BCA`, or `.BCA0`: joint animations
* `.nsbtp`, `.BTP`, or `.BTP0`: pattern animations (flipbook-type)
* `.nsbta`, `.BTA`, or `.BTA0`: material animations (experimental!!)
Models can be converted to COLLADA or glTF.
Pattern animations are supported in the viewer and extractor, but not in the
converter (neither COLLADA nor glTF support animations that change a material's
textures).
Material animations are supported in the viewer and extractor, but not in the
converter.
Importing apicula's COLLADA files has been tested in Blender and Maya.
### Downloads
* [Download for Windows, 64-bit](https://github.com/scurest/apicula/releases/download/continuous/apicula-latest-windows.zip)
This is built automatically off the latest `master`. You may need one of the Visual Studio
Redistributable packages installed.
### Building
Make sure [Rust (1.34+) is installed](https://rustup.rs/) and [build the usual
way](https://doc.rust-lang.org/cargo/guide/working-on-an-existing-project.html)
$ git clone https://github.com/scurest/apicula.git
$ cd apicula
$ cargo b --release
$ target/release/apicula -V
### Usage
To search a ROM (or any other file) for Nitro files and extract them
apicula extract -o