CONTEXTFREE(1)							   Context Free 						    CONTEXTFREE(1)

NAME

       cfdg - image generator based on context-free grammars

SYNOPSIS

       cfdg [options] input.cfdg [output.png/svg]

DESCRIPTION

       Context	Free  is  a  system  that produces images based on context-free grammars.  cfdg is the command-line program to generate the actual
       images (in PNG or SVG format) from the input.cfdg file containing these grammars.  If - is specified instead of an input file, the  grammar
       is  read from standard input.  The output filename can be left out if the -o option is used.  Note that the output mode (PNG or SVG) is not
       detected depending on the specified extension, but must be explicitly set using the -V option.

OPTIONS

       All command-line options consist of a single letter, and an optional argument.  A summary of options supported by cfdg is included below.

       -w width
	      Set width of the output image in pixels (for PNG) or millimeters (for SVG) (default: 500).

       -h height
	      Set height of the output image in pixels (for PNG) or millimeters (for SVG) (default: 500).

       -s size
	      Set both width and height of the output image in pixels (for PNG) or millimeters (for SVG).

       -m maximum shapes amount
	      Set the maximum number of shapes rendered (default: no maximum).

       -x minimum shape size
	      Set the minimum size for a shape to be rendered in pixels/mm (default: 0.3).

       -b border size
	      Set the border size: -1 for a -8 pixel border, 0 for no border, 1 for an 8 pixel border, or 2 for a variable-sized border.

       -v variation code
	      Set the variation code (default: random).  This code determines what the final image will look like when	the  input  contains  non-
	      deterministic rules.

       -o filename
	      Set  the	output	filename.   In this filename, %f is replaced by the animation frame number (if any), %v and %V are replaced by the
	      variation code (in lower or upper case, respectively), and %% is replaced by a literal %.

       -L     Previous versions of cfdg created different designs for the same variation code depending on whether a big- or little-endian machine
	      was  used;  now  the  little-endian  variation is created on all machines.  Use this option to get the old behaviour on a big-endian
	      machine.

       -a number of frames
	      Generate num animation frames (only possible using PNG output).

       -z     Zoom out during animation, when producing an animation using -a.

       -V     Generate SVG (vector) output.

       -c     Crop image output.

       -q     Quiet mode; suppress non-error output.

       -?     Show summary of options.

SEE ALSO

       More information can be found on the Context Free website, at http://contextfreeart.org/.

AUTHOR

       Context Free was written by Chris Coyne, John Horigan and Mark Lentczner.

       This manual page was written by Bram Senders <bram@luon.net>, for the Debian project (but may be used by others).

2.2								    2009-02-08							    CONTEXTFREE(1)