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

NAME

6       grap2graph - convert a GRAP diagram into a cropped image
7

SYNOPSIS

9       grap2graph [-unsafe] [-format output-format] [convert-arguments]
10
11       grap2graph --help
12
13       grap2graph -v
14       grap2graph --version
15

DESCRIPTION

17       grap2graph  reads  a grap(1) program from the standard input and writes
18       an image file, by default in Portable Network Graphics (PNG) format, to
19       the standard output.
20
21       The  input  GRAP code should not be wrapped with the .G1 and .G2 macros
22       that normally guard it within groff(1) documents.
23
24       Arguments not recognized by grap2graph are passed to the ImageMagick or
25       GraphicsMagick  program  convert(1).  By specifying these, you can give
26       your image a border, set the image's pixel density,  or  perform  other
27       useful transformations.
28
29       The  output image is clipped using convert's -trim option to the small‐
30       est possible bounding box that contains all the black pixels.
31

OPTIONS

33       -format output-format
34              Write the image in output-format, which must  be  understood  by
35              convert; the default is PNG.
36
37       --help Display a usage message and exit.
38
39       -unsafe
40              Run groff in unsafe mode, enabling the PIC command sh to execute
41              arbitrary Unix shell commands.  The groff default is  to  forbid
42              this.
43
44       -v
45       --version
46              Display version information and exit.
47

ENVIRONMENT

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

AUTHORS

57       grap2graph was written by Eric S. Raymond ⟨esr@thyrsus.com⟩, based on a
58       recipe for pic2graph(1), by W. Richard Stevens.
59

SEE ALSO

61       pic2graph(1), eqn2graph(1), grap(1), pic(1), groff(1), convert(1)
62
63
64
65groff 1.22.4                    20 January 2022                  GRAP2GRAPH(1)