| 1 |
.TH TRANSFIG 1 "Version 3.2.4 November 2002" |
| 2 |
.SH NAME |
| 3 |
transfig \- creates a makefile for portable LaTeX figures |
| 4 |
.SH SYNOPSIS |
| 5 |
.B transfig |
| 6 |
[ \-L \fIlanguage\fR ] |
| 7 |
[ \-M \fImakefile\fR ] |
| 8 |
[ \-T \fItexfile\fR ] |
| 9 |
[ \-I \fImacrofile\fR ] |
| 10 |
[ \-V ] |
| 11 |
[ \fIcontrol_specs\fR figfile ... ] |
| 12 |
.SH DESCRIPTION |
| 13 |
.I Transfig |
| 14 |
creates a makefile to translate figures described in Fig code |
| 15 |
or PIC into a specified LaTeX graphics \fIlanguage\fR. |
| 16 |
PIC files are identified by the suffix ".pic"; |
| 17 |
Fig files can be specified either with or without the suffix ".fig" . |
| 18 |
Transfig also creates a TeX macro file appropriate to the target language. |
| 19 |
.SH OPTIONS |
| 20 |
The \fIlanguage\fR specifier must be one of |
| 21 |
.BR box, |
| 22 |
.BR cgm, |
| 23 |
.BR eepic, |
| 24 |
.BR eepicemu, |
| 25 |
.BR emf, |
| 26 |
.BR epic, |
| 27 |
.BR eps, |
| 28 |
.BR ge, |
| 29 |
.BR gif, |
| 30 |
.BR ibmgl, |
| 31 |
.BR jpeg, |
| 32 |
.BR latex, |
| 33 |
.BR map, |
| 34 |
.BR mf, |
| 35 |
.BR mmp, |
| 36 |
.BR mp, |
| 37 |
.BR pcx, |
| 38 |
.BR pdf, |
| 39 |
.BR pdftex, |
| 40 |
.BR pdftex_t, |
| 41 |
.BR pic, |
| 42 |
.BR pictex, |
| 43 |
.BR png, |
| 44 |
.BR ppm, |
| 45 |
.BR ps, |
| 46 |
.BR psfig, |
| 47 |
.BR pstex, |
| 48 |
.BR pstex_t, |
| 49 |
.BR ptk, |
| 50 |
.BR sld, |
| 51 |
.BR textyl, |
| 52 |
.BR tiff, |
| 53 |
.BR tk, |
| 54 |
.BR tpic, |
| 55 |
.BR xbm, |
| 56 |
.BR xpm |
| 57 |
or |
| 58 |
.BR null . |
| 59 |
The specifier |
| 60 |
.B psfig |
| 61 |
is like the |
| 62 |
.B ps |
| 63 |
specifier, except that it |
| 64 |
make use of the psfig macro package. |
| 65 |
The specifier |
| 66 |
.B pstex |
| 67 |
is like |
| 68 |
.B psfig, |
| 69 |
except that it uses LaTeX to process formatted (special) text. |
| 70 |
The specifier |
| 71 |
.B null |
| 72 |
results in the figures being replaced by empty boxes of the |
| 73 |
appropriate size. |
| 74 |
If no language is specified, |
| 75 |
.B epic |
| 76 |
is the default. |
| 77 |
.PP |
| 78 |
The names of the makefile and TeX macro file can be set with the |
| 79 |
\-M and \-T options. |
| 80 |
The default names are "Makefile" and "transfig.tex", respectively. |
| 81 |
If there is already an existing \fImakefile\fR in the directory, transfig |
| 82 |
first renames it to \fImakefile~\fR. The same holds for any existing TeX macro file. |
| 83 |
If the \-I option is specified, then a command to read in \fImacrofile\fR is |
| 84 |
inserted into the TeX macro file. |
| 85 |
If the \-V option is specified, the program version number is printed only. |
| 86 |
.PP |
| 87 |
Control specifiers are |
| 88 |
.TP |
| 89 |
\fB\-m\fI mag\fR |
| 90 |
set the magnification at which the figure is rendered (default 1.0). |
| 91 |
.TP |
| 92 |
\fB\-f\fI font\fR |
| 93 |
set the default font family used for text objects (default "\fBrm\fR"). |
| 94 |
.TP |
| 95 |
\fB\-s \fIfontsize\fR |
| 96 |
set the default font size (in points) for text objects (default 11*\fImag\fR). |
| 97 |
.TP |
| 98 |
\fB\-o \fIoption\fR |
| 99 |
pass the specified option string through to fig2dev. |
| 100 |
.PP |
| 101 |
If there is no scaling, the default font is an eleven point roman font. |
| 102 |
Language and control specifiers may occur more than once; |
| 103 |
they affect the translation of files which appear to their |
| 104 |
right in the argument list. |
| 105 |
If no files are specified, then "*.fig" is assumed. |
| 106 |
.SH "SEE ALSO" |
| 107 |
fig(l), |
| 108 |
fig2dev(l), |
| 109 |
pic(l), |
| 110 |
pic2fig(l), |
| 111 |
xfig(l) |
| 112 |
.SH COPYRIGHT |
| 113 |
Copyright (C) 1985 Supoj Sutantavibul |
| 114 |
.br |
| 115 |
Copyright (C) 1991 Micah Beck |
| 116 |
.br |
| 117 |
Parts Copyright (C) 1991-2002 Brian Smith |
| 118 |
.LP |
| 119 |
THE AUTHORS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, |
| 120 |
INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO |
| 121 |
EVENT SHALL THE AUTHORS BE LIABLE FOR ANY SPECIAL, INDIRECT OR |
| 122 |
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, |
| 123 |
DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER |
| 124 |
TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR |
| 125 |
PERFORMANCE OF THIS SOFTWARE. |
| 126 |
.LP |
| 127 |
Any party obtaining a copy of these files is granted, free of charge, a |
| 128 |
full and unrestricted irrevocable, world-wide, paid up, royalty-free, |
| 129 |
nonexclusive right and license to deal in this software and |
| 130 |
documentation files (the "Software"), including without limitation the |
| 131 |
rights to use, copy, modify, merge, publish, distribute, sublicense, |
| 132 |
and/or sell copies of the Software, and to permit persons who receive |
| 133 |
copies from any such party to do so, with the only requirement being |
| 134 |
that this copyright notice remain intact. |
| 135 |
|
| 136 |
.SH AUTHOR |
| 137 |
Micah Beck |