Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/inochi2d/inox2d
Native Rust reimplementation of Inochi2D
https://github.com/inochi2d/inox2d
animation inochi2d rust vtuber
Last synced: 5 days ago
JSON representation
Native Rust reimplementation of Inochi2D
- Host: GitHub
- URL: https://github.com/inochi2d/inox2d
- Owner: Inochi2D
- License: other
- Created: 2022-11-15T12:26:46.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-03T14:36:37.000Z (about 1 month ago)
- Last Synced: 2024-10-28T22:19:33.496Z (18 days ago)
- Topics: animation, inochi2d, rust, vtuber
- Language: Rust
- Homepage:
- Size: 975 KB
- Stars: 200
- Watchers: 8
- Forks: 22
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Inox2D
Officially supported experimental Rust port of [Inochi2D](https://github.com/Inochi2D/inochi2d).
The Inox2D workgroup provides support in the **#inox2d** channel on the [Inochi2D Discord][discord-invite].
**Currently this library and the specification is in a prototype state**, it is not recommended to use this library in production.
[discord-invite]: https://discord.com/invite/abnxwN6r9v
## Rigging
If you're a model rigger you may want to check out [Inochi Creator](https://github.com/Inochi2D/inochi-creator), the official Inochi2D rigging app in development.
This repository is purely for developers and is not useful if you're an end user.
## Status
Both INP and INX files get parsed correctly.
The OpenGL renderer works on all models we could test them on (Aka, Midori, Arch-chan).
The newer models which use the MeshGroup feature don't work yet though.
Support for mesh groups and animations is on the way!
### Feature tree
- [x] Parsing
- [x] INP format
- [x] INX format
- [x] Rendering
- [x] OpenGL
- [x] WASM (WebGL)
- [ ] Draw List
- [x] Parameters
- [x] Deforms (mesh vertex offsets)
- [x] Values (node transform offsets)
- [ ] Z-sort
- [x] Physics
- [ ] Animations
- [ ] Mesh groups
### INP and INX parsing
```sh
cargo run -p inox2d --features owo --example parse-inp path/to/puppet.inp
```
### OpenGL renderer
```sh
cargo run -p render-opengl path/to/puppet.inp
```
### WebGL demo
See the [`render_webgl`](/examples/render_webgl) example.
## Implementation
Inox2D aims to support all features currently present in the standard D implementation.
Inox2D is designed to be extensible. Nodes are extensible through a generic `InoxData` enum which has a `Custom(T)` variant. Every other part of the library accounts for it: the OpenGL renderer accepts any struct that implements the `CustomRenderer` trait to be able to render your custom nodes, and the deserialization functions accept generic `Fn`s for deserialization of custom nodes when it is relevant.
## Optimization on OpenGL
| Implementation | language | OpenGL calls |
| --------------------- | -------- | ------------ |
| Inochi2D reference* | D | 3076 |
| Link Mauve's inochi2d | Rust | 551 |
| Inox2D | Rust | 1639 |
The OpenGL renderer on Inox2D has a few simple optimizations that result in fewer OpenGL calls:
- it uses a simple OpenGL cache to avoid making calls when the resulting state won't change,
- it only uploads a model's part textures once instead of every frame.
> \* Reference implementation is subject to change as optimisation passes are done, additionally code is more geared towards readability than performance for implementers to be able to more easily use it as reference.
## License
This project is licensed under the 2-Clause BSD license.
See [LICENSE](LICENSE) for details.