inochi2d-parser 0.2.2

✦ Inochi2D Parser

Typed parser and intermediate representation (IR) of the Inochi2D format for INP / INX files, written in Rust.

This crate transforms Inochi2D JSON files into safe, typed Rust structures ready for consumption.

✦ Features

Support for the main blocks of the format:

✦ Puppet
✦ Nodes
✦ Parameters
✦ Animation
✦ Groups
✦ Vendor Extensions

Each section becomes clear domain types, avoiding direct access to raw JSON.

✦ INR: engine-facing runtime format (feature inr)

INX/INP are authoring formats: nested JSON, UUID cross-references, encoded PNG/TGA textures. INR is the engine-facing counterpart (in the spirit of glTF/GLB): a small JSON index plus one binary blob with mesh buffers, binding grids and raw RGBA8 textures laid out 4-aligned for zero-copy GPU upload. Cross-references are array indices and the node tree is flattened pre-order.

Textures are exported as straight-alpha sRGB with edge dilation, the convention expected by Bevy, Unity, Unreal and Godot: hardware sRGB views decode for free, in-shader premultiply gives correct linear blending, and dilation avoids dark fringes from bilinear filtering — no per-engine texture fixups needed.

Full specification: docs/INR-SPEC.md.

# Convert INX/INP to INR
cargo run --features inr-export --example inx2inr -- puppet.inx puppet.inr

✦ Unimplemented Features

Currently out of scope:

✦ Automation

(These layers are intended for a separate runtime or playback system)

✦ Usage Example

[dependencies]
inochi2d-parser = "0.2"
# optional: INR read / write
# inochi2d-parser = { version = "0.2", features = ["inr-export"] }

use inochi2d_parser::Puppet;

fn main() -> std::io::Result<()> {
    let puppet = Puppet::open("path/to/file.inp")?;

    // Root node
    let root_node = &puppet.nodes;

    // First child node
    let child_node = root_node.children.get(0).unwrap();

    // First global parameter
    let root_param = puppet.params.get(0).unwrap();

    Ok(())
}

Reading INR (feature inr):

use inochi2d_parser::inr;

let puppet = inr::open_puppet("puppet.inr")?;       // INR → IR
let model = inr::InrModel::open("puppet.inr")?;     // typed doc + raw buffers