tilegraph

tilegraph is Eldiron's procedural tile graph crate for generating retro tiles and multi-tile groups for walls, floors, materials, and effects.

It contains:

• the human-readable .tilegraph document format
• parsing and conversion into the runtime graph format
• the graph runtime and renderer
• support for multi-tile grouped output
• particle and light-oriented graph workflows used by Eldiron

What It Is

tilegraph is built around a height-first workflow for procedural retro tile generation.

Typical flow:

1. layout nodes generate structural fields such as Height, Center, and Cell Id
2. shaping nodes sculpt the field
3. color nodes map the result to palette colors
4. output writes color, height, material, particle, and light data

The resulting graph can generate:

• a single tile
• a grouped output such as 2x2 or 3x3
• height-driven material sheets
• particle- and light-related output used by Eldiron's editor/runtime workflows

Format

The portable graph format is TOML-based and intended to stay readable and diffable.

[node.voronoi.main]
scale = 0.349
seed = 11

[node.output.main]
color = "colorize4.main:field"
height = "subtract.main:field"

Library Use

use tilegraph::{TileGraphDocument, TileGraphRenderer};

let source = std::fs::read_to_string("examples/stones.tilegraph")?;
let doc = TileGraphDocument::from_toml_str(&source)?;
let exchange = doc.to_exchange()?;
let renderer = TileGraphRenderer::new(doc.palette.parsed_colors());
let rendered = renderer.render_graph(&exchange);

assert!(!rendered.sheet_color.is_empty());
# Ok::<(), Box<dyn std::error::Error>>(())

CLI

The package also contains a CLI binary:

cargo run -p tilegraph -- crates/tilegraph/examples/stones.tilegraph

This renders the graph to color/material output sheets and per-tile images.

Scope

tilegraph is designed first for Eldiron's procedural tile workflow, but the format is intentionally plain and portable enough to stay useful outside the editor as well.