Tiling Gallery

Tiling Gallery is a Rust-based CLI tool for generating SVG images of two types of aperiodic tilings:

• Penrose tiling using the De Bruijn pentagrid method
• Pinwheel tiling with recursive triangle subdivision

This project is ideal for generating mathematical and artistic patterns based on non-periodic tilings.

---

✨ Features

• Generate Penrose tilings using customizable pentagrid settings.
• Create Pinwheel tilings with a specified number of recursive iterations.
• Output in SVG format with configurable size and color.
• Fast and lightweight CLI tool written in Rust.

---

🛠 Installation

You can directly download and run the executable from the Release page.

• macOS: tiling-gallery
• Windows: tiling-gallery.exe

If you want to build from the source code, make sure you have Rust installed. Then clone and build:

git clone https://github.com/your_username/tiling-gallery.git
cd tiling-gallery
cargo build --release

The binary will be available at target/release/tiling-gallery.

🚀 Usage

Run the CLI with one of the available subcommands:

🌀 Generate Penrose Tiling

./tiling-gallery debruijn \
--dimension 5 \
--num-lines 12 \
--width 800 \
--height 600 \
--fat-color "#FF9F1C" \
--thin-color "#2EC4B6" \
--edge-color "#6D6875" \
--output-filename "penrose.svg"

Options

| Flag | Description | Default | | ------------------- | ---------------------------------- | ------------ | | --dimension | Number of pentagrid directions | 5 | | --num-lines | Number of lines per direction | 12 | | --width | SVG canvas width | 800 | | --height | SVG canvas height | 600 | | --fat-color | Color of fat rhombuses (hex code) | #FF9F1C | | --thin-color | Color of thin rhombuses (hex code) | #2EC4B6 | | --edge-color | Color of tile edges (hex code) | #6D6875 | | --output-filename | Output SVG file name | output.svg |

example

If you set dimension to 4, you can get Ammann Beenker Tiling.

🧩 Generate Pinwheel Tiling

./tiling-gallery pinwheel \
    --iterations 5 \
    --width 800 \
    --height 600 \
    --output-filename "pinwheel.svg"

Options

| Flag | Description | Default | | ------------------- | --------------------------- | ------------ | | --iterations | Recursive subdivision depth | 5 | | --width | SVG canvas width | 800 | | --height | SVG canvas height | 600 | | --output-filename | Output SVG file name | output.svg |

example

📁 Output

Both subcommands will generate an SVG file with the specified name in the current directory.

🧠 Background

• Penrose Tiling is an aperiodic tiling discovered by Roger Penrose. This implementation uses the De Bruijn pentagrid method to construct it.

• Pinwheel Tiling is a non-periodic tiling where a right triangle is recursively subdivided and rotated.