README.txt	v1.3	7. November 2008	by eddy

*************************************************************************
* Note: My Program "lego" is still under construction.                  *
*       You have got the sources of version 1.3.                        *
*       This document and other descriptions may be out of date.        *
*       If you  have any questions, please contact the author.          *
*       See also the file example.lego for further description          *
*************************************************************************

"lego" is an image generator for LEGO(R)-like models. It simply uses 
stdin and stdout streams. A text compilation builds up the graphical 
image. At the end of the programs runtime the image is issued in 
portabel pixmap format. See PPM-tools by Jef Poskanzer.

The input describes a virtual room in size and angel of view. It also 
describes objects inside the room concerning origin, color and alignment. 
See example.lego and examples.

Usage:   lego < textsource > pixmap

Example: 
         lego < example.lego > example.ppm
         lego < example.lego | display    
         lego < example.lego | pnmscale -xysize 300 300 | display

The program was developed for Linux and may be ported to other operating
systems. An OS/2 port was found on Hobbes. Please report if there are 
any further successful portings.

Get sources from: 

    http://www.nussbaums.homepage.t-online.de/src/lego/lego1v3.tar.gz

To install the program you have to unzip and untar lego1v3.tar.gz. 
Change directory to where the unpacked source files are and type 
"make lego". An executable binary file named "lego" will arise.

Author:	Edmund Nussbaum <en @ mpifr-bonn.mpg.de> ;-)