riichi-hand-rs

A collection of utilities for working with Riichi Mahjong player hands to use with Rust programming language.

This currently includes:

• Hand representation object
• Parser that allows to quickly create a hand using human-readable string, such as 123m456p_7*77z
• Renderer that allows to draw a hand to a raster image (along with a few ready-to-use sets of tile images)

Usage

Add the following to your Cargo.toml:

[dependencies]
riichi_hand = "0.1.0"

On the feature flags overview, please refer to the crate documentation.

Example

use riichi_hand::parser::HandParser;
use riichi_hand::raster_renderer::fluffy_stuff_tile_sets::YELLOW_FLUFFY_STUFF_TILE_SET;
use riichi_hand::raster_renderer::{RasterRenderer, RenderOptions};

fn main() {
    let hand = HandParser::parse("123m123p123sEESS").unwrap();
    let image = RasterRenderer::render(&hand, &*YELLOW_FLUFFY_STUFF_TILE_SET, RenderOptions::default());
    image.save("/tmp/hand.png").unwrap();
}

Uses

• chombot - Discord bot for Krakow Chombo Club's Discord server

License

The project is licensed under the MIT license.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the project by you shall be licensed as MIT, without any additional terms or conditions.

Attribution

This project uses modified riichi-mahjong-tiles by FluffyStuff, licensed under CC BY 4.0.