User Commands GRAP2GRAPH(1)
NAME
grap2graph - convert a grap diagram into a cropped bitmap
image
SYNOPSIS
grap2graph [ -unsafe ] [ -resolution M|MxN ] [ -format fmt ]
DESCRIPTION
Reads a grap program as input; produces an image file (by
default in Portable Network Graphics format) suitable for
the Web as output. For a description of the grap language,
see grap(1).
Your graph specification should not be wrapped with the .G1
and .G2 macros that normally guard it within groff(1) mac-
ros.
The output image will be a black-on-white graphic clipped to
the smallest possible bounding box that contains all the
black pixels. By specifying command-line options to be
passed to convert(1) you can give it a border, set the back-
ground transparent, set the image's pixel density, or per-
form other useful transformations.
This program uses grap(1), gpic(1), groff(1), and the
ImageMagick convert(1) program. These programs must be
installed on your system and accessible on your $PATH for
grap2graph to work.
OPTIONS
-unsafe
Run gpic(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.
Command-line switches and arguments not listed above are
passed to convert(1).
ENVIRONMENT
GROFF_TMPDIR
The directory in which temporary files will be created.
If this is not set grap2graph searches the environment
variables TMPDIR, TMP, and TEMP (in that order). Oth-
erwise, temporary files will be created in /tmp.
Groff Version 1.19.2Last change: 21 October 2010 1
User Commands GRAP2GRAPH(1)
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWgroff |
|_____________________________|_____________________________|
| Interface stability | Uncommitted |
|_____________________________|_____________________________|
SEE ALSO
pic2graph(1), eqn2graph(1), gpic(1), groff(1), gs(1), con-
vert(1).
AUTHOR
Eric S. Raymond
Groff Version 1.19.2Last change: 21 October 2010 2