1PIC2GRAPH(1)                General Commands Manual               PIC2GRAPH(1)
2
3
4

NAME

6       pic2graph - convert a PIC diagram into a cropped image
7

SYNOPSIS

9       pic2graph [-unsafe] [-format output-format] [-eqn delimiters] [convert-
10                 arguments]
11
12       pic2graph --help
13
14       pic2graph -v
15       pic2graph --version
16

DESCRIPTION

18       pic2graph reads a pic(1) program from the standard input and writes  an
19       image  file,  by  default in Portable Network Graphics (PNG) format, to
20       the standard output.  It furthermore translates eqn(1)  constructs,  so
21       it can be used for generating images of mathematical formulae.
22
23       The  input  PIC  code should not be wrapped with the .PS and .PE macros
24       that normally guard it within groff(1) documents.
25
26       Arguments not recognized by pic2graph are passed to the ImageMagick  or
27       GraphicsMagick  program  convert(1).  By specifying these, you can give
28       your image a border, set the image's pixel density,  or  perform  other
29       useful transformations.
30
31       The  output image is clipped using convert's -trim option to the small‐
32       est possible bounding box that contains all the black pixels.
33

OPTIONS

35       -eqn delimiters
36              Use delimiters  as  the  opening  and  closing  characters  that
37              delimit  eqn  directives; the default is “$$”.  The option argu‐
38              ment delimiters should be a two-character string, but  an  empty
39              string  ("")  is accepted as a directive to disable eqn process‐
40              ing.
41
42       -format output-format
43              Write the image in output-format, which must  be  understood  by
44              convert; the default is PNG.
45
46       --help Display a usage message and exit.
47
48       -unsafe
49              Run groff in unsafe mode, enabling the PIC command sh to execute
50              arbitrary Unix shell commands.  The groff default is  to  forbid
51              this.
52
53       -v
54       --version
55              Display version information and exit.
56

ENVIRONMENT

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

AUTHORS

66       pic2graph  was written by Eric S. Raymond ⟨esr@thyrsus.com⟩, based on a
67       recipe by W. Richard Stevens.
68

SEE ALSO

70       W. Richard Stevens, Turning PIC into HTML ⟨http://www.kohala.com/start/
71       troff/pic2html.html⟩
72
73       eqn2graph(1), grap2graph(1), pic(1), eqn(1), groff(1), convert(1)
74
75
76
77groff 1.22.4                    3 November 2020                   PIC2GRAPH(1)
Impressum