decart

Crates.iodecart
lib.rsdecart
version0.0.9
sourcesrc
created_at2021-10-11 10:51:07.078974
updated_at2022-07-25 20:04:56.738355
descriptionOcto cartridge encoder/decoder
homepage
repositoryhttps://github.com/tobiasvl/decart
max_upload_size
id463513
size71,254
rust (github:chip-8:rust)

documentation

https://docs.rs/decart

README

decart

crates.io docs.rs dependency status

decart is a library and a command-line tool for reading and (in the future) generating "Octocarts", CHIP-8 game cartridges for the Octo environment, written in Rust.

Use cases

  • Decoding: You can extract the program source code and runtime settings from an Octocart file. The source code can be assembled into CHIP-8 bytecode with Octo or decasm. The runtime settings can be given to a CHIP-8 interpreter like Octo or deca, or saved as JSON for the CHIP-8 Archive or an .octo.rc file for C-Octo or termin-8, etc.
  • Encoding: TODO

Octocarts

Octo cartridge files, or Octocarts, are GIF89a images with a payload steganographically embedded in one or more animation frames. Data is stored in the least significant bits of colors – 1 from the red/blue channels and 2 from the green channel – allowing us to pack a hidden byte into every 2 successive pixels.

The payload consists of a 32-bit length, followed by a sequence of ASCII bytes consisting of the JSON-encoded options dictionary and source text.

An Octo cartridge contains the source code of an Octo program, and a set of configuration options (parsed by octopt) for the CHIP-8 interpreter telling it how to run the program.

See also

  • To compile/assemble the Octo source code in the Octocart, check out the decasm crate.
  • To interpret an assembled program, check out the deca crate (backend) or a program like termin-8 (frontend and graphics).
Commit count: 11

cargo fmt