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 information; 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 arbitrary  Unix  shell  commands.
              The groff default is to forbid this.

Environment

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

Authors

       grap2graph was written by Eric S. Raymond ⟨esr@thyrsus.com⟩, 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)