Home /Modules/bash/README.md

README.md

bash/model-3D/modeling/README.md · 48 line(s) · markdown

<img align="right" src="https://github.com/mearvk/SLeeLa/blob/master/images/debian/debian-logo.png" width="75" height="75" alt="SLeeLa">

<img src="https://github.com/mearvk/SLeeLa/blob/master/images/sleela/sleela-logo-004.jpg" alt="SLeeLa">

modeling/ — SleelaTerminal™ · Phraign™ City 3D model data

Part of SleelaTerminal™ (Phraign™ City 3D), SLeeLa's terminal product, built on GNU Bash (GPL, © Free Software Foundation).

This subfolder holds city model data: serialized .city files in the PHRAIGN-CITY text format (see ../MODEL_FORMAT.md).

A model is generated per user from a seed, so a given user always reproduces the same city. Models are plain, line-oriented text — they diff cleanly and are meant to be saved here, committed to GitHub, or uploaded to a public server.

Contents

FileGridBlocksNotes
demo.city64×644096 (~4000)Default sprawling city, user=demo
smalltown.city32×321024Smaller example, blue theme seed

Working with models

# from bash/model-3D/
make                                   # build ./build/city3d

# Generate a new model into modeling/
./build/city3d generate --config city.config --out modeling/mycity.city

# Render a saved model to a preview image (per-pixel Phraign frame -> PPM)
./build/city3d render --model modeling/mycity.city --config city.config \
    --ppm build/mycity.ppm

# Show the save plan for the configured target (github|server|local)
./build/city3d save --model modeling/mycity.city --config city.config

New users typically drop their own <name>.city here. Because the format is deterministic from (user, seed, grid), a model file plus the config is enough to reproduce and re-render the exact city on any machine.