grap2graph(1) General Commands Manual grap2graph(1)

# [Name](#Name)

grap2graph - convert a *grap* diagram into a cropped image

# [Synopsis](#Synopsis)

`grap2graph` \[**-unsafe**] \[**-format output-format**] \[*convert-argument* ...]

`grap2graph` **--help**

`grap2graph` **-v**

`grap2graph` **--version**

# [Description](#Description)

*grap2graph* reads a [*grap*(1)](/man/os/groff/grap.1) program from the standard input and writes an image file, by default in Portable Network Graphics (PNG) format, to the standard output.

The input GRAP code should *not* be wrapped with the **.G1** and **.G2** macros that normally guard it within [*groff*(1)](/man/os/groff/groff.1) documents.

Arguments not recognized by *grap2graph* are passed to the ImageMagick or GraphicsMagick program [*convert*(1)](/man/os/groff/convert.1). By specifying these, you can give your image a border, set the image's pixel density, or perform other useful transformations.

The output image is clipped using *convert*'s **-trim** option to the smallest possible bounding box that contains all the black pixels.

# [Options](#Options)

**--help** displays a usage message, while **-v** and **--version** show version information; all exit afterward.

[**-format output-format**](#format)

Write the image in *output-format*, which must be understood by *convert*; the default is PNG.

[**-unsafe**](#unsafe)

Run *groff* in *unsafe* mode, enabling the PIC command **sh** to execute arbitrary Unix shell commands. The *groff* default is to forbid this.

# [Environment](#Environment)

[*GROFF\_TMPDIR*](#GROFF_TMPDIR)

[*TMPDIR*](#TMPDIR)

[*TMP*](#TMP)

[*TEMP*](#TEMP)

These environment variables are searched in the order shown to determine the directory where temporary files will be created. If none are set, */tmp* is used.

# [Authors](#Authors)

*grap2graph* was written by [Eric S. Raymond](mailto:esr@thyrsus.com), based on a recipe for [*pic2graph*(1)](/man/os/groff/pic2graph.1), by W. Richard Stevens.

# [See also](#See_also)

[*pic2graph*(1)](/man/os/groff/pic2graph.1), [*eqn2graph*(1)](/man/os/groff/eqn2graph.1), [*grap*(1)](/man/os/groff/grap.1), [*pic*(1)](/man/os/groff/pic.1), [*groff*(1)](/man/os/groff/groff.1), [*convert*(1)](/man/os/groff/convert.1)

2026-10-24 groff 1.24.2

---

Document: grap2graph(1) from groff 1.24.2-r1 (Chainguard OS)
Source: https://git.savannah.gnu.org/git/groff.git