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

  
 
  

home | help
grap2graph(1)		     General Commands Manual		   grap2graph(1)

Name
     grap2graph - convert a grap diagram into a cropped image

Synopsis
     grap2graph [-unsafe] [-format output-format] [convert-argument ...]

     grap2graph --help

     grap2graph -v
     grap2graph --version

Description
     grap2graph  reads	a  grap(1) program from the standard input and writes an
     image file, by default in Portable Network Graphics (PNG)	format,  to  the
     standard output.

     The  input GRAP code should not be wrapped with the .G1 and .G2 macros that
     normally guard it within groff(1) documents.

     Arguments not recognized by grap2graph are passed	to  the  ImageMagick  or
     GraphicsMagick  program convert(1).  By specifying these, you can give your
     image a border, set the image's pixel  density,  or  perform  other  useful
     transformations.

     The  output  image  is clipped using convert's -trim option to the smallest
     possible bounding box that contains all the black pixels.

Options
     --help displays a usage message, while -v and --version show version infor-
     mation; all exit afterward.

     -format output-format
	    Write the image  in  output-format,  which	must  be  understood  by
	    convert; the default is PNG.

     -unsafe
	    Run groff in unsafe mode, enabling the PIC command sh to execute ar-
	    bitrary Unix shell commands.  The groff default is to forbid this.

Environment
     GROFF_TMPDIR
     TMPDIR
     TMP
     TEMP   These  environment	variables are searched in the order shown to de-
	    termine the directory where temporary files  will  be  created.   If
	    none are set, /tmp is used.

Authors
     grap2graph  was  written  by  Eric  S.  Raymond,  based  on  a  recipe  for
     pic2graph(1), by W. Richard Stevens.

See also
     pic2graph(1), eqn2graph(1), grap(1), pic(1), groff(1), convert(1)

groff 1.24.1			   2026-03-14			   grap2graph(1)

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

home | help