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
       grammars.  cfdg is the command-line program to generate the actual  im-
       ages  (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	speci-
       fied and	there is no output file	then the output	is saved in  a	tempo-
       rary 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 op-
       tions 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  millime-
	      ters (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  deallo-
	      cated.

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

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.0.quarterly>

home | help