NAME

       cfdg - image generator based on context-free grammars

SYNOPSIS

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

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.  Cfdg files can also be animated. The output
       can either be PNG files of individual frames  or  as  a  QuickTime  .mov  file.  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/--outputtemplate option or -C/--check option  is  used.
       If  the --display option is specified and there is no output file then the output is saved
       in a temporary file. Note that the  output  mode  (PNG,  SVG,  or  MOV)  is  not  detected
       depending  on  the  specified  extension, but must be explicitly set using the -V/--svg or
       -Q/--quicktime option.

OPTIONS

       All command-line options consist of a single letter,  and  an  optional  argument.  Longer
       "GNU-style"  options  exist  as  well.  A summary of options supported by cfdg is included
       below.

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

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

       -s SIZE, --size=SIZE
              Set both width and height of the output image in pixels (for  PNG)  or  millimeters
              (for SVG) to the same value.

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

       -T SIZE, --tile=SIZE
              Multiply both width and height of the tiled output image by the same amount.

       -T WIDTHxHEIGHT, --tile=WIDTHxHEIGHT
              Multiply both width and height of the tiled output image by the given amounts.

       -m MAXSHAPES, --maxshapes=MAXSHAPES
              Set the maximum number of shapes rendered (default: no maximum).

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

       -b BORDERSIZE, --bordersize=BORDERSIZE
              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, --variation=VARIATION
              Set  the  variation  code  (default:  random).  This code determines what the final
              image will look like when the input contains non-deterministic rules.

       -DNAME=VALUE
              Declare a variable, configuration, or function. Any declaration that can be made at
              global  scope  can  be  entered  at the command line with this option. Command line
              declarations override any global-scope declarations in the cfdg file with the  same
              name.  Note that function declarations require a space-delimited type identifier in
              front, so quotes would be required  to  force  the  shell  to  group  the  function
              declaration parts as one entity.

       -o NAMETEMPLATE, --outputtemplate=NAMETEMPLATE
              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 %.

       -a NUM, --animate=NUM
              Generate NUM animation frames at 15 fps.

       -a TIMExFPS, --animate=TIMExFPS
              Generate TIME x FPS animation frames at the specified fps.

       -f FRAME, --frame=FRAME
              Generate animation FRAME only.

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

       -V, --svg
              Generate SVG (vector) output.

       -Q, --quicktime
              Generate Quicktime movie output.

       --prores
              Generate Quicktime movie output using the ProRes codec instead of the H.264 codec.

       --display=DISPLAY EXECUTABLE
              Display output with specified program.

       -c, --crop
              Crop image output.

       -q, --quiet
              Quiet mode; suppress non-error output.

       -C, --check
              Check the syntax of the cfdg file, then exit.

       -t, --time
              Time output; output the time taken to render the cfdg file.

       -d, --cleanup
              Delete old temporary files.

       -P, --paramdebug
              Enable debug mode to test if all parameter blocks are deallocated.

       -?, --help
              Show summary of options.

SEE ALSO

       More    information    can    be    found    on    the    Context    Free    website,   at
       https://www.contextfreeart.org/index.html

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).