roead

Crates.ioroead
lib.rsroead
version0.25.1
sourcesrc
created_at2021-11-18 06:46:45.728624
updated_at2024-04-07 13:35:12.701941
descriptionRust bindings for oead C++ library for common Nintendo formats
homepage
repositoryhttps://github.com/NiceneNerd/roead
max_upload_size
id483853
size3,358,636
Caleb Smith (NiceneNerd)

documentation

README

roead

crates.io api license build

A Rusty child of the oead C++ library

oead is a C++ library for common file formats that are used in modern first-party Nintendo EAD (now EPD) titles.

Currently, oead only handles very common formats that are extensively used in recent games such as Breath of the Wild and Super Mario Odyssey.

  • AAMP (binary parameter archive): Only version 2 is supported.
  • BYML (binary YAML): Versions 2, 3, and 4 are supported (up to v7 in roead).
  • SARC (archive)
  • Yaz0 (compression algorithm)

The roead project brings oead's core functionality, by directly porting or (for the yaz0 module) providing safe and idiomatic bindings to oead's features. (The Grezzo datasheets are not supported.) For more info on oead itself, visit its GitHub repo.

Each of roead's major modules is configurable as a feature. The default feature set includes byml, aamp, sarc, and yaz0. For compatibility with many existing tools for these formats, there is also a yaml feature which enables serializing/deserializing AAMP and BYML files as YAML documents. Finally, serde support is available using the with-serde feature.

For API documentation, see the docs for each module.

Building from Source

Most of roead is pure Rust and can compiled with any relatively recent release. The stable MSRV is 1.69. However, the yaz0 module provides FFI bindings to oead code, so to use it the following additional requirements are necessary:

  • CMake 3.12+
  • A compiler that supports C++17
  • Everything necessary to build zlib

First, clone the repository, then enter the roead directory and run git submodule update --init --recursive.

Contributing

Issue tracker: https://github.com/NiceneNerd/roead/issues
Source code: https://github.com/NiceneNerd/roead

This project is licensed under the GPLv3+ license. oead is licensed under the GPLv2+ license.

Commit count: 277

cargo fmt