Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
CONTEXTFREE(1)			  Context Free			  CONTEXTFREE(1)

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 gram-
     mars.  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  in-
     dividual  frames  or as a QuickTime .mov file. If - is specified instead of
     an input file, the grammar is read from standard input.  The  output  file-
     name 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  argu-
     ment.  Longer  "GNU-style" options exist as well. A summary of options sup-
     ported 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 (de-
	    fault: 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-determin-
	    istic 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 de-
	    clarations 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 vari-
	    ation code (in lower or upper case, respectively),	and  %%  is  re-
	    placed 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 De-
     bian project (but may be used by others).

3.3.1				   2020-04-04			  CONTEXTFREE(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=cfdg&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help