Manual Pages for UNIX Darwin command on man pic2graph

PIC2GRAPH(1) PIC2GRAPH(1)

NAME

pic2graph - convert a PIC diagram into a cropped image

SYNOPSIS

ppiicc22ggrraapphh [ -uunnssaaffee ] [ -ffoorrmmaatt fmt ] [ -eeqqnn delim ]

DESCRIPTION

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 eeqqnn(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 ggrrooffff(1) distribution. Your input PIC code should not be wrapped with the .PS and .PE macros that normally guard it within ggrrooffff(1) macros.

The output image will be a black-on-white graphic clipped to the small-

est possible bounding box that contains all the black pixels. By spec-

ifying command-line options to be passed to ccoonnvveerrtt(1) you can give it

a border, set the background transparent, set the image's pixel den-

sity, or perform other useful transformations. This program uses ppiicc(1), eeqqnn(1), ggrrooffff(1), ggss(1), and the ImageMagick ccoonnvveerrtt(1) program. These programs must be installed on your system

and accessible on your $PATH for ppiicc22ggrraapphh to work.

OOPPTTIIOONNSS

-uunnssaaffee

Run ppiicc(1) and ggrrooffff(1) in the `unsafe' mode enabling the PIC

macro sshh to execute arbitrary commands. The default is to for-

bid this.

-ffoorrmmaatt fmt

Specify an output format; the default is PNG (Portable Network Graphics). Any format that ccoonnvveerrtt(1) can emit is supported.

-eeqqnn delim

Change the fencepost characters that delimit eeqqnn(1) directives

($$ and $$, by default). This option requires an argument, but an

empty string is accepted as a directive to disable eeqqnn(1) pro-

cessing.

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

vveerrtt(1). FILES //uussrr//sshhaarree//ggrrooffff//11..1199..11//ttmmaacc//eeqqnnrrcc The eeqqnn(1) initialization file. ENVIRONMENT GGRROOFFFFTTMMPPDDIIRR The directory in which temporary files will be created. If this is not set ppiicc22ggrraapphh searches the environment variables TTMMPPDDIIRR, TTMMPP, and TTEEMMPP (in that order). Otherwise, temporary files will be created in //ttmmpp.