.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  | will give a
.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
.\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
.\" expand to `' in nroff, nothing in troff, for use with C<>.
.tr \(*W-|\(bv\*(Tr
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.if \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.\"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "EQEDIT 1"
.TH EQEDIT 1 "2006-02-04" "perl v5.8.8" "User Contributed Perl Documentation"
.SH "NAME"
eqedit: command\-line image generator for LaTeX
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\& eqedit --help
.Ve
.PP
.Vb 1
\& eqedit {options}
.Ve
.PP
.Vb 1
\& echo '\eLaTeX{} equations are nice' | eqedit --page-color=transparent -o nice.png; display nice.png
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
eqedit is a command-line utility to generate an image from LaTeX input.
It reads LaTeX input from stdin, and writes the output as a file specified with the \-\-output option.
The output format can be any format ImageMagick supports.
.PP
It is used by eqe, which wraps it in a \s-1GUI\s0 with drag and drop support.
.SH "OPTIONS"
.IX Header "OPTIONS"
All options can be abbreviated.
.Sh "\s-1HELP\s0"
.IX Subsection "HELP"
.IP "\fB\-\-help\fR" 4
.IX Item "--help"
Shows help about using eqedit.
.IP "\fB\-\-version\fR" 4
.IX Item "--version"
Displays the current version.
.Sh "\s-1ESSENTIAL\s0"
.IX Subsection "ESSENTIAL"
.IP "\fB\-\-output\fR=<file> [eq.png]" 4
.IX Item "--output=<file> [eq.png]"
Sets the output file. Can be of any extension that ImageMagick supports
(including png, jpeg, eps...).
.Sh "\s-1FORMATTING\s0"
.IX Subsection "FORMATTING"
.IP "\fB\-\-magnification\fR=<float> [3.0]" 4
.IX Item "--magnification=<float> [3.0]"
Sets the size of the output.
.IP "\fB\-\-text\-color\fR=<black|white|red|green|blue|cyan|magenta|yellow|transparent> [LaTeX default]" 4
.IX Item "--text-color=<black|white|red|green|blue|cyan|magenta|yellow|transparent> [LaTeX default]"
Sets the color of the text. Available colors are those supported
by the 'color' LaTeX package, plus 'transparent'.
.IP "\fB\-\-page\-color\fR=<...> [LaTeX default]" 4
.IX Item "--page-color=<...> [LaTeX default]"
Sets the color of the background. Available colors are those supported
by the 'color' LaTeX package, plus 'transparent'.
.IP "\fB\-\-font\fR=<8r|avant|bookman|chancery|charter|courier|helvet|mathpazo|mathpple|mathptm|mathptmx|newcent|palatino|pifont|times> [LaTeX default]" 4
.IX Item "--font=<8r|avant|bookman|chancery|charter|courier|helvet|mathpazo|mathpple|mathptm|mathptmx|newcent|palatino|pifont|times> [LaTeX default]"
Sets the font. Available fonts are those known to the LaTeX installation.
.IP "\fB\-\-displaymath\fR=<0|1> [0]" 4
.IX Item "--displaymath=<0|1> [0]"
Whether to wrap the input in a 'displaymath' LaTeX block.
.Sh "\s-1ADVANCED\s0 \s-1AND\s0 \s-1EXPERIMENTAL\s0"
.IX Subsection "ADVANCED AND EXPERIMENTAL"
.IP "\fB\-\-width\fR=<int>  [as defined after magnification]" 4
.IX Item "--width=<int>  [as defined after magnification]"
.PD 0
.IP "\fB\-\-height\fR=<int> [as defined after magnification]" 4
.IX Item "--height=<int> [as defined after magnification]"
.PD
Set the dimensions of the output image. The default is to use the
magnification to compute the size of the text, and to crop all the
blank area around it.
.IP "\fB\-\-latex\-template\fR=<file> [template.tt.tex]" 4
.IX Item "--latex-template=<file> [template.tt.tex]"
LaTeX template to use. eqedit searches for the template
(by default, template.tt.tex) in \f(CW$HOME\fR/.eqe/, /usr/local/share/eqe/, /usr/share/eqe/.
If it cannot be found, it uses a builtin template.
You may specify just a name (searched for in the search path),
or an absolute or relative path to the template to be used.
The template is in a format described in \f(CW\*(C`perldoc Template::Manual::Syntax\*(C'\fR
(ie, the Template Toolkit syntax).
.IP "\fB\-\-use\-dvipng\fR [off, ie use dvips]" 4
.IX Item "--use-dvipng [off, ie use dvips]"
Uses dvipng to convert the dvi to a png. Else, dvips is used.
.IP "\fB\-\-lumitransparency\fR (experimental)" 4
.IX Item "--lumitransparency (experimental)"
Uses luminance to compute transparency (alpha). Buggy. Needs \s-1GD\s0.
.Sh "\s-1LOGGING\s0 \s-1AND\s0 \s-1DEBUGGING\s0"
.IX Subsection "LOGGING AND DEBUGGING"
.IP "\fB\-\-verbose\fR [no]" 4
.IX Item "--verbose [no]"
Displays additional messages on stderr about what eqedit is doing.
.IP "\fB\-\-log\fR=<file> [/dev/null]" 4
.IX Item "--log=<file> [/dev/null]"
Specifies a file to log messages and tools output.
.IP "\fB\-\-keep\-temp\fR [no]" 4
.IX Item "--keep-temp [no]"
Whether to keep temporary files. Together with \-\-verbose, useful
for debugging.
.SH "AUTHOR"
.IX Header "AUTHOR"
Ronan Le Hy <rlehy@free.fr>
.SH "SEE ALSO"
.IX Header "SEE ALSO"
eqe, ImageMagick