[lsystem3d.git] / README

DESCRIPTION
-----------

LSystem3d is a experimental Lindenmayer System generator with 3d capabilities,
whose main goal is to generate all kinds of plants or whatever fractal
L-system structures the user desires. For now, LSystem3D is highly under
development and is considered alpha, that is, lots of things are missing and
it will probably not work 100% accurate.


REQUIREMENTS
------------

Currently tested in Debian GNU/Linux (Sid) only, but should compile fine on
other platforms without bigger modification.

A fast computer with HW accelerated 3D would be nice.

Dependencies;

OpenGL
FOX toolkit
libxml++
glibmm


USAGE
-----

Mouse keys:

Left       move model in z-plane
Middle     zoom in and out
Right      rotate around the y-axis


Rules:

=     name/rule separator
F     walk forward, leave a trace
A-Z   rewrite operator
+     turn left
-     turn right
&     pitch down
^     pitch up
\     roll left
/     roll right
|     turn around 180 degrees
[     save state to stack
]     restore state from stack
{     first vertex of a filled polygon
}     last vertex of a filled polygon
f     one vertex of a filled polygon
!     decrease diameter of segment
'     increase color index
,     decrease color index
Commit	Line	Data
	1	DESCRIPTION
	2	-----------
	3
	4	LSystem3d is a experimental Lindenmayer System generator with 3d capabilities,
	5	whose main goal is to generate all kinds of plants or whatever fractal
	6	L-system structures the user desires. For now, LSystem3D is highly under
	7	development and is considered alpha, that is, lots of things are missing and
	8	it will probably not work 100% accurate.
	9
	10
	11
	12	REQUIREMENTS
	13	------------
	14
	15	Currently tested in Debian GNU/Linux (Sid) only, but should compile fine on
	16	other platforms without bigger modification.
	17
	18	A fast computer with HW accelerated 3D would be nice.
	19
	20	Dependencies;
	21
	22	OpenGL
	23	FOX toolkit
	24	libxml++
	25	glibmm
	26
	27
	28
	29	USAGE
	30	-----
	31
	32	Mouse keys:
	33
	34	Left move model in z-plane
	35	Middle zoom in and out
	36	Right rotate around the y-axis
	37
	38
	39	Rules:
	40
	41	= name/rule separator
	42	F walk forward, leave a trace
	43	A-Z rewrite operator
	44	+ turn left
	45	- turn right
	46	& pitch down
	47	^ pitch up
	48	\ roll left
	49	/ roll right
	50	\| turn around 180 degrees
	51	[ save state to stack
	52	] restore state from stack
	53	{ first vertex of a filled polygon
	54	} last vertex of a filled polygon
	55	f one vertex of a filled polygon
	56	! decrease diameter of segment
	57	' increase color index
	58	, decrease color index