283 lines
9.3 KiB
HTML
283 lines
9.3 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of fig2mpdf</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>fig2mpdf</H1>
|
|
Section: Including xfig figures into LaTeX documents (1)<BR>Updated: Jun 2006<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
fig2mpdf - creation of multilayer pdf or eps figures from fig files using latex for typesetting
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>fig2mpdf</B>
|
|
|
|
[<I>OPTION</I>]... <I>FILE</I>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<P>
|
|
|
|
This tool can create pdf or eps figures using fig files as source. For beamer
|
|
presentations, for example, you can use the multilayer mode to create
|
|
multiple figures that can be overlayed to get a dynamic figure. For
|
|
proper appearance you can use latex to typeset some or all texts,
|
|
possibly containing formulas.
|
|
<P>
|
|
The default interpretation of the given fig <I>FILE</I> depends on its suffix.
|
|
<DL COMPACT>
|
|
<DT id="1"><I>fig</I><DD>
|
|
Normal conversion of a fig file. All texts are interpreted as postscript
|
|
texts and all elements of the figure are included in the resulting figure.
|
|
<DT id="2"><I>lfig</I><DD>
|
|
LaTeX interpretation of the file. All texts of the input file that have the
|
|
special bit set are typeset by pdflatex resp. latex (see: Option <B>-|+l</B>).
|
|
<DT id="3"><I>mfig</I><DD>
|
|
Multilayer file interpretation. Depending on the used depths of the
|
|
figure it is split into multiple parts. For each part an output file is
|
|
created (see: section <B>MultiLayerOutput</B>).
|
|
<DT id="4"><I>mlfig</I> or <I>lmfig</I><DD>
|
|
Combination of multilayer and LaTeX interpretation of the input (see: Suffix
|
|
<I>lfig</I> and <I>mfig</I>).
|
|
</DL>
|
|
<P>
|
|
|
|
The default interpretation of the input can be changed by using the options below.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="5"><B>-e</B><DD>
|
|
produce an eps output file. Instead of creating a pdf file (the default)
|
|
an eps figure is produced.
|
|
<DT id="6"><B>-|+l</B><DD>
|
|
force calling (pdf)latex (-) or do not use (pdf)latex (+) for
|
|
typesetting the text marked with the special flag. With this option you
|
|
can change the default behavior given by the input file suffix.
|
|
<DT id="7"><B>-|+m</B><DD>
|
|
force set (-) or unset (+) the multilayer interpretation (see:
|
|
<B>MultiLayerOutput</B> below) which was previously set by the input
|
|
file suffix.
|
|
<DT id="8"><B>-p</B> <I>ranges</I><DD>
|
|
explicitly set the ranges of depths for splitting the input figure in
|
|
multilayer mode. <I>ranges</I> is a colon separated list of ranges of
|
|
the form <I>upper-lower</I> or <I>depth</I> where <I>upper</I> is the
|
|
top and <I>lower</I> the bottom depth in the range. If you use the
|
|
<I>depth</I> form the range consist of just that depth.
|
|
<DT id="9"><B>-i</B><DD>
|
|
include the the bottommost range (that is, the one with the highest depth) into
|
|
all output figures. This is for compatibility to older versions of this
|
|
tool.
|
|
<DT id="10"><B>-I</B><DD>
|
|
turn on pyramid mode. The figure of a corresponding range in multilayer
|
|
mode includes all lower ranges too.
|
|
<DT id="11"><B>-g</B> <I>gapwidth</I><DD>
|
|
set the allowed gapwidth between two used depths to decide if these
|
|
depths should be grouped together in one range. With this option you get
|
|
more flexibility to insert objects with new depths. The default width is
|
|
zero (no gap = consecutively numbered depths are grouped together).
|
|
<DT id="12"><B>-s</B> <I>style</I><DD>
|
|
replace the default style for selecting a font family in LaTeX mode.
|
|
If this option is omitted the style `times' is set by default.
|
|
<DT id="13"><B>-H</B> <I>header</I><DD>
|
|
replace the default header sequence for creating temporary
|
|
LaTeX documents in LaTeX mode. To get maximum flexibility you can
|
|
set the entire document header in the file <I>header</I> (see:
|
|
<B>Customized Headers</B> below).
|
|
<DT id="14"><B>-G</B><DD>
|
|
in multilayer mode change the default output file pattern to the PDF
|
|
format which is <name>.page<no>.<ext>
|
|
<DT id="15"><B>-v</B><DD>
|
|
be verbose and print out all executed commands
|
|
<DT id="16"><B>-V</B><DD>
|
|
print out the version of <B>fig2mpdf</B>
|
|
</DL>
|
|
<P>
|
|
|
|
<A NAME="lbAF"> </A>
|
|
<H2>MultiLayerOutput</H2>
|
|
|
|
In xfig you can assign an individual depth to all objects of the
|
|
figure. These depths are normally used to determine the order of
|
|
printing the objects. <B>fig2mpdf</B> uses these depths to group the
|
|
objects into ranges in automatic mode (if the ranges option is
|
|
omitted). In the list of used depths, consecutively numbered depths are
|
|
grouped into one range. That is, all gaps between used depths are used
|
|
to logically split the figure. With <B>-g</B> you can set the
|
|
gapwidth which doesn't split the figure (default: zero).
|
|
<P>
|
|
|
|
The resulting list of ranges determines the number of output files. In
|
|
default mode all objects with depths assigned to one range are
|
|
collected and put into the corresponding output file. The contents of
|
|
the output files can be changed with the two Options <B>-i</B> and
|
|
<B>-I</B>.
|
|
<P>
|
|
|
|
The <B>-i</B> option reduces the number of output files by one. The
|
|
bottommost range, that is the range which consist of the highest depths
|
|
of the figure, is included into all output files.
|
|
<P>
|
|
|
|
In pyramid mode, activated by the option <B>-I</B>, the output files
|
|
contain additionally all lower ranges. With this mode you can
|
|
get stand alone figures that don't have to be overlayed to have
|
|
meaningful content.
|
|
<P>
|
|
|
|
<B>Example 1</B>
|
|
|
|
<P>
|
|
|
|
Assume that you have a fig file <I>foo.fig</I> which contains the three ranges
|
|
<I>230-233,</I>
|
|
|
|
<I>455-460</I>
|
|
|
|
and
|
|
<I>499-500.</I>
|
|
|
|
|
|
<P>
|
|
|
|
With no options set you get three output files, one per range. But if you
|
|
set the <B>-i</B> option you get the following two files where the
|
|
bottommost range is included in both of the files:
|
|
|
|
<P>
|
|
|
|
<BR> <I>foo-0.pdf</I> with ranges <I>455-460</I> and <I>499-500</I>
|
|
<P>
|
|
|
|
<BR> <I>foo-1.pdf</I> with ranges <I>230-233</I> and <I>499-500</I>.
|
|
|
|
<P>
|
|
|
|
<B>Example 2</B>
|
|
|
|
<P>
|
|
|
|
The pyramid mode, activated by the option <B>-I</B>, will produce the
|
|
following files from the source file of <B>Example 1</B>:
|
|
<P>
|
|
|
|
<BR> <I>foo-0.pdf</I> with ranges <I>499-500</I>
|
|
<P>
|
|
|
|
<BR> <I>foo-1.pdf</I> with ranges <I>455-460</I> and <I>499-500</I>
|
|
<P>
|
|
|
|
<BR> <I>foo-2.pdf</I> with ranges <I>230-233</I>, <I>455-460</I> and <I>499-500</I>.
|
|
|
|
<P>
|
|
|
|
<B>Example 3</B>
|
|
|
|
<P>
|
|
|
|
If both options are set you will get just two files with the following
|
|
contents:
|
|
<P>
|
|
|
|
<BR> <I>foo-0.pdf</I> with ranges <I>455-460</I> and <I>499-500</I>
|
|
<P>
|
|
|
|
<BR> <I>foo-1.pdf</I> with ranges <I>230-233</I>, <I>455-460</I> and <I>499-500</I>.
|
|
|
|
<P>
|
|
|
|
<A NAME="lbAG"> </A>
|
|
<H2>Customized Headers</H2>
|
|
|
|
For various reasons you might want to change the standard latex generation,
|
|
e.g., if you want to change the default font family. The following
|
|
example represents a valid header file.
|
|
<P>
|
|
The usage of this example file changes the font family to sans serif
|
|
and adds an additional search path for includegraphics to the `figures'
|
|
subdirectory.
|
|
<P>
|
|
|
|
<BR> \documentclass{article}
|
|
<P>
|
|
|
|
<BR> \usepackage{german,amssymb,amsmath}
|
|
<P>
|
|
|
|
<BR> \renewcommand{\familydefault}{\sfdefault}
|
|
<P>
|
|
|
|
<BR> \AtBeginDocument{\graphicspath{{figures/}}}
|
|
|
|
<P>
|
|
The following packages are generally used: <B>color</B>, <B>graphicx</B> and <B>epsfig</B>.
|
|
<A NAME="lbAH"> </A>
|
|
<H2>Tex errors</H2>
|
|
|
|
Sometimes it might happen that latex generates an error while processing
|
|
your special texts. To keep you informed about the occurrence of that
|
|
error and about what has happened, in this case the log file is shown
|
|
by invoking a less command.
|
|
<A NAME="lbAI"> </A>
|
|
<H2>Files</H2>
|
|
|
|
In single layer mode for the resulting files the suffix fig is replaced
|
|
by pdf (resp. eps) (i.e. foo.fig -> foo.pdf).
|
|
<P>
|
|
|
|
|
|
In multilayer mode the base name of the source fig files is extended
|
|
by '-<range>' and the suffix is set to pdf (resp. eps).
|
|
<P>
|
|
|
|
(i.e., foo.fig -> foo-0.pdf, foo-1.pdf, foo-2.pdf, ...
|
|
<P>
|
|
|
|
<BR> or foo.fig -> foo.page0.pdf, foo.page1.pdf, foo.page2.pdf, ...
|
|
<P>
|
|
|
|
<BR> if the option <B>-G</B> is set).
|
|
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<I><A HREF="/cgi-bin/man/man2html?1+xfig">xfig</A>(1)</I>
|
|
|
|
<I><A HREF="/cgi-bin/man/man2html?1+fig2dev">fig2dev</A>(1)</I>
|
|
|
|
<I><A HREF="/cgi-bin/man/man2html?1+gawk">gawk</A>(1)</I>
|
|
|
|
<I><A HREF="/cgi-bin/man/man2html?1+pdflatex">pdflatex</A>(1)</I>
|
|
|
|
<I><A HREF="/cgi-bin/man/man2html?1+latex">latex</A>(1)</I>
|
|
|
|
<I><A HREF="/cgi-bin/man/man2html?1+dvips">dvips</A>(1)</I>
|
|
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="17"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="18"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="19"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="20"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="21"><A HREF="#lbAF">MultiLayerOutput</A><DD>
|
|
<DT id="22"><A HREF="#lbAG">Customized Headers</A><DD>
|
|
<DT id="23"><A HREF="#lbAH">Tex errors</A><DD>
|
|
<DT id="24"><A HREF="#lbAI">Files</A><DD>
|
|
<DT id="25"><A HREF="#lbAJ">SEE ALSO</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:12 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|