PIC2GRAPH(1)               General Commands Manual              PIC2GRAPH(1)

NAME         top

       pic2graph - convert a PIC diagram into a cropped image

SYNOPSIS         top

       pic2graph [ -unsafe ] [ -format fmt ] [ -eqn delim ]

DESCRIPTION         top

       Reads a PIC program as input; produces an image file (by default in
       Portable Network Graphics format) suitable for the Web as output.
       Also translates eqn(1) constructs, so it can be used for generating
       images of mathematical formulae.

       PIC is a rather expressive graphics minilanguage suitable for
       producing box-and-arrow diagrams of the kind frequently used in
       technical papers and textbooks.  The language is sufficiently
       flexible to be quite useful for state charts, Petri-net diagrams,
       flow charts, simple circuit schematics, jumper layouts, and other
       kinds of illustration involving repetitive uses of simple geometric
       forms and splines.  Because PIC descriptions are procedural and
       object-based, they are both compact and easy to modify.

       The PIC language is fully documented in Making Pictures With GNU PIC,
       a document which is part of the groff(1) distribution.

       Your input PIC code should not be wrapped with the .PS and .PE macros
       that normally guard it within groff(1) macros.

       The output image will be clipped to the smallest possible bounding
       box that contains all the black pixels.  Older versions of convert(1)
       will produce a black-on-white graphic; newer ones may produce a
       black-on-transparent graphic.  By specifying command-line options to
       be passed to convert(1) you can give it a border, force the
       background transparent, set the image's pixel density, or perform
       other useful transformations.

       This program uses pic(1), eqn(1), groff(1), gs(1), and the
       ImageMagick convert(1) program.  These programs must be installed on
       your system and accessible on your $PATH for pic2graph to work.

OPTIONS         top

              Run pic(1) and groff(1) in the ‘unsafe’ mode enabling the PIC
              macro sh to execute arbitrary commands.  The default is to
              forbid this.

       -format fmt
              Specify an output format; the default is PNG (Portable Network
              Graphics).  Any format that convert(1) can emit is supported.

       -eqn delim
              Change the fencepost characters that delimit eqn(1) directives
              ($ and $, by default).  This option requires an argument, but
              an empty string is accepted as a directive to disable eqn(1)

       Command-line switches and arguments not listed above are passed to

FILES         top

       /usr/local/share/groff/1.22.3/tmac/eqnrc  The eqn(1) initialization

ENVIRONMENT         top

              The directory in which temporary files will be created.  If
              this is not set pic2graph searches the environment variables
              TMPDIR, TMP, and TEMP (in that order).  Otherwise, temporary
              files will be created in /tmp.

BUGS         top

       Due to changes in the behavior of ImageMagick convert(1) that are
       both forward and backward-incompatible, mismatches between your
       pic2graph and convert(1) versions may produce zero-sized or untrimmed
       output images.  For this version of pic2graph you will need a version
       of convert(1) that supports the -trim option; older versions of
       pic2graph used -crop 0x0, which no longer has trimming behavior.

AUTHORS         top

       pic2graph was written by Eric S. Raymond ⟨⟩, based on
       a recipe by W. Richard Stevens.

SEE ALSO         top

       eqn2graph(1), grap2graph(1), pic(1), eqn(1), groff(1), gs(1),

COLOPHON         top

       This page is part of the groff (GNU troff) project.  Information
       about the project can be found at 
       ⟨⟩.  If you have a bug report for
       this manual page, see ⟨⟩.  This
       page was obtained from the project's upstream Git repository
       ⟨⟩ on 2018-02-02.  (At that
       time, the date of the most recent commit that was found in the repos‐
       itory was 2018-02-02.)  If you discover any rendering problems in
       this HTML version of the page, or you believe there is a better or
       more up-to-date source for the page, or you have corrections or
       improvements to the information in this COLOPHON (which is not part
       of the original manual page), send a mail to

Groff Version 1.22.3          24 November 2017                  PIC2GRAPH(1)

Pages that refer to this page: eqn2graph(1)grap2graph(1)groff(1)