nihstro is a collection of tools for 3DS shaders targeted at homebrew development and/or reverse engineering. Currently, it supports assembling 3DS shader binaries from assembly source code and disassembling shaders from shbin files. It also provides C++ interfaces for analyzing and runtime-compiling shaders.

This project is released under a three-clause BSD license. For details see license.txt.

nihstro is well-modularized to minimize dependencies for any particular use case.

nihstro includes a standalone shader assembler for generating SHBIN files from human-readable shader source code (the syntax of which is called "nihcode"). It is perfectly suitable for homebrew development. Shader source needs to follow the nihcode specification.

Usage: nihstro-assemble <output_filename.shbin> <input_filename.vsh>

Reads vertex shader source code from the input file and generates a shader binary from it.

nihstro includes a standalone shader disassembler for disassembling SHBIN files and inspecting meta data (symbol information, constant values, etc).

Usage: nihstro-disassemble <filename.shbin>

Parses the shader binary header and outputs basic information on the DVLE sections.

nihstro-disassemble <filename.shbin> <DVLE index>

Parses the shader binary header and outputs basic information, but also disassembles the shader code using the information in the indexed DVLE (main offset, symbols, etc).

The header shader_bytecode.h defines C++ data structures which describe raw shader binary code, while shader_binary.h defines the layout of SHBIN files. This allows for convenient inspection of data in C++ code. Note that these headers are currently not API stable.

The header inline_assembly.h provides an experimental mean for runtime generation of PICA200 shaders and SHBIN files within C++ code, so that homebrew authors don't need to ship shaders as precompiled files. While you could use nihstro's actual assembler to allow for runtime shader compilation, the inline assembler may be more convenient and is lighter on dependencies (since it doesn't require Boost to function). However, for obvious reasons it incurs a performance penalty and an increased memory usage compared to offline shader compilation.

A simple example program is included to illustrate how to use the inline assembler.

Note that the inline assembler is highly experimental. It may or may not work for you yet, and its API will change a lot in the future.

All nihstro components require compiler support for C++11 to work.

The C++ headers shader_bytecode.h and shader_binary can be easily be included in other project and hence are easy to integrate into any build system as long as nihstro's directory structure is preserved.

For the standalone assembler and disassembler, you will also need CMake to generate build files, however it is simple to setup a different build system from scratch if need be. If you want to use the standalone assembler, you will need to have at least parts of the Boost libraries installed (including Spirit, Fusion, and others).

I welcome any contributions! Just create a GitHub fork and submit your changes back via pull requests.

A big "thank you!" to everyone who contributed to the information on 3dbrew, which has proven amazingly useful for my 3DS related projects. Another shout-out goes to smealum's aemstro, which served as a great reference when debugging nihstro.