man > pic2graph(1)

pic2graph(1)                           General Commands Manual                          pic2graph(1)

Name
       pic2graph - convert a pic diagram into a cropped image

Synopsis
       pic2graph [-unsafe] [-format output-format] [-eqn delimiters] [convert-argument ...]

       pic2graph --help

       pic2graph -v
       pic2graph --version

Description
       pic2graph reads a ]8;;man:pic(1)\pic(1)]8;;\ program from the standard input and writes an image file, by default
       in Portable Network Graphics (PNG) format, to the standard output.  It furthermore translates
       ]8;;man:eqn(1)\eqn(1)]8;;\ constructs, so it can be used for generating images of mathematical formulae.

       The  input PIC code should not be wrapped with the .PS and .PE/.PF macros that normally guard
       it within ]8;;man:groff(1)\groff(1)]8;;\ documents.

       Arguments not recognized by pic2graph are passed to the ImageMagick or GraphicsMagick program
       ]8;;man:convert(1)\convert(1)]8;;\.  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.

       -eqn delimiters
              Use  delimiters as the opening and closing characters that delimit eqn directives; the
              default is “$$”.  The option argument delimiters should be a two-character string, but
              an empty string ("") is accepted as a directive to disable eqn processing.

       -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
       pic2graph was written by ]8;;mailto:esr AT thyrsus.com\Eric S. Raymond]8;;\, based on a recipe by W. Richard Stevens.

See also
       W. Richard Stevens, ]8;;http://www.kohala.com/start/troff/pic2html.html\Turning PIC into HTML]8;;\

       ]8;;man:eqn2graph(1)\eqn2graph(1)]8;;\, ]8;;man:grap2graph(1)\grap2graph(1)]8;;\, ]8;;man:pic(1)\pic(1)]8;;\, ]8;;man:eqn(1)\eqn(1)]8;;\, ]8;;man:groff(1)\groff(1)]8;;\, ]8;;man:convert(1)\convert(1)]8;;\

groff 1.23.0                                31 March 2024                               pic2graph(1)