DataMuseum.dk

top - metrics - download

    Length: 2849 (0xb21)
    Types: TextFile
    Names: »psfigtex.1«

└─⟦52210d11f⟧ Bits:30007239 EUUGD2: TeX 3 1992-12
    └─⟦af5ba6c8e⟧ »unix3.0/DVIWARE.tar.Z« 
        └─⟦ca79c7339⟧ 
            └─⟦this⟧ »DVIware/laser-setters/mctex/psfig/psfigtex.1« 

TextFile

.TH PSFIGTEX
.SH NAME
psfigtex \- PostScript figures in TeX
.SH SYNTAX
\einput
.B psfig
.ie t .ds PS P\s-2OST\s0S\s-2CRIPT\s0
.el .ds PS PostScript
.SH DESCRIPTION
.I psfigtex
is a package that allows easy inclusion of arbitrary \*(PS code
into a TeX document.
Figures are automatically scaled and translated, and the correct amount
of space is reserved so nothing conflicts with other text on the page.
The 
.I pstex
postprocessor must be used to create the final \*(PS output.
.PP
.SH USAGE
Before using
.IR psfigtex ,
you must include the macros,
either by writing ``\einput psfig'' (in TeX)
or by including ``psfig'' as a ``\edocumenstyle'' option (in LaTeX).
Once you have done this,
you can include a \*(PS file
by invoking the psfig macro ``\epsfig{figure=fig.ps}'',
where ``fig.ps'' is the name of a \*(PS file. 
Options may be specified in the form
``\epsfig{figure=fig.ps,opt=val,opt=val...}'';
recognized options include height, width, prolog, and postlog.
If a height but not a width is given or vice-versa,
the figure will be scaled equally in both dimensions;
if neither is given, the figure's ``natural'' size will be used.
.PP
For 
.I psfig
to properly scale and move a figure,
it must be able to discover
its natural size and position on the page.
This is usually specified by
the bounding box comment in the \*(PS file.
Unfortunately,
some applications (including MacDraw) do not provide this information. 
If your figure has no bounding box comment
(a line starting with ``%%BoundingBox:''),
it cannot be used by psfigtex.
The bbfig utility can calculate the bounding box of a file
(so can a ruler).
See
.IR bbfig (1)
for information on the correct format of the comment.
Usually the bounding box comment is the second line of the file.
.SH "MACINTOSH FIGURES"
Macintosh figures require a prolog file to be downloaded containing 
\*(PS
procedure definitions.
Use the option
``prolog=/usr/lib/ps/mac.pro'' to achieve this.
See the psfigtex paper for
more detailed information, especially if there are many mac figures.
.SH "DRAFT MODE"
.PP
If a figure is very expensive to print (say a 100K image)
it can be set in draft mode,
printing just the name of the file.
The macro \epsdraft switches into draft mode;
\epsfull returns to full mode.
Use of draft mode is highly encouraged.
.SH "BUGS"
.LP
The ``\epsfig{...}'' command must be entirely on one input line, and no
extra spaces may appear in the option list.
.LP
To center a figure that appears by itself
in a LaTeX ``\ecentering'' environment,
you must include a call to ``\eleavevmode'' before ``\epsfig{...}''.
.SH AUTHOR
Trevor Darrell
.br
Minor changes for MC-TeX
(mainly editing this manual,
and turning psfig.tex into a LaTeX style file) by Chris Torek
.SH "SEE ALSO"
.IR pstex (1),
MC-TeX User's Guide
.br
T. Darrell,
.ul
Incorporating \*(PS and Macintosh figures in TeX