Go to main content

man pages section 1: User Commands

Exit Print View

Updated: July 2017

pic2graph (1)


pic2graph - convert a PIC diagram into a cropped image


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


PIC2GRAPH(1)                General Commands Manual               PIC2GRAPH(1)

       pic2graph - convert a PIC diagram into a cropped image

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

       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  geqn(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  use-
       ful  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 transpar-
       ent, set the image's pixel density, or perform other useful transforma-

       This  program uses gpic(1), geqn(1), groff(1), gs(1), and the ImageMag-
       ick convert(1) program.  These programs must be installed on your  sys-
       tem and accessible on your $PATH for pic2graph to work.

              Run  gpic(1)  and groff(1) in the `unsafe' mode enabling the PIC
              macro sh to execute arbitrary commands.  The default is to  for-
              bid 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 geqn(1)  directives
              ($ and $, by default).  This option requires an argument, but an
              empty string is accepted as a directive to disable geqn(1)  pro-

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

       /usr/share/groff/1.22.2/tmac/eqnrc  The geqn(1) initialization file.

              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.

       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.

       See attributes(5) for descriptions of the following attributes:

       |Availability   | text/groff       |
       |Stability      | Uncommitted      |
       eqn2graph(1),  grap2graph(1),  gpic(1),   geqn(1),   groff(1),   gs(1),

       Eric  S.  Raymond  <esr@thyrsus.com>,  based  on a recipe by W. Richard

       This    software    was    built    from    source     available     at
       https://java.net/projects/solaris-userland.    The  original  community
       source                was                downloaded                from

       Further information about this software can be found on the open source
       community website at http://www.gnu.org/software/groff/.

Groff Version 1.22.2            7 February 2013                   PIC2GRAPH(1)