scurest/apicula
1
Fork 0
mirror of https://github.com/scurest/apicula.git synced 2025-06-18 22:55:33 -04:00
Code Issues Actions Packages Projects Releases Wiki Activity
Convert Nintendo DS .nsbmd models
141 Commits 2 Branches 1 Tag 4.2 MiB
Rust 99.6%
GLSL 0.4%
05e2dd047f
Go to file
scurest 05e2dd047f Switch to 0BSD
2019-01-11 17:01:22 -06:00
src Refactor texture decoding 2019-01-10 21:23:03 -06:00
.editorconfig Update README 2018-03-10 14:47:35 -06:00
.gitignore It works! Commit it 2016-12-11 15:14:07 -06:00
appveyor.yml (build) Fix version number in AppVeyor builds 2017-04-16 12:37:03 -05:00
build.rs Include compile date in version info 2018-02-23 12:21:35 -06:00
BUILDING.md Update README 2018-03-10 14:47:35 -06:00
Cargo.lock Rewrite skeleton module. 2019-01-10 16:44:39 -06:00
Cargo.toml Switch to 0BSD 2019-01-11 17:01:22 -06:00
frontispiece.gif Update README 2018-03-10 14:47:35 -06:00
LICENSE Switch to 0BSD 2019-01-11 17:01:22 -06:00
README.md Switch to 0BSD 2019-01-11 17:01:22 -06:00

README.md

apicula

Build status Lines of code

Convert Nintendo DS models and animations to COLLADA.

The Nitro file formats were the formats for Nintendo's SDK for DS game developers and were used by many DS games. This tool is for dealing with Nitro models (NSBMD files), viewing them, and converting them to COLLADA .dae files. There is also support for loading textures (NSBTX) and animations (NSBCA).

Ore ga Omae o Mamoru model imported into Blender

Downloads

Pre-built binaries are provided for Windows:

These are built automatically off the latest master. You may need one of the Visual Studio Redistributable packages installed.

Building

Building is done in the usual way for Rust projects. See BUILDING.md.

Usage

To view a set of models

apicula view <NITRO FILES>

To convert a set of models to COLLADA, placing the generated files in the given directory

apicula convert <NITRO FILES> -o <OUTPUT DIR>

To extract Nitro files from a ROM or other packed file, placing extracted files in the given directory

apicula extract <INPUT FILE> -o <OUTPUT DIR>

To get technical information about the given Nitro files

apicula info <NITRO FILES>

To receive help

apicula help

See also the tutorial on the process of extracting Nitro files from a ROM image and using apicula to convert them to COLLADA.

Compatibility

apicula was primarily tested with Nitro files from the following games

  • Kingdom Hearts: 358/2 Days
  • Ore ga Omae o Mamoru
  • Rune Factory 3: A Fantasy Harvest Moon

Importing the COLLADA files we generate has been tested in the following programs:

  • Blender
  • Godot

If you can test in others (Maya, 3DS Max), that would be appreciated :)

Special Thanks

  • kiwi.ds, for models and documentation for Nitro formats. All NDS model viewers seem to be derived from this one. Now defunct.

  • Gericom and MKDS Course Modifier, for animation information, especially for the meaning of the basis rotations.

  • Lowlines and Console Tool, for animations and documentation for Nitro formats. I also use Console Tool for extracting files from DS ROMs.

  • GBATEK, for DS hardware documentation.

  • deSmuME, for the DS debugger. _3D_LOG_EXEC and the GDB stub were invaluable.

License

0BSD