README.md

isometry

Draw an isometric image consisting of cubes according to instructions in a text file. Requires the Pillow module.

Command line arguments

• input file (see below)
• output file (PNG, RGB without alpha)

Input file

• Encoding: ASCII.
• Case insensitive.
• Empty lines are ignored.
• Specify width: W immediately followed by an integer.
• Specify depth: D immediately followed by an integer.
• Specify height: H immediately followed by an integer.
• Other lines:
  • Each group of depth lines describes a horizontal layer.
  • There are height × depth lines in total.
  • Bottom layer first.
  • Rear line first within each layer.
  • Each text line starts with |.
  • | is followed by up to width characters, excluding newline.
  • After |, spaces denote "no cube" and any other character denotes "cube".
  • Missing trailing spaces are assumed to be "no cube".

More settings

The constants at the beginning of the program can be edited. You can change:

• the dimensions of the building blocks (only the combinations corresponding to minicube-*.png files are allowed; see below)
• the margins
• the background color

Other files

• minicube-WxHxD.png: the cubes used as building blocks; W/H/D are width/height/depth in pixels