1 .TH EQN2GRAPH @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
3 eqn2graph \- convert an EQN equation into a cropped image
6 .\" This documentation is released to the public domain.
9 .\" Like TP, but if specified indent is more than half
10 .\" the current line-length - indent, use the default indent.
12 .ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
16 .\" --------------------------------------------------------------------
18 .\" --------------------------------------------------------------------
29 .\" --------------------------------------------------------------------
31 .\" --------------------------------------------------------------------
33 Reads an EQN equation (one line) as input; produces an image
34 file (by default in Portable Network Graphics format) suitable for the
39 Your input EQN code should
41 have the \&.EQ/.EN preamble that normally precedes it within
43 macros; nor do you need to have dollar-sign or other delimiters
48 The output image will be clipped to the smallest possible bounding box
49 that contains all the black pixels.
53 will produce a black-on-white graphic; newer ones may produce a
54 black-on-transparent graphic.
56 By specifying command-line options to be passed to
58 you can give it a border, force the background transparent, set the
59 image's pixel density, or perform other useful transformations.
64 .BR @g@eqn (@MAN1EXT@),
65 .BR groff (@MAN1EXT@),
70 These programs must be installed on your system and accessible on your
76 .\" --------------------------------------------------------------------
78 .\" --------------------------------------------------------------------
84 in the `unsafe' mode enabling the PIC macro
86 to execute arbitrary commands.
88 The default is to forbid this.
92 Specify an output format; the default is PNG (Portable Network Graphics).
96 can emit is supported.
100 Command-line switches and arguments not listed above are passed to
104 .\" --------------------------------------------------------------------
106 .\" --------------------------------------------------------------------
108 .Tp \w'\fB@MACRODIR@/eqnrc'u+2n
111 .BR @g@eqn (@MAN1EXT@)
115 .\" --------------------------------------------------------------------
117 .\" --------------------------------------------------------------------
121 The directory in which temporary files will be created.
125 searches the environment variables
132 Otherwise, temporary files will be created in
136 .\" --------------------------------------------------------------------
138 .\" --------------------------------------------------------------------
140 Due to changes in the behavior of ImageMagick
142 that are both forward and backward-incompatible,
143 mismatches between your
147 versions may produce zero-sized or untrimmed output images.
151 you will need a version of
155 option; older versions of
159 which no longer has trimming behavior.
162 .\" --------------------------------------------------------------------
165 .\" --------------------------------------------------------------------
167 .BR pic2graph (@MAN1EXT@),
168 .BR grap2graph (@MAN1EXT@),
169 .BR @g@eqn (@MAN1EXT@),
170 .BR groff (@MAN1EXT@),
176 Eric S.\& Raymond <esr@thyrsus.com>.
178 This documentation is released to the public domain.