from small one page howto to huge articles all in one place
Last additions:
May 25th. 2007:
April, 26th. 2006:
| 
pic2graph
Section: User Commands (1) Updated: 2 July 2023 Index
Return to Main Contents
Name
pic2graph - convert a
pic
diagram into a cropped image
.nr d-fallback 1
.nr d-fallback 1
Synopsis
[ -unsafe]
[ -format~outpu-format]
[ -eqn~delimiters]
[ conver-argument~...]
--help
-v
--version
Description
pic2graph
reads a
program from the standard input and writes an image file,
by default in Portable Network Graphics (PNG) format,
to the standard output.
It furthermore translates
constructs, so it can be used for generating images of mathematical
formulae.
The input PIC code should
not
be wrapped with the
.PS
and
.PE/.PF
macros that normally guard it within
documents.
Arguments not recognized by
pic2graph
are passed to the ImageMagick or GraphicsMagick program
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
--help
displays a usage message,
while
-v
and
--version
show version information;
all exit afterward.
- -eqn~delimiters
-
Use
delimiters
as the opening and closing
characters that delimit
eqn
directives;
the default is lq$$rq.
The option argument
delimiters
should be a tw-character string,
but an empty string (dqdq) is accepted as a directive to disable
eqn
processing.
- -format~outpu-format
-
Write the image in
outpu-format,
which must be understood by
convert;
the default is PNG.
- -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
- GROFF_TMPDIR
-
TMPDIR
TMP
TEMP
These environment variables are searched in the given order to determine
the directory where temporary files will be created.
If none are set,
/tmp
is used.
Authors
pic2graph
was written by
Eric S. Raymond
based on a recipe by W. Richard Stevens.
See also
W. Richard Stevens,
Turning PIC into HTML
Index
- Name
-
- Synopsis
-
- Description
-
- Options
-
- Environment
-
- Authors
-
- See also
-
| 
|
|
- Running on 
-
:
