2215 lines
60 KiB
HTML
2215 lines
60 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of fig2dev</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>fig2dev</H1>
|
|
Section: User Commands (1)<BR>Updated: May 2018<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>
|
|
|
|
fig2dev - translates Fig code to various graphics languages
|
|
<P>
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
|
|
|
|
|
|
|
|
<DL COMPACT>
|
|
<DT id="1">
|
|
<B>fig2dev</B>
|
|
|
|
<B>-L</B>
|
|
|
|
<I>language</I>
|
|
|
|
[<B>-m</B>
|
|
|
|
<I>mag</I>]
|
|
|
|
[<B>-s</B>
|
|
|
|
<I>fsize</I>]
|
|
|
|
[<B>-Z</B>
|
|
|
|
<I>maxdimension</I>]
|
|
|
|
[<B>-D</B>
|
|
|
|
<I>+/-rangelist</I>
|
|
|
|
[<B>-K</B>]]
|
|
|
|
[<I>other options</I>]
|
|
|
|
[<I>fig-file</I>
|
|
|
|
[<I>out-file</I>]]
|
|
|
|
</DL>
|
|
<P>
|
|
|
|
<B>fig2dev -h</B>|<B>-V</B>
|
|
|
|
|
|
|
|
<P>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<B>fig2dev</B>
|
|
|
|
<DD>translates fig code in the named
|
|
<I>fig-file</I>
|
|
|
|
into the specified graphics
|
|
<I>language</I>
|
|
|
|
and puts them in
|
|
<I>out-file.</I>
|
|
|
|
The default
|
|
<I>fig-file</I>
|
|
|
|
and
|
|
<I>out-file</I>
|
|
|
|
are standard input and standard output, respectively
|
|
<P>
|
|
|
|
Xfig (Facility for Interactive Generation of figures) is a screen-oriented
|
|
tool which runs under the X Window System, and
|
|
allows the user to draw and manipulate objects interactively.
|
|
This version of fig2dev is compatible with
|
|
xfig versions 1.3, 1.4, 2.0, 2.1, 3.0, 3.1 and 3.2.
|
|
<P>
|
|
|
|
Xfig version 3.2.3 and later saves and allows the user to edit comments
|
|
for each Fig object. These comments are output with several of the output languages,
|
|
such as PostScript, CGM, EMF, LaTeX, MetaFont, PicTeX, (as % comments),
|
|
tk (as # comments), and pic (as .\" comments).
|
|
<P>
|
|
<P>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>GENERAL OPTIONS (all drivers)</H2>
|
|
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="2"><B>-L language</B>
|
|
|
|
<DD>
|
|
Set the output graphics language.
|
|
Valid languages are
|
|
<B>box, cgm, dxf, epic, eepic, eepicemu, emf, eps, gbx (Gerber beta
|
|
driver), gif, ibmgl, jpeg, latex, map (HTML image map), mf (MetaFont),
|
|
mp (MetaPost), pcx, pdf, pdftex, pdftex_t, pic,
|
|
pict2e, pictex, png, ppm, ps, pstex, pstex_t, pstricks, ptk (Perl/tk),
|
|
shape (LaTeX shaped paragraphs), sld (AutoCad slide format), svg,
|
|
textyl, tiff, tikz, tk (tcl/tk), tpic, xbm and xpm</B>.
|
|
<P>
|
|
Notes:
|
|
<BR>
|
|
|
|
You must have ghostscript installed to get the pdf output, and ghostscript and
|
|
the netpbm package to get the bitmap formats (png, jpeg, etc.).
|
|
<P>
|
|
<DT id="3"><B>-h</B>
|
|
|
|
<DD>
|
|
Print help message with all options for all output languages then exit.
|
|
<P>
|
|
<DT id="4"><B>-V</B>
|
|
|
|
<DD>
|
|
Print the program version number and exit.
|
|
<P>
|
|
<DT id="5"><B>-D +/-rangelist</B>
|
|
|
|
<DD>
|
|
With <I>+rangelist</I>, keep only those depths in the list.
|
|
With <I>-rangelist</I>, keep all depths except those in the list.
|
|
The rangelist may be a list of comma-separated
|
|
numbers or ranges separated by colon (:). For example,
|
|
<B>-D +10,40,55:70,80</B>
|
|
means keep only layers 10, 40, 55 through 70, and 80.
|
|
<P>
|
|
<DT id="6"><B>-K</B>
|
|
|
|
<DD>
|
|
The selection of the depths with the <B>-D</B><I> +/-rangelist</I>
|
|
option does normally not affect the calculation of the bounding box.
|
|
Thus the generated document might have a much larger bounding box than
|
|
necessary. If
|
|
<B>-K</B>
|
|
|
|
is given then the
|
|
bounding box is adjusted to include only those objects in the selected depths.
|
|
<P>
|
|
<DT id="7"><B>-G minor[:major][:unit]</B>
|
|
|
|
<DD>
|
|
Draws a grid on the page.
|
|
Specify thin, or thin and thick line spacing in one of several units.
|
|
For example, <B>-G .25:1cm</B> draws a thin,
|
|
gray line every .25 cm and a thicker gray line every 1 cm.
|
|
Specifying <B>-G 1in</B> draws a thin line every 1 inch.
|
|
Fractions may be used, e.g. <B>-G :1/2in</B> will draw a
|
|
thick line every 1/2 inch.
|
|
<BR>
|
|
|
|
Allowable units are: i, in, inch, f, ft, feet, c, cm, mm, and m.
|
|
<BR>
|
|
|
|
<B>Only allowed for PostScript, EPS, PDF, pstricks, tikz and</B>
|
|
|
|
<B>bitmap (GIF, JPEG, etc) drivers.</B>
|
|
|
|
<P>
|
|
<DT id="8"><B>-j</B>
|
|
|
|
<DD>
|
|
Enable the I18N internationalization facility.
|
|
<P>
|
|
<DT id="9"><B>-m mag</B>
|
|
|
|
<DD>
|
|
Set the magnification at which the figure is rendered to
|
|
<I>mag.</I>
|
|
|
|
The default is 1.0.
|
|
This may not be used with the maxdimension option (<B>-Z</B>).
|
|
<P>
|
|
<DT id="10"><B>-s fsize</B>
|
|
|
|
<DD>
|
|
Set the default font size (in points, 1/72 inch) for text objects to
|
|
<I>fsize.</I>
|
|
|
|
The default is 11*mag, and thus is scaled by the <B>-m</B> option.
|
|
If there is no scaling, the default font is eleven point Roman.
|
|
<P>
|
|
<DT id="11"><B>-Z maxdimension</B>
|
|
|
|
<DD>
|
|
Scale the figure so that the maximum dimension (width or height) is
|
|
<I>maxdimension</I>
|
|
|
|
inches or cm, depending on whether the figure was saved with
|
|
imperial or metric units.
|
|
This may not be used with the magnification option (<B>-m</B>).
|
|
<P>
|
|
<DT id="12"><I>other options</I>
|
|
|
|
<DD>
|
|
The other options are specific to the choice of graphics
|
|
<I>language,</I>
|
|
|
|
as described below.
|
|
<P>
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>OPTIONS COMMON TO ALL BITMAP FORMATS</H2>
|
|
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="13"><B>-b borderwidth</B>
|
|
|
|
<DD>
|
|
Make blank border around figure of width
|
|
<I>borderwidth</I>
|
|
|
|
(1/72 inch).
|
|
<P>
|
|
<DT id="14"><B>-F</B>
|
|
|
|
<DD>
|
|
Use correct font sizes (points, 1/72 inch) instead of the traditional
|
|
size that xfig/fig2dev uses, which is 1/80 inch. The corresponding
|
|
xfig command-line option is -correct_font_size.
|
|
<P>
|
|
<DT id="15"><B>-g color</B>
|
|
|
|
<DD>
|
|
Use
|
|
<I>color</I>
|
|
|
|
for the background.
|
|
<P>
|
|
<DT id="16"><B>-N</B>
|
|
|
|
<DD>
|
|
Convert all colors to grayscale.
|
|
<P>
|
|
<DT id="17"><B>-S smoothfactor</B>
|
|
|
|
<DD>
|
|
This will smooth the output by passing
|
|
<I>smoothfactor</I>
|
|
|
|
to ghostscript in the
|
|
<I>-dTextAlphaBits</I>
|
|
|
|
and
|
|
<I>-dGraphicsAlphaBits</I>
|
|
|
|
options to improve font rendering and graphic smoothing.
|
|
A value of 2 for
|
|
<I>smoothfactor</I>
|
|
|
|
provides some smoothing and 4 provides more.
|
|
<P>
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>GIF OPTIONS</H2>
|
|
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="18"><B>-t color</B>
|
|
|
|
<DD>
|
|
Use
|
|
<I>color</I>
|
|
|
|
for the transparent color in the GIF file. This must be specified
|
|
in the same format that <A HREF="/cgi-bin/man/man2html?1+ppmmake">ppmmake</A>(1) allows.
|
|
It may allow an X11 color name, but at least you may use
|
|
a six-digit hexadecimal RGBvalue using the # sign, e.g. #ff0000 (Red).
|
|
<P>
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>JPEG OPTIONS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="19"><B>-q image_quality</B>
|
|
|
|
<DD>
|
|
use the integer value
|
|
<I>image_quality</I>
|
|
|
|
for the JPEG "Quality" factor.
|
|
Valid values are 0 - 100, with the default being 75.
|
|
<P>
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>CGM OPTIONS</H2>
|
|
|
|
CGM is Computer Graphics Metafile, developed by ISO and ANSI and is a
|
|
vector-based plus bitmap language. Microsoft WORD, PowerPoint and probably
|
|
other products can import this format
|
|
<I>and display it on the screen,</I>
|
|
|
|
something that they won't do with EPS files that have an ASCII preview.
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="20"><B>-a</B>
|
|
|
|
<DD>
|
|
Generate binary output.
|
|
<P>
|
|
<DT id="21"><B>-r</B>
|
|
|
|
<DD>
|
|
Position arrowheads for CGM viewers that display rounded arrowheads.
|
|
Normally, arrowheads are pointed, so fig2dev compensates for this by
|
|
moving the endpoint of the line back so the tip of the arrowhead ends
|
|
where the original endpoint of the line was.
|
|
If the <B>-r</B> option is used, the position
|
|
of arrows will <I>NOT</I> be corrected for compensating line width effects,
|
|
because the rounded arrowhead doesn't extend beyond the endpoint of the line.
|
|
<P>
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>DXF OPTIONS</H2>
|
|
|
|
DXF is the Drawing Interchange File Format.
|
|
The output to DXF is experimental.
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="22"><B>-a</B>
|
|
|
|
<DD>
|
|
Select ANSI A paper size instead of the
|
|
default ISO A4.
|
|
<P>
|
|
<DT id="23"><B>-d xll,yll,xur,yur</B>
|
|
|
|
<DD>
|
|
Restrict plotting to a rectangular area of the plotter paper which has
|
|
a lower left hand corner at
|
|
<I>(xll,yll)</I>
|
|
|
|
and a upper right hand corner at
|
|
<I>(xur,yur).</I>
|
|
|
|
All four numbers are in inches and follow <B>-d</B> in a comma-separated list -
|
|
<I>xll,yll,xur,yur</I>
|
|
|
|
- with no spaces between them.
|
|
<P>
|
|
<DT id="24"><B>-P</B>
|
|
|
|
<DD>
|
|
Rotate the figure to portrait mode. The default is landscape mode.
|
|
<P>
|
|
<DT id="25"><B>-v</B>
|
|
|
|
<DD>
|
|
Plot the figure upside-down in portrait mode or backwards in landscape mode.
|
|
<P>
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAK"> </A>
|
|
<H2>EMF OPTIONS</H2>
|
|
|
|
EMF is Enhanced Metafile, developed by Microsoft and is a
|
|
vector-based plus bitmap language. Microsoft WORD, PowerPoint and probably
|
|
other products can import this format
|
|
<I>and display it on the screen,</I>
|
|
|
|
something that they won't do with EPS files that have an ASCII preview.
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="26"><B>-l lang</B>
|
|
|
|
<DD>
|
|
Set the compatibility level to <I>lang</I>, where <I>lang</I> is one of
|
|
<I>win95, win98</I>
|
|
|
|
or
|
|
<I>winnt.</I>
|
|
|
|
The default is <I>winnt</I>.
|
|
<P>
|
|
<DT id="27"><B>-r</B>
|
|
|
|
<DD>
|
|
Position arrowheads for EMF viewers that display rounded arrowheads.
|
|
See the discussion of the <B>-r</B> option for the CGM output driver above.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAL"> </A>
|
|
<H2>EPIC OPTIONS</H2>
|
|
|
|
EPIC is an enhancement to LaTeX picture drawing environment.
|
|
<P>
|
|
|
|
EEPIC is an extension to EPIC and LaTeX picture drawing environment
|
|
which uses tpic specials as a graphics mechanism.
|
|
It was written by Conrad Kwok of Division of
|
|
Computer Science at University of California, Davis.
|
|
Conrad Kwok has also written the EEPIC driver of fig2dev.
|
|
<P>
|
|
|
|
EEPIC-EMU is an EEPIC emulation package which does not use tpic specials.
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="28"><B>-d factor</B>
|
|
|
|
<DD>
|
|
Scale arrowheads by
|
|
<I>factor.</I>
|
|
|
|
The width and height of arrowheads is
|
|
<I>divided</I>
|
|
|
|
by this factor.
|
|
This is because EPIC arrowheads are normally about double the size of
|
|
TeX arrowheads.
|
|
<P>
|
|
<DT id="29"><B>-E num</B>
|
|
|
|
<DD>
|
|
Set encoding for text translation (0 = none, 1 = ISO-8859-1, 2 = ISO-8859-2;
|
|
default 1).
|
|
<P>
|
|
<DT id="30"><B>-F</B>
|
|
|
|
<DD>
|
|
Don't set the font face, series, and style; only set it's size and the
|
|
baselineskip. By default, fig2dev sets all 5 font parameters when it
|
|
puts some text. The disadvantage is that you can't set the font from your
|
|
LaTeX document. With this option on, you can set the font from your LaTeX
|
|
document.
|
|
<DT id="31"><DD>
|
|
If any of the pictures included in your LaTeX document has been generated
|
|
with <B>-F</B>, then all pictures must be generated with this option.
|
|
<P>
|
|
<DT id="32"><B>-f font</B>
|
|
|
|
<DD>
|
|
Set the default font used for text objects to <I>font</I>,
|
|
where <I>font</I> is one of
|
|
<I>rm</I>, <I>bf</I>, <I>it</I>, <I>sf</I> or <I>tt</I>.
|
|
The default is <I>rm</I>.
|
|
<P>
|
|
<DT id="33"><B>-l lwidth</B>
|
|
|
|
<DD>
|
|
Use "<B>\thicklines</B>" when the width of the line is equal or wider than
|
|
<I>lwidth.</I>
|
|
|
|
The default is 2.
|
|
<P>
|
|
<DT id="34"><B>-P</B>
|
|
|
|
<DD>
|
|
Generate a complete LaTeX file. In other words, the output file can be
|
|
formatted without requiring any changes.
|
|
<P>
|
|
<DT id="35"><B>-R dummyarg</B>
|
|
|
|
<DD>
|
|
Allow rotated text. Rotated text will be set using the \rotatebox command.
|
|
So, you will need to include "<B>\usepackage{graphics}</B>" in the preamble
|
|
of your LaTeX document.
|
|
A dummy argument is required after the <B>-R</B>.
|
|
<DT id="36"><DD>
|
|
If this option is not set, then rotated text will be set horizontally.
|
|
<P>
|
|
<DT id="37"><B>-S scale</B>
|
|
|
|
<DD>
|
|
Set the scale to which the figure is rendered.
|
|
This option automatically sets the
|
|
<I>magnification</I>
|
|
|
|
and <I>fsize</I> to <I>scale</I>/12 and
|
|
<I>scale</I>
|
|
|
|
respectively.
|
|
<I>Scale</I>
|
|
|
|
must be between 8 and 12, inclusively.
|
|
<P>
|
|
<DT id="38"><B>-t stretch</B>
|
|
|
|
<DD>
|
|
Set the stretch factor of dashed lines to
|
|
<I>stretch.</I>
|
|
|
|
The default is 30.
|
|
<P>
|
|
<DT id="39"><B>-v</B>
|
|
|
|
<DD>
|
|
Include comments in the output file.
|
|
<P>
|
|
<DT id="40"><B>-W</B>
|
|
|
|
<DD>
|
|
Enable variable line width. By default, only two line widths are
|
|
available: The normal line width ("<B>\thinlines</B>"), and thick
|
|
lines ("<B>\thicklines</B>"). See also the <B>-l</B> option above.
|
|
<P>
|
|
<DT id="41"><B>-w</B>
|
|
|
|
<DD>
|
|
Disable variable line width. Only "<B>\thicklines</B>" and/or
|
|
"<B>\thinlines</B>" commands will be generated in the output file.
|
|
<P>
|
|
When variable line width option is enabled, the "<B>\thinlines</B>"
|
|
command is still used when the line width is less than
|
|
<I>LineThick</I>. One potential problem is that the width of
|
|
"<B>\thinlines</B>" is 0.4pt
|
|
but the resolution of Fig is 1/80 inch (approx. 1pt). If
|
|
<I>LineThick</I> is set to 2, normal lines will be drawn in 0.4pt
|
|
wide lines but the next line width is already 2pt. One possible
|
|
solution is to set <I>LineThick</I> to 1 and set the width of
|
|
those lines you want to be drawn in "<B>\thinlines</B>" to 0.
|
|
<P>
|
|
Due to this problem, variable line width
|
|
is disabled by default (<B>-w</B>).
|
|
<P>
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAM"> </A>
|
|
<H2>IBM-GL (HP/GL) OPTIONS</H2>
|
|
|
|
IBM-GL (IBM Graphics Language) is compatible
|
|
with HP-GL (Hewlett-Packard Graphics Language).
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="42"><B>-a</B>
|
|
|
|
<DD>
|
|
Select ANSI A paper size instead of the
|
|
default ISO A4.
|
|
<P>
|
|
<DT id="43"><B>-c</B>
|
|
|
|
<DD>
|
|
Generate instructions for an IBM 6180 Color Plotter
|
|
without an IBM Graphics Enhancement Cartridge (IBM-GEC).
|
|
<P>
|
|
<DT id="44"><B>-d xll,yll,xur,yur</B>
|
|
|
|
<DD>
|
|
Restrict plotting to a rectangular area of the plotter paper which has
|
|
a lower left hand corner at
|
|
<I>(xll,yll)</I>
|
|
|
|
and a upper right hand corner at
|
|
<I>(xur,yur).</I>
|
|
|
|
All four numbers are in inches and follow <B>-d</B> in a comma-separated list -
|
|
<I>xll,yll,xur,yur</I>
|
|
|
|
- with no spaces between them.
|
|
<P>
|
|
<DT id="45"><B>-f fontfile</B>
|
|
|
|
<DD>
|
|
Load text character specifications from the table in the
|
|
file <I>fontfile</I>.
|
|
The table must have 36 entries - one for each font plus a default.
|
|
Each entry consists of 5 numbers which specify the
|
|
<BR>
|
|
|
|
1.) standard character set (0 - 4, 6 - 9, 30 - 39),
|
|
<BR>
|
|
|
|
2.) alternate character set (0 - 4, 6 - 9, 30 - 39),
|
|
<BR>
|
|
|
|
3.) character slant angle (degrees),
|
|
<BR>
|
|
|
|
4.) character width scale factor and
|
|
<BR>
|
|
|
|
5.) character height scale factor.
|
|
<P>
|
|
<DT id="46"><B>-k</B>
|
|
|
|
<DD>
|
|
Precede output with PCL command to use HP/GL.
|
|
<P>
|
|
<DT id="47"><B>-l pattfile</B>
|
|
|
|
<DD>
|
|
Load area fill line patterns from the table in the
|
|
<I>pattfile</I>
|
|
|
|
file.
|
|
The table must have 21 entries - one for each of the area fill patterns.
|
|
Each entry consists of 5 numbers which specify the
|
|
<BR>
|
|
|
|
1.) pattern number (-1 - 6),
|
|
<BR>
|
|
|
|
2.) pattern length (inches),
|
|
<BR>
|
|
|
|
3.) fill type (1 - 5),
|
|
<BR>
|
|
|
|
4.) fill spacing (inches) and
|
|
<BR>
|
|
|
|
5.) fill angle (degrees).
|
|
<P>
|
|
<DT id="48"><B>-P</B>
|
|
|
|
<DD>
|
|
Rotate the figure to portrait mode. The default is landscape mode.
|
|
<P>
|
|
<DT id="49"><B>-p penfile</B>
|
|
|
|
<DD>
|
|
Load plotter pen specifications from the table in the
|
|
<I>penfile</I>
|
|
|
|
file.
|
|
The table must have 9 entries - one for each color plus a default.
|
|
Each entry consists of 2 numbers which specify the
|
|
<BR>
|
|
|
|
1.) pen number (1 - 8) and
|
|
<BR>
|
|
|
|
2.) pen thickness (millimeters).
|
|
<P>
|
|
<DT id="50"><B>-S speed</B>
|
|
|
|
<DD>
|
|
Set the pen speed to
|
|
<I>speed</I>
|
|
|
|
(centimeters/second).
|
|
<P>
|
|
<DT id="51"><B>-v</B>
|
|
|
|
<DD>
|
|
Plot the figure upside-down in portrait mode or backwards in landscape mode.
|
|
This allows you to write on the top surface of overhead transparencies without
|
|
disturbing the plotter ink on the bottom surface.
|
|
<P>
|
|
<DT id="52"><B>-x offset</B>
|
|
|
|
<DD>
|
|
Shift figure left by
|
|
<I>offset</I>
|
|
|
|
inches.
|
|
<P>
|
|
<DT id="53"><B>-y offset</B>
|
|
|
|
<DD>
|
|
Shift figure up by
|
|
<I>offset</I>
|
|
|
|
inches.
|
|
<P>
|
|
</DL>
|
|
<P>
|
|
|
|
Fig2dev may be installed with either ANSI A or ISO A4 default paper size.
|
|
The <B>-a</B> option selects the alternate paper size.
|
|
Fig2dev does not fill closed splines.
|
|
The IBM-GEC is required to fill other polygons.
|
|
Fig2dev may be installed for plotters with or without the IBM-GEC.
|
|
The <B>-c</B> option selects the alternate instruction set.
|
|
<P>
|
|
<P>
|
|
<A NAME="lbAN"> </A>
|
|
<H2>LATEX OPTIONS</H2>
|
|
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="54"><B>-b borderwidth</B>
|
|
|
|
<DD>
|
|
Make blank border around figure of width
|
|
<I>borderwidth</I>
|
|
|
|
(1/72 inch).
|
|
<P>
|
|
<DT id="55"><B>-d dmag</B>
|
|
|
|
<DD>
|
|
Set a separate magnification for the length of line dashes to <I>dmag</I>.
|
|
<P>
|
|
<DT id="56"><B>-E num</B>
|
|
|
|
<DD>
|
|
Set encoding for latex text translation
|
|
(0 = no translation, 1 = ISO-8859-1, 2 = ISO-8859-2; default 1).
|
|
<P>
|
|
<DT id="57"><B>-F</B>
|
|
|
|
<DD>
|
|
Don't set the font face, series, and style; only set it's size and the
|
|
baselineskip. By default, fig2dev sets all 5 font parameters when it
|
|
puts some text. The disadvantage is that you can't set the font from your
|
|
LaTeX document. With this option on, you can set the font from your LaTeX
|
|
document.
|
|
<DT id="58"><DD>
|
|
If any of the pictures included in your LaTeX document has been generated
|
|
with <B>-F</B>, then all pictures must be generated with this option.
|
|
<P>
|
|
<DT id="59"><B>-f font</B>
|
|
|
|
<DD>
|
|
Set the default font used for text objects to <I>font</I>,
|
|
where <I>font</I> is one of
|
|
<I>rm</I>, <I>bf</I>, <I>it</I>, <I>sf</I> or <I>tt</I>.
|
|
The default is <I>rm</I>.
|
|
<P>
|
|
<DT id="60"><B>-l lwidth</B>
|
|
|
|
<DD>
|
|
Sets the threshold between LaTeX thin and thick lines to
|
|
<I>lwidth</I>
|
|
|
|
pixels.
|
|
LaTeX supports only two different line widths: \thinlines and \thicklines.
|
|
Lines of width greater than
|
|
<I>lwidth</I>
|
|
|
|
pixels are drawn as \thicklines.
|
|
Also affects the size of dots in dotted line style.
|
|
The default is 1.
|
|
<P>
|
|
<DT id="61"><B>-v</B>
|
|
|
|
<DD>
|
|
Verbose mode. Include comments in the otput file.
|
|
<P>
|
|
</DL>
|
|
<P>
|
|
|
|
LaTeX cannot accurately represent all the graphics objects which can
|
|
be described by Fig.
|
|
For example, the possible slopes which lines may have are limited.
|
|
Some objects, such as spline curves, cannot be drawn at all.
|
|
Fig2latex chooses the closest possible line slope, and prints error
|
|
messages when objects cannot be drawn accurately.
|
|
<P>
|
|
<P>
|
|
<A NAME="lbAO"> </A>
|
|
<H2>MAP (HTML image map) OPTIONS</H2>
|
|
|
|
Xfig version 3.2.3 and later saves and allows the user to edit comments
|
|
for each Fig object.
|
|
The fig2dev map output language will produce an HTML image map using Fig objects
|
|
that have href="some_html_reference" in their comments.
|
|
Any Fig object except compound objects may be used for this.
|
|
Usually, besides generating the map file, you would also
|
|
generate a PNG file, which is the image to which the map refers.
|
|
<P>
|
|
For example, you may have an xfig drawing with an
|
|
imported image that has the comment
|
|
href="go_here.html" and a box object with a comment href="go_away.html".
|
|
This will produce an image map file such the user
|
|
may click on the image and the browser will load the "go_here.html" page,
|
|
or click on the box and the browser will load the "go_away.html" page.
|
|
<P>
|
|
After the map file is generated by
|
|
<I>fig2dev</I>
|
|
|
|
you will need to edit it to fill out any additional information it may need.
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="62"><B>-b borderwidth</B>
|
|
|
|
<DD>
|
|
Make blank border around figure of width <I>borderwidth</I> (1/72 inch).
|
|
<P>
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAP"> </A>
|
|
<H2>METAFONT OPTIONS</H2>
|
|
|
|
<P>
|
|
<I>Fig2dev</I>
|
|
|
|
scales the figure by 1/8 before generating METAFONT code.
|
|
The magnification can be further changed with the
|
|
<B>-m</B>
|
|
|
|
option or by giving magnification options to <B>mf</B>.
|
|
<P>
|
|
|
|
In order to process the generated METAFONT code, the mfpic macros
|
|
must be installed where
|
|
<B>mf</B>
|
|
|
|
can find them. The mfpic macro package is available at any CTAN cite
|
|
under the subdirectory: graphics/mfpic
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="63"><B>-C code</B>
|
|
|
|
<DD>
|
|
Specify the starting METAFONT font code. The default is 32.
|
|
<P>
|
|
<DT id="64"><B>-n name</B>
|
|
|
|
<DD>
|
|
Specify the name to use in the output file.
|
|
<P>
|
|
<DT id="65"><B>-p pen_magnification</B>
|
|
|
|
<DD>
|
|
Specify how much the line width should be magnified compared to the
|
|
original figure. The default is 1.
|
|
<P>
|
|
<DT id="66"><B>-t top</B>
|
|
|
|
<DD>
|
|
Specify the top of the whole coordinate system.
|
|
The default is <B>ypos</B>.
|
|
<P>
|
|
<DT id="67"><B>-x xmin</B>
|
|
|
|
<DD>
|
|
Specify the minimum x coordinate value of the figure (inches). The
|
|
default is 0.
|
|
<P>
|
|
<DT id="68"><B>-y ymin</B>
|
|
|
|
<DD>
|
|
Specify the minimum y coordinate value of the figure (inches). The
|
|
default is 0.
|
|
<P>
|
|
<DT id="69"><B>-X xmax</B>
|
|
|
|
<DD>
|
|
Specify the maximum x coordinate value of the figure (inches). The
|
|
default is 8.
|
|
<P>
|
|
<DT id="70"><B>-Y ymax</B>
|
|
|
|
<DD>
|
|
Specify the maximum y coordinate value of the figure (inches). The
|
|
default is 8.
|
|
<P>
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAQ"> </A>
|
|
<H2>METAPOST OPTIONS</H2>
|
|
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="71"><B>-d file</B>
|
|
|
|
<DD>
|
|
Include file content as additional header.
|
|
<P>
|
|
<DT id="72"><B>-i file</B>
|
|
|
|
<DD>
|
|
Include file content via \input-command.
|
|
<P>
|
|
<DT id="73"><B>-M</B>
|
|
|
|
<DD>
|
|
Multipage mode, generate one figure for each depth.
|
|
<P>
|
|
<DT id="74"><B>-o</B>
|
|
|
|
<DD>
|
|
Old mode (no latex).
|
|
<P>
|
|
<DT id="75"><B>-p number</B>
|
|
|
|
<DD>
|
|
Adds the line "prologues:=number" to the output.
|
|
<P>
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAR"> </A>
|
|
<H2>PIC OPTIONS</H2>
|
|
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="76"><B>-f font</B>
|
|
|
|
<DD>
|
|
Set the default font used for text objects to <I>font</I>,
|
|
where <I>font</I> is one of
|
|
<I>R</I> (roman), <I>B</I> (bold), <I>I</I> (italic), <I>H</I> (sans serif)
|
|
or <I>C</I> (typewriter).
|
|
The default is <I>R</I>.
|
|
<P>
|
|
<DT id="77"><B>-p ext</B>
|
|
|
|
<DD>
|
|
Enables the use of certain PIC extensions which are known to work with
|
|
the groff package; compatibility with DWB PIC is unknown.
|
|
The extensions enabled by each option are:
|
|
</DL>
|
|
<P>
|
|
|
|
<PRE>
|
|
|
|
<B>arc</B> Allow ARC_BOX i.e. use rounded corners
|
|
<BR>
|
|
<B>line</B> Use the 'line_thickness' value
|
|
<BR>
|
|
<B>fill</B> Allow ellipses to be filled
|
|
<BR>
|
|
<B>all</B> Use all of the above
|
|
<BR>
|
|
<B>psfont</B> Don't convert PostScript fonts generic type
|
|
(useful for files going to be Ditroff'ed for
|
|
and printed on PS printer). DWB-compatible.
|
|
<BR>
|
|
<B>allps</B> Use all of the above (i.e. "all" + "psfont")
|
|
</PRE>
|
|
|
|
<P>
|
|
<A NAME="lbAS"> </A>
|
|
<H2>PICT2E OPTIONS</H2>
|
|
|
|
PICT2E is an enhancement to the LaTeX picture environment. It is enabled by
|
|
inserting "<B>\usepackage{pict2e}</B>" in the document preamble. Depending on
|
|
the content of the figure, it may be necessary to also include
|
|
"<B>\usepackage{color}</B>" and "<B>\usepackage{graphics}</B>". Figures produced
|
|
with the PICT2E driver can be processed with any LaTeX engine, e.g., LaTeX +
|
|
dvips, LaTeX + dvipdfm, pdflatex, xelatex, ConTeX, etc.
|
|
Pattern fills are not supported by the PICT2E output language. The PICT2E driver
|
|
renders patterns by filling the respective area with the pen-color at 25%
|
|
intensity, i.e., a 75% tint of the pen-color.
|
|
The PICT2E driver allows one to choose any font available to the LaTeX engine,
|
|
including PostScript fonts.
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="78"><B>-b borderwidth</B>
|
|
|
|
<DD>
|
|
Make blank border around figure of width <I>borderwidth</I>*(1/72) inches.
|
|
<P>
|
|
<DT id="79"><B>-C num</B>
|
|
|
|
<DD>
|
|
Do not emit a \color-command for the color number <B>num</B>. (0 = black,
|
|
1 = blue, 2 = green - see the color chooser widget in Xfig).
|
|
By default, <I>fig2dev</I> does not issue a \color-command
|
|
for objects which have the color set to "Default" in xfig.
|
|
With this option, the "\color"-command is also omitted for objects having the
|
|
color <B>num</B>.
|
|
The color of these objects, as well as of those having the color set to
|
|
"Default", is picked up from the including LaTeX-document.
|
|
<P>
|
|
The option <B>-C 0</B> is particularly useful.
|
|
By default, xfig starts with the color set to black.
|
|
Then, <I>fig2dev</I> emits "\color{black}" commands,
|
|
and the color-package must be included in the document preamble.
|
|
For black text and black-and-white drawings, this is superfluous.
|
|
<P>
|
|
<DT id="80"><B>-e</B>
|
|
|
|
<DD>
|
|
Do not try to be compatible with epic/eepic.
|
|
By default, you can include "<B>\usepackage{pict2e, epic, eepic}</B>"
|
|
(in this order!) in the document preamble and mix LaTeX pictures using
|
|
the epic/eepic command set and pictures produced with the PICT2E output
|
|
language within one document. With this option on, epic or eepic
|
|
pictures can not be mixed with PICT2E-pictures.
|
|
<P>
|
|
By default, <I>fig2dev</I> avoids the use of
|
|
the "\circle" and "\oval"-commands, which are defined by epic, in lieu of the
|
|
"\circlearc"-command exclusive to pict2e. In addition, line widths are not only
|
|
set using "\linethickness", but also with the eepic-command
|
|
"\allinethickness" (if it is defined).
|
|
<P>
|
|
<DT id="81"><B>-E num</B>
|
|
|
|
<DD>
|
|
Set encoding for text translation (0 = no translation, 1 = ISO-8859-1, 2 =
|
|
ISO-8859-2; default 1).
|
|
For instance, to use utf8-encoded text, first <I>create</I> a text object, then
|
|
<I>edit</I>
|
|
the text using the edit-button in xfig. Convert the fig-file to pict2e with
|
|
the option <B>-E 0</B> and include "<B>\usepackage[utf8]{inputenc}</B>"
|
|
in the LaTeX file
|
|
In xfig, the text typed in may not be displayed correctly, but the document
|
|
produced from the LaTeX file will show the same text as was typed in.
|
|
<P>
|
|
<DT id="82"><B>-F</B>
|
|
|
|
<DD>
|
|
Do not set the font family, series or shape.
|
|
By default, <I>fig2dev</I> sets the font family, series, shape, font size and
|
|
baselineskip.
|
|
With this option on, the text font can be set from the including
|
|
LaTeX-document, e.g.,
|
|
"<B>\itshape \input{fig1.pict2e}</B>".
|
|
See also <B>-o</B> (no font size).
|
|
<P>
|
|
<DT id="83"><B>-f font</B>
|
|
|
|
<DD>
|
|
Set the default font used for text objects to <I>font</I>.
|
|
The string <I>font</I> may be one of
|
|
<I>rm</I>, <I>bf, it</I>, <I>sf</I>, <I>tt</I>,
|
|
<I>\rmfamily</I>, <I>\bfseries</I>, <I>\itshape</I>, <I>\sffamily</I>,
|
|
<I>\ttfamily</I>,
|
|
or one of the 35 standard PostScript font names.
|
|
The default is <I>\rmfamily</I>.
|
|
<P>
|
|
<DT id="84"><B>-i dir</B>
|
|
|
|
<DD>
|
|
Prepend the string <I>dir</I> to graphics files included in the pict2e-picture.
|
|
For instance, having imported "image.jpg" in xfig, with
|
|
<B>-i '$HOME/Figures/'</B> the code "\incudegraphics{$HOME/Figures/image.jpg}"
|
|
will be generated.
|
|
<P>
|
|
<DT id="85"><B>-o</B>
|
|
|
|
<DD>
|
|
Do not set the font size or baselineskip. Text will be rendered at the size that
|
|
is in force where the pict2e-code is inserted into the LaTeX-document, e.g.,
|
|
"<B>\small \input{fig1.pict2e}</B>".
|
|
See also <B>-F</B> (no font properties).
|
|
<P>
|
|
<DT id="86"><B>-O</B>
|
|
|
|
<DD>
|
|
Do not quote characters special to TeX/LaTeX.
|
|
Useful to get, e.g., an italic <I>x</I>, not $x$,
|
|
because it was forgotten to set the text-flag "special-text" in xfig.
|
|
This option effectively sets the "special-text" flag for all text.
|
|
<P>
|
|
<DT id="87"><B>-P</B>
|
|
|
|
<DD>
|
|
Pagemode, generate a stand-alone LaTeX-file as <I>out-file</I>. The document
|
|
produced from the
|
|
LaTeX-file will have the paper size equal to the figure's
|
|
bounding box (but see the <B>-b</B> option to add a margin).
|
|
The generated LaTeX-file calls the package "geometry.sty" to set the paper size.
|
|
<P>
|
|
<DT id="88"><B>-R num</B>
|
|
|
|
<DD>
|
|
Replace arrowheads <I>num</I> by LaTeX-arrows ("\vector"). The number of
|
|
an arrowhead ("Arrow Type" in xfig) can be found by opening the arrow chooser
|
|
widget in xfig and counting the arrows, starting from 1.
|
|
For instance, to replace filled triangle arrowheads with LaTeX
|
|
\vector-commands, use <B>-R 3</B>.
|
|
<P>
|
|
<DT id="89"><B>-r</B>
|
|
|
|
<DD>
|
|
Replace all arrows by LaTeX-arrows.
|
|
<P>
|
|
<DT id="90"><B>-T</B>
|
|
|
|
<DD>
|
|
Only use TeX fonts, even where PostScript-fonts are specified.
|
|
<P>
|
|
<DT id="91"><B>-v</B>
|
|
|
|
<DD>
|
|
Verbose mode. Write comment lines into the output file, usually naming the
|
|
type of the object that is drawn.
|
|
<P>
|
|
<DT id="92"><B>-w</B>
|
|
|
|
<DD>
|
|
Remove the suffix from included graphics-files.
|
|
With this option on, <I>fig2dev</I> generates code that contains, e.g.,
|
|
"<B>\includegraphics{fig1}</B>",
|
|
instead of "<B>\includegraphics{fig1.eps}</B>".
|
|
<P>
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAT"> </A>
|
|
<H2>PICTEX OPTIONS</H2>
|
|
|
|
In order to include PiCTeX pictures into a document, it is necessary to
|
|
load the PiCTeX macros.
|
|
<P>
|
|
|
|
PiCTeX uses TeX integer register arithmetic to generate curves,
|
|
and so it is very slow.
|
|
PiCTeX draws curves by <B>\put</B>-ing the <I>psymbol</I> repeatedly,
|
|
and so requires a large amount of TeX's internal memory,
|
|
and generates large DVI files.
|
|
The size of TeX's memory limits the number of plot symbols in a picture.
|
|
As a result, it is best to use PiCTeX to generate small pictures.
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="93"><B>-a</B>
|
|
|
|
<DD>
|
|
Anonymous mode. Do not write the user name into the output file.
|
|
<P>
|
|
<DT id="94"><B>-E num</B>
|
|
|
|
<DD>
|
|
Set encoding for latex text translation
|
|
(0 = no translation, 1 = ISO-8859-1, 2 = ISO-8859-2; default 1).
|
|
<P>
|
|
<DT id="95"><B>-f font</B>
|
|
|
|
<DD>
|
|
Set the default font used for text objects to <I>font</I>,
|
|
where <I>font</I> is one of
|
|
<I>rm</I>, <I>bf</I>, <I>it</I>, <I>sf</I> or <I>tt</I>.
|
|
The default is <I>rm</I>.
|
|
<P>
|
|
<DT id="96"><B>-l dimen</B>
|
|
|
|
<DD>
|
|
Set line thickness to <I>dimen</I>. Default "1pt".
|
|
<P>
|
|
<DT id="97"><B>-p psymbol</B>
|
|
|
|
<DD>
|
|
Set the <I>psymbol</I>.
|
|
Default "\makebox(0,0)[l]{\tencirc\symbol{'160}}".
|
|
<P>
|
|
<DT id="98"><B>-r</B>
|
|
|
|
<DD>
|
|
Do not allow rotated text. Otherwise, files with PiCTeX macros and
|
|
rotated text need to be processed with <I>dvips</I>.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAU"> </A>
|
|
<H2>GBX OPTIONS (Gerber, RS-247-X)</H2>
|
|
|
|
Typically you will wish to set the y scale to -1. See
|
|
<B>-g</B>
|
|
|
|
for more information.
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="99"><B>-d [mm|in]</B>
|
|
|
|
<DD>
|
|
Output dimensions should be assumed to be millimeters (mm) or inches
|
|
(in). The default is millimeters.
|
|
<P>
|
|
<DT id="100"><B>-p [pos|neg]</B>
|
|
|
|
<DD>
|
|
Select the image polarity. For positive images lines drawn in the fig
|
|
file will generate lines of material. For negative images lines drawn
|
|
in the fig file will result in removed material. Consider etching a
|
|
chrome on glass transmission mask. Drawing lines in the fig file and
|
|
choosing 'neg' will result in these lines being etched through the
|
|
chrome, leaving transparent lines.
|
|
<P>
|
|
<DT id="101"><B>-g <x scale>x<y scale>+<x offset>+<y offset></B>
|
|
|
|
<DD>
|
|
This controls the geometry of the output, scaling the dimensions as
|
|
shown and applying the given offset. Typically you will wish to set
|
|
the y scale to -1, mirroring about the x axis. This is because Gerber
|
|
assumes the origin to be bottom left, while xfig selects top left.
|
|
<P>
|
|
<DT id="102"><B>-f <n digits>.<n digits></B>
|
|
|
|
<DD>
|
|
This controls the number of digits of precision before and after the
|
|
implied decimal point. With <B>-f 5.3</B> the following number 12345678
|
|
corresponds to 12345.678.
|
|
Whereas with <B>-f 3.5</B> it corresponds to 123.45678.
|
|
The default is for 3 places before the decimal point and 5 after.
|
|
This corresponds, to a range of 0 to 1m in 10 micron increments.
|
|
<P>
|
|
<DT id="103"><B>-v</B>
|
|
|
|
<DD>
|
|
Output comments describing the type of objects being output.
|
|
The text appears as comments starting with ## on each line in the output file.
|
|
<P>
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAV"> </A>
|
|
<H2>POSTSCRIPT, ENCAPSULATED POSTSCRIPT (EPS), and PDF OPTIONS</H2>
|
|
|
|
With PostScript, xfig can be used to create multiple page figures.
|
|
Specify the <B>-M</B> option to produce a multi-page output.
|
|
For posters, add <B>-O</B> to overlap the pages slightly to get around the
|
|
problem of the unprintable area in most printers, then cut and paste the pages
|
|
together.
|
|
Great for text with very big letters.
|
|
<P>
|
|
|
|
The EPS driver has the following differences from PostScript:
|
|
<BR>
|
|
|
|
|
|
o No showpage is generated because the output is meant to be imported
|
|
into another program or document and not printed
|
|
<BR>
|
|
|
|
o The landscape/portrait options are ignored
|
|
<BR>
|
|
|
|
o The centering option is ignored
|
|
<BR>
|
|
|
|
o The multiple-page option is ignored
|
|
<BR>
|
|
|
|
o The paper size option is ignored
|
|
<BR>
|
|
|
|
o The x/y offset options are ignored
|
|
<P>
|
|
|
|
The EPS driver has the following two special options:
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="104"><B>-B 'Wx [Wy X0 Y0]'</B>
|
|
|
|
<DD>
|
|
This specifies that the bounding box of the EPS file should have the
|
|
width <I>Wx</I> and the height <I>Wy</I>.
|
|
Note that it doesn't scale the figure to this size,
|
|
it merely sets the bounding box.
|
|
If a value less than or equal to 0 is specified for <I>Wx</I> or <I>Wy</I>,
|
|
these are set to the width/height respectively of the figure.
|
|
Origin is relative to screen (0,0) (upper-left).
|
|
<I>Wx</I>, <I>Wy</I>, <I>X0</I> and <I>Y0</I> are interpreted in centimeters or
|
|
inches depending on the measure given in the fig-file.
|
|
Remember to put either quotes (") or apostrophes (') to group the arguments to
|
|
<B>-B</B>.
|
|
<P>
|
|
<DT id="105"><B>-R 'Wx [Wy X0 Y0]'</B>
|
|
|
|
<DD>
|
|
Same as the <B>-B</B> option except that <I>X0</I> and <I>Y0</I>
|
|
is relative to the lower left corner of the
|
|
<B>figure.</B>
|
|
|
|
Remember to put either quotes (") or apostrophes (') to group the arguments to
|
|
<B>-R</B>.
|
|
<P>
|
|
</DL>
|
|
<P>
|
|
|
|
The PDF driver accepts all of the PostScript options, if the
|
|
<B>-P</B>
|
|
|
|
(pagemode) option is given.
|
|
In this case, the size of the PDF is the pagesize given
|
|
in the file or set from the command line via the
|
|
<B>-z</B>
|
|
|
|
option.
|
|
Otherwise, if
|
|
<B>-P</B>
|
|
|
|
is not given, the PDF is cropped to the bounding box of the figure
|
|
(optionally with a blank border margin set by the <B>-b</B> option),
|
|
and all of the EPS options are supported.
|
|
<P>
|
|
<P>
|
|
|
|
Text can now include various ISO-character codes above 0x7f, which is
|
|
useful for language specific characters to be printed directly.
|
|
Not all ISO-characters are implemented.
|
|
<P>
|
|
|
|
Color support: Colored objects created by Fig can be printed
|
|
on a color postscript printer. There are 32 standard colors:
|
|
black, yellow, white, gold,
|
|
five shades of blue, four shades of green,
|
|
four shades of cyan, four shades of red, five shades of magenta,
|
|
four shades of brown, and four shades of pink.
|
|
In addition there may be user-defined colors in the file. See the
|
|
xfig FORMAT3.2 file for the definition of these colors.
|
|
On a monochrome printer, colored objects will be mapped into different
|
|
grayscales by the printer.
|
|
Filled objects are printed using the given area fill and color.
|
|
There are 21 "shades" going from black to full saturation of the fill color,
|
|
and 21 more "tints" from full saturation + 1 to white.
|
|
In addition, there are 16 patterns such as bricks, diagonal lines,
|
|
crosshatch, etc.
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="106"><B>-A</B>
|
|
|
|
<DD>
|
|
Add an ASCII (EPSI) preview.
|
|
Not for PDF.
|
|
<P>
|
|
<DT id="107"><B>-a</B>
|
|
|
|
<DD>
|
|
Anonymous mode. Do not write the user's login name into the output file.
|
|
<P>
|
|
<DT id="108"><B>-b borderwidth</B>
|
|
|
|
<DD>
|
|
Make blank border around figure of width
|
|
<I>borderwidth</I>
|
|
|
|
(1/72 inch).
|
|
<P>
|
|
<DT id="109"><B>-C dummy_arg</B>
|
|
|
|
<DD>
|
|
Add a color *binary* TIFF preview for Microsoft products that need a binary
|
|
preview.
|
|
See also -T (monochrome preview).
|
|
A dummy argument must be supplied for historical reasons.
|
|
Not for PDF output.
|
|
<P>
|
|
<DT id="110"><B>-c</B>
|
|
|
|
<DD>
|
|
Center the figure on the page.
|
|
The centering may not be accurate if there are texts in the
|
|
<I>fig_file</I>
|
|
|
|
that extends too far to the right of other objects.
|
|
<P>
|
|
<DT id="111"><B>-e</B>
|
|
|
|
<DD>
|
|
Put the figure against the edge (not centered) of the page.
|
|
Not available in EPS.
|
|
<P>
|
|
<DT id="112"><B>-F</B>
|
|
|
|
<DD>
|
|
Use correct font sizes (points, 1/72 inch) instead of the traditional size that
|
|
xfig/fig2dev uses, which is 1/80 inch.
|
|
The corresponding xfig command-line option is -correct_font_size.
|
|
<P>
|
|
<DT id="113"><B>-f font</B>
|
|
|
|
<DD>
|
|
Set the default font used for text objects to <I>font</I>,
|
|
where <I>font</I> is one of the 35 standard PostScript font names.
|
|
The default is <I>Times-Roman</I>.
|
|
<P>
|
|
<DT id="114"><B>-g color</B>
|
|
|
|
<DD>
|
|
Use
|
|
<I>color</I>
|
|
|
|
for the background.
|
|
<P>
|
|
<DT id="115"><B>-l dummy_arg</B>
|
|
|
|
<DD>
|
|
Generate figure in landscape mode. The dummy argument is ignored,
|
|
but must appear on the command line for reasons of compatibility.
|
|
This option will override the orientation specification in the
|
|
file (for file versions 3.0 and higher).
|
|
Not available in EPS.
|
|
<P>
|
|
<DT id="116"><B>-M</B>
|
|
|
|
<DD>
|
|
Generate multiple pages if figure exceeds paper size.
|
|
Not available in EPS.
|
|
<P>
|
|
<DT id="117"><B>-N</B>
|
|
|
|
<DD>
|
|
Convert all colors to grayscale.
|
|
<P>
|
|
<DT id="118"><B>-n name</B>
|
|
|
|
<DD>
|
|
Set the Title part of the PostScript output to
|
|
<I>name.</I>
|
|
|
|
This is useful when the input to
|
|
<I>fig2dev</I>
|
|
|
|
comes from standard input.
|
|
<P>
|
|
<DT id="119"><B>-O</B>
|
|
|
|
<DD>
|
|
When used with <B>-M</B>,
|
|
overlaps the pages slightly to get around the problem of
|
|
the unprintable area in most printers.
|
|
Not available in EPS.
|
|
<P>
|
|
<DT id="120"><B>-p dummy_arg</B>
|
|
|
|
<DD>
|
|
Generate figure in portrait mode. The dummy argument is ignored,
|
|
but must appear on the command line for reasons of compatibility.
|
|
This option will override the orientation specification in the
|
|
file (for file versions 3.0 and higher).
|
|
This is the default for Fig files of version 2.1 or lower.
|
|
Not available in EPS.
|
|
<P>
|
|
<DT id="121"><B>-T</B>
|
|
|
|
<DD>
|
|
Add a monochrome *binary* TIFF preview for Microsoft products that need a binary preview.
|
|
See also <B>-C</B> (color preview).
|
|
Not available for PDF output.
|
|
<P>
|
|
<DT id="122"><B>-x offset</B>
|
|
|
|
<DD>
|
|
Shift the figure in the X direction by <I>offset</I>
|
|
PostScript points (1/72 inch).
|
|
A negative value shifts the figure to the left and
|
|
a positive value to the right.
|
|
Not available in EPS.
|
|
<P>
|
|
<DT id="123"><B>-y offset</B>
|
|
|
|
<DD>
|
|
Shift the figure in the Y direction by <I>offset</I>
|
|
points (1/72 inch).
|
|
A negative value shifts the figure up and a positive value down.
|
|
Not available in EPS.
|
|
<P>
|
|
<DT id="124"><B>-z papersize</B>
|
|
|
|
<DD>
|
|
Set the papersize.
|
|
Not available in EPS.
|
|
<BR>
|
|
|
|
Available paper sizes are:
|
|
<BR>
|
|
|
|
|
|
<TABLE>
|
|
<TR VALIGN=top><TD><I>Letter</I></TD><TD>(8.5" x 11" also <I>A</I>),<BR></TD></TR>
|
|
<TR VALIGN=top><TD><I>Legal</I></TD><TD>( 11" x 14")<BR></TD></TR>
|
|
<TR VALIGN=top><TD><I>Ledger</I></TD><TD>( 11" x 17"),<BR></TD></TR>
|
|
<TR VALIGN=top><TD><I>Tabloid</I></TD><TD>( 17" x 11", really <I>Ledger</I> in Landscape mode),<BR></TD></TR>
|
|
<TR VALIGN=top><TD><I>A</I></TD><TD>(8.5" x 11" also <I>Letter</I>),<BR></TD></TR>
|
|
<TR VALIGN=top><TD><I>B</I></TD><TD>( 11" x 17" also <I>Ledger</I>),<BR></TD></TR>
|
|
<TR VALIGN=top><TD><I>C</I></TD><TD>( 17" x 22"),<BR></TD></TR>
|
|
<TR VALIGN=top><TD><I>D</I></TD><TD>( 22" x 34"),<BR></TD></TR>
|
|
<TR VALIGN=top><TD><I>E</I></TD><TD>( 34" x 44"),<BR></TD></TR>
|
|
<TR VALIGN=top><TD><I>A9</I></TD><TD>( 37 mm x 52 mm),<BR></TD></TR>
|
|
<TR VALIGN=top><TD><I>A8</I></TD><TD>( 52 mm x 74 mm),<BR></TD></TR>
|
|
<TR VALIGN=top><TD><I>A7</I></TD><TD>( 74 mm x 105 mm),<BR></TD></TR>
|
|
<TR VALIGN=top><TD><I>A6</I></TD><TD>(105 mm x 148 mm),<BR></TD></TR>
|
|
<TR VALIGN=top><TD><I>A5</I></TD><TD>(148 mm x 210 mm),<BR></TD></TR>
|
|
<TR VALIGN=top><TD><I>A4</I></TD><TD>(210 mm x 297 mm),<BR></TD></TR>
|
|
<TR VALIGN=top><TD><I>A3</I></TD><TD>(297 mm x 420 mm),<BR></TD></TR>
|
|
<TR VALIGN=top><TD><I>A2</I></TD><TD>(420 mm x 594 mm),<BR></TD></TR>
|
|
<TR VALIGN=top><TD><I>A1</I></TD><TD>(594 mm x 841 mm),<BR></TD></TR>
|
|
<TR VALIGN=top><TD><I>A0</I></TD><TD>(841 mm x1189 mm),<BR></TD></TR>
|
|
<TR VALIGN=top><TD><I>B10</I></TD><TD>( 32 mm x 45 mm),<BR></TD></TR>
|
|
<TR VALIGN=top><TD><I>B9</I></TD><TD>( 45 mm x 64 mm),<BR></TD></TR>
|
|
<TR VALIGN=top><TD><I>B8</I></TD><TD>( 64 mm x 91 mm),<BR></TD></TR>
|
|
<TR VALIGN=top><TD><I>B7</I></TD><TD>( 91 mm x 128 mm),<BR></TD></TR>
|
|
<TR VALIGN=top><TD><I>B6</I></TD><TD>(128 mm x 182 mm),<BR></TD></TR>
|
|
<TR VALIGN=top><TD><I>B5</I></TD><TD>(182 mm x 257 mm),<BR></TD></TR>
|
|
<TR VALIGN=top><TD><I>B4</I></TD><TD>(257 mm x 364 mm),<BR></TD></TR>
|
|
<TR VALIGN=top><TD><I>B3</I></TD><TD>(364 mm x 515 mm),<BR></TD></TR>
|
|
<TR VALIGN=top><TD><I>B2</I></TD><TD>(515 mm x 728 mm),<BR></TD></TR>
|
|
<TR VALIGN=top><TD><I>B1</I></TD><TD>(728 mm x1030 mm),<BR></TD></TR>
|
|
<TR VALIGN=top><TD><I>B0</I></TD><TD>(1030mm x1456 mm).<BR></TD></TR>
|
|
</TABLE>
|
|
|
|
|
|
<BR>
|
|
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAW"> </A>
|
|
<H2>PSTEX and PDFTEX OPTIONS</H2>
|
|
|
|
The
|
|
<B>pstex</B>
|
|
|
|
and
|
|
<B>pdftex</B>
|
|
|
|
languages are a variant of
|
|
<B>ps</B>
|
|
|
|
which suppress text that has the text flag "TeX Text" set.
|
|
The
|
|
<B>pstex_t</B>
|
|
|
|
and
|
|
<B>pdftex_t</B>
|
|
|
|
languages have the complementary behavior: they generate only the
|
|
text that has the "Tex Text" flag set and the commands
|
|
necessary to position this text. They also generate the commands necessary
|
|
to overlay the PostScript or PDF file generated using <B>pstex</B>/<B>pdftex</B>.
|
|
These two drivers can be used to generate a figure which combines the
|
|
flexibility of PostScript graphics with LaTeX text formatting of
|
|
text flagged as "TeX Text".
|
|
<P>
|
|
|
|
The pstex and pdftex drivers accept the same options that the EPS driver
|
|
accepts.
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="125"><B>-n name</B>
|
|
|
|
<DD>
|
|
Set the Title part of the PostScript output to
|
|
<I>name.</I>
|
|
|
|
This is useful when the input to
|
|
<I>fig2dev</I>
|
|
|
|
comes from standard input.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAX"> </A>
|
|
<H2>PSTEX_T and PDFTEX_T OPTIONS</H2>
|
|
|
|
The <B>pstex_t</B> and <B>pdftex_t</B> languages produce only the text flagged
|
|
with the "TeX Text" flag, the commands necessary to position this text, and the
|
|
commands necessary to overlay the PostScript or PDF file generated using
|
|
<B>pstex</B>
|
|
|
|
or
|
|
<B>pdftex</B>
|
|
|
|
(see above).
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="126"><B>-E num</B>
|
|
|
|
<DD>
|
|
Set encoding for latex text translation
|
|
(0 no translation, 1 ISO-8859-1, 2 ISO-8859-2; default 1)
|
|
<P>
|
|
<DT id="127"><B>-F</B>
|
|
|
|
<DD>
|
|
Don't set the font face, series, and style; only set it's size and the
|
|
baselineskip. By default, fig2dev sets all 5 font parameters when it
|
|
puts some text. The disadvantage is that you can't set the font from your
|
|
LaTeX document. With this option on, you can set the font from your LaTeX
|
|
document (like "<B>\sfshape \input picture.eepic</B>").
|
|
<P>
|
|
<DT id="128"><B>-p file</B>
|
|
|
|
<DD>
|
|
specifies the name of the PostScript file to be overlaid.
|
|
If not set or its value is null then no PS file will be inserted.
|
|
<P>
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAY"> </A>
|
|
<H2>PSTricks OPTIONS</H2>
|
|
|
|
The
|
|
<B>PSTricks</B>
|
|
|
|
driver provides full
|
|
<B>LaTeX</B>
|
|
|
|
text and math formatting for XFig drawings without overlaying
|
|
separate outputs as in the
|
|
<B>PSTEX</B>
|
|
|
|
methods. The output matches the quality of output of the PostScript
|
|
driver except for text, where the
|
|
<B>Latex</B>
|
|
|
|
font selection mechanism is used as for other
|
|
<I>fig2dev</I>
|
|
|
|
LaTeX drivers. In addition, text is rendered black, although font color-changing
|
|
<B>LaTex</B>
|
|
|
|
code can be embedded in the drawing.
|
|
The generated PSTricks code is meant to be
|
|
readable. Each command stands alone, not relying on
|
|
global option state variables. Thus the user can easily use
|
|
XFig to rough out a PSTricks drawing, then finish by hand editing.
|
|
<P>
|
|
|
|
To use the driver's output, give the command
|
|
"<B>\usepackage{pstricks}</B>"
|
|
in your document preamble. The
|
|
<B>graphicx</B>
|
|
|
|
and
|
|
<B>pstricks-add</B>
|
|
|
|
packages may also be required. The former is used for bitmap graphics
|
|
and the second for complex line styles and/or hollow PSTricks arrows
|
|
(with the -R 1 option). The driver will tell
|
|
you which packages are needed. In the document body, include the
|
|
figure with "<B>\input{pstfile}</B>" where
|
|
<B>pstfile.tex</B>
|
|
|
|
is the output file. Use the
|
|
<B>XFig special</B>
|
|
|
|
flag to have text passed as-is to LaTeX. For non-special text,
|
|
the same mechanism as the LaTeX and epic driver mechanism is used
|
|
to match font specs, but this is imprecise.
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="129"><B>Known bugs and limitations.</B>
|
|
|
|
<DD>
|
|
PSTricks support for join styles is version dependent. Raw postscript
|
|
is inserted with "<B>\pstVerb</B>" for old versions when other than
|
|
angle joins are needed. The
|
|
<B>-t</B>
|
|
|
|
option controls this behavior. PSTricks does not support rotated
|
|
ellipses directly, so a
|
|
<B>rput</B>
|
|
|
|
command is emitted that rotates and locates a horizontal ellipse.
|
|
This makes a problem with hatch patterns, which are moved and
|
|
rotated along with the ellipse. Hatch rotation is fixed by a
|
|
counter-rotation, but the origin is not adjusted, so
|
|
registration with adjacent hatch patterns will be incorrect. Flipped
|
|
bitmap graphics use an undocumented feature of the
|
|
<B>graphicx</B>
|
|
|
|
package: a negative height flips the image vertically. This
|
|
appears to work reliably. However, you may want to flip graphics
|
|
with another program before including them in
|
|
<B>Xfig</B>
|
|
|
|
drawings just to be sure. With the
|
|
<B>-p</B>
|
|
|
|
option, the driver attempts to convert non-EPS pictures to EPS
|
|
with the TeX distribution's
|
|
<B>bmeps</B>
|
|
|
|
program, but
|
|
<B>bmeps</B>
|
|
|
|
does not know about very many file formats including <B>gif</B>.
|
|
<P>
|
|
<DT id="130"><B>-f font</B>
|
|
|
|
<DD>
|
|
Set the default font used for text objects to <I>font</I>,
|
|
where <I>font</I> is one of
|
|
<I>rm</I>, <I>bf</I>, <I>it</I>, <I>sf</I> or <I>tt</I>.
|
|
The default is <I>rm</I>.
|
|
<P>
|
|
<DT id="131"><B>-G dummy_arg</B>
|
|
|
|
<DD>
|
|
Draws a standard PSTricks grid in light gray, ignoring the size
|
|
parameters, numbered in PSTricks units.
|
|
<P>
|
|
<DT id="132"><B>-l weight</B>
|
|
|
|
<DD>
|
|
Sets a line weight factor that is multiplied by the actual Fig line
|
|
width. The default value 0.5 roughly matches the output of the PS
|
|
driver.
|
|
<P>
|
|
<DT id="133"><B>-n 0|1|2|3</B>
|
|
|
|
<DD>
|
|
Sets environment type. Default 0 creates a <B>\picture</B>
|
|
environment with bounding box exactly enclosing the picture (but see
|
|
<B>-x</B>
|
|
|
|
and
|
|
<B>-y</B>
|
|
|
|
). A 1 emits bare PSTricks commands with no environment
|
|
at all, which can be used with
|
|
<B>\input{commands}</B> inside an existing <B>\pspicture</B>.
|
|
A 2 emits a complete LaTeX document. A 3 also emits a complete
|
|
LaTeX document but attempts to set the PSTricks unit to fit
|
|
a 7.5 by 10 inch (portrait aspect) box.
|
|
<P>
|
|
<DT id="134"><B>-P</B>
|
|
|
|
<DD>
|
|
Shorthand for <B>-n 3</B>.
|
|
<P>
|
|
<DT id="135"><B>-p dir</B>
|
|
|
|
<DD>
|
|
Attempts to run the
|
|
<B>bmeps</B>
|
|
|
|
program to translate picture files to EPS, which is required by
|
|
PSTricks. The translated files go in
|
|
<I>dir</I>
|
|
|
|
, which must already exist (the driver will not create it). Moreover,
|
|
(BIG CAVEAT HERE) the driver overwrites files with impunity in this
|
|
directory! Don't put your stuff here. The
|
|
<B>includegraphics</B>
|
|
|
|
commands in the output file refer to this directory. Even
|
|
if the -p option is not used,
|
|
<B>includegraphics</B>
|
|
|
|
commands follow this convention with the default directory
|
|
<I>./eps.</I>
|
|
|
|
In this case, the user must do
|
|
the conversions independently. The
|
|
<B>bmeps</B>
|
|
|
|
program is part of the standard TeX distribution. It converts
|
|
the following formats to EPS:
|
|
<B>png jpg pnm tif.</B>
|
|
|
|
You can see the bmeps command with the
|
|
<B>-v</B>
|
|
|
|
option.
|
|
<P>
|
|
<DT id="136"><B>-R 0|1|2</B>
|
|
|
|
<DD>
|
|
Sets arrow style. With the default style 0, Fig arrows are converted
|
|
to lines and polygons. With style 1, the Fig arrowhead dimensions are
|
|
converted to PSTricks arrowhead dimensions and PSTricks arrowhead
|
|
options are emitted. Hollow arrows will require the additional
|
|
package <B>pstricks-add</B>.
|
|
With style 2, PSTricks arrowhead options are emitted with no
|
|
dimensions at all, and arrowhead size may be controlled globally with
|
|
<B>psset</B>.
|
|
<P>
|
|
<DT id="137"><B>-S scale</B>
|
|
|
|
<DD>
|
|
Scales the image according to the same convention as the EPIC driver,
|
|
i.e., to size <I>scale</I>/12.
|
|
<P>
|
|
<DT id="138"><B>-t version</B>
|
|
|
|
<DD>
|
|
Provides the driver with PSTricks version number so
|
|
output can match expected LaTeX input.
|
|
<P>
|
|
<DT id="139"><B>-v</B>
|
|
|
|
<DD>
|
|
Print verbose warnings and extra comments in the output file.
|
|
Information provided includes font substitution details, the
|
|
<B>bmeps</B>
|
|
|
|
commands used for picture conversion, if any, and one comment per Fig
|
|
object in the output.
|
|
<P>
|
|
<DT id="140"><B>-x marginsize</B>
|
|
|
|
<DD>
|
|
Adds
|
|
<I>marginsize</I>
|
|
|
|
on the left and right of the
|
|
<B>PStricks</B>
|
|
|
|
bounding box. By default, the box exactly encloses the image.
|
|
<P>
|
|
<DT id="141"><B>-y marginsize</B>
|
|
|
|
<DD>
|
|
Adds
|
|
<I>marginsize</I>
|
|
|
|
on the top and bottom of the
|
|
<B>PStricks</B>
|
|
|
|
bounding box. By default, the box exactly encloses the image.
|
|
<P>
|
|
<P>
|
|
<DT id="142"><B>-z 0|1|2</B>
|
|
|
|
<DD>
|
|
Sets font handling option. Default option 0 attempts to honor Fig
|
|
font names and sizes, finding the best match with a standard LaTeX
|
|
font. Option 1 sets LaTeX font size only. Option 2 issues no font
|
|
commands at all.
|
|
<P>
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAZ"> </A>
|
|
<H2>TEXTYL OPTIONS</H2>
|
|
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="143"><B>-f font</B>
|
|
|
|
<DD>
|
|
Set the default font used for text objects to <I>font</I>,
|
|
where <I>font</I> is one of
|
|
<I>rm</I>, <I>bf</I>, <I>it</I>, <I>sf</I> or <I>tt</I>.
|
|
The default is <I>rm</I>.
|
|
<P>
|
|
<DT id="144"><B>-l lwidth</B>
|
|
|
|
<DD>
|
|
Set the line thickness. <I>lwidth</I> must be a value between 1 and 12.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbBA"> </A>
|
|
<H2>TIKZ OPTIONS</H2>
|
|
|
|
TIKZ is a powerful frontend to the Portable Graphics Format (PGF)
|
|
developed by Till Tantau, now at the University of Lübeck.
|
|
TIKZ was developed to be as platform-independent as possible, i.e.,
|
|
tikz-code can be processed with plain TeX, pdftex, xetex, LaTeX, ConTeX,
|
|
pdflatex, lualatex, or combinations of LaTeX + dvips, LaTeX + dvipdfm or others.
|
|
The TIKZ-code emitted by <I>fig2dev</I> tries to maintain this portability.
|
|
For instance, a tikz-picture is commenced with \tikzpicture (TeX-style), to
|
|
not exclude any processing engine. However, the stand-alone file produced with
|
|
the <B>-P</B> option must be processed with a LaTeX-engine.
|
|
In addition, font-commands may require a LaTeX engine.
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="145"><B>-b borderwidth</B>
|
|
|
|
<DD>
|
|
Make blank border around figure of width <I>borderwidth</I>*(1/72) inches.
|
|
<P>
|
|
<DT id="146"><B>-C num</B>
|
|
|
|
<DD>
|
|
Do not emit a \color-command for the color number <B>num</B>. (0 = black,
|
|
1 = blue, 2 = green - see the color chooser widget in Xfig).
|
|
By default, <I>fig2dev</I> does not issue a \color-command
|
|
for objects which have the color set to "Default" in xfig.
|
|
With this option, the "\color"-command is also omitted for objects having the
|
|
color <B>num</B>.
|
|
The color of these objects, as well as of those having the color set to
|
|
"Default", is picked up from the including document.
|
|
<P>
|
|
<DT id="147"><B>-E num</B>
|
|
|
|
<DD>
|
|
Set encoding for text translation (0 = no translation, 1 = ISO-8859-1, 2 =
|
|
ISO-8859-2; default 1).
|
|
For instance, to use utf8-encoded text, first <I>create</I> a text object, then
|
|
<I>edit</I>
|
|
the text using the edit-button in xfig. Convert the fig-file to tikz with
|
|
the option <B>-E 0</B> and include "<B>\usepackage[utf8]{inputenc}</B>"
|
|
in the LaTeX file (not necessary when using xelatex).
|
|
In xfig, the text typed in may not be displayed correctly, but the document
|
|
produced from the LaTeX file will show the same text as was typed in.
|
|
<P>
|
|
<DT id="148"><B>-F</B>
|
|
|
|
<DD>
|
|
Do not set the font family, series or shape.
|
|
By default, <I>fig2dev</I> sets the font family, series, shape,
|
|
font size and baselineskip.
|
|
As a side effect, this requires the New Font Selection
|
|
Scheme (NFSS) of LaTeX.
|
|
With this option on, the text font can be set from the including
|
|
document, which may be TeX or LaTeX.
|
|
See also <B>-o</B> (no font size).
|
|
<P>
|
|
<DT id="149"><B>-f font</B>
|
|
|
|
<DD>
|
|
Set the default font used for text objects to <I>font</I>.
|
|
The string <I>font</I> may be one of
|
|
<I>rm</I>, <I>bf, it</I>, <I>sf</I>, <I>tt</I>,
|
|
<I>\rmfamily</I>, <I>\bfseries</I>, <I>\itshape</I>, <I>\sffamily</I>,
|
|
<I>\ttfamily</I>,
|
|
or one of the 35 standard PostScript font names.
|
|
The default is <I>\rmfamily</I>.
|
|
<P>
|
|
<DT id="150"><B>-i dir</B>
|
|
|
|
<DD>
|
|
Prepend the string <I>dir</I> to graphics files included in the tikz-picture.
|
|
For instance, having imported "image.jpg" in xfig, with
|
|
<B>- i '$HOME/Figures/'</B> the code
|
|
"\pgfimage[width=..., height=...]{$HOME/Figures/image.jpg}"
|
|
will be generated.
|
|
<P>
|
|
<DT id="151"><B>-O</B>
|
|
|
|
<DD>
|
|
Do not quote characters special to TeX/LaTeX.
|
|
Useful to get, e.g., an italic <I>x</I>, not $x$,
|
|
because it was forgotten to set the text-flag "special-text" in xfig.
|
|
This option effectively sets the "special-text" flag for all text.
|
|
<P>
|
|
<DT id="152"><B>-o</B>
|
|
|
|
<DD>
|
|
Do not set the font size or baselineskip. Text will be rendered at the size that
|
|
is in force where the tikz-code is inserted into the document, e.g.,
|
|
"<B>\small\input fig1.tikz</B>".
|
|
See also <B>-F</B> (no font properties).
|
|
<P>
|
|
<DT id="153"><B>-P</B>
|
|
|
|
<DD>
|
|
Pagemode, generate a stand-alone LaTeX-file as <I>out-file</I>. The document
|
|
produced from the
|
|
LaTeX-file will have the paper size equal to the figure's
|
|
bounding box (but see the <B>-b</B> option to add a margin).
|
|
The generated LaTeX-file calls the package "geometry.sty" to set the paper size.
|
|
<P>
|
|
<DT id="154"><B>-T</B>
|
|
|
|
<DD>
|
|
Only use TeX fonts, even where PostScript-fonts are specified.
|
|
<P>
|
|
<DT id="155"><B>-v</B>
|
|
|
|
<DD>
|
|
Verbose mode. Write comment lines into the output file, usually naming the
|
|
type of the object that is drawn.
|
|
<P>
|
|
<DT id="156"><B>-W</B>
|
|
|
|
<DD>
|
|
Do not emit code at the beginning of the file that allows one to set the
|
|
figure width or height from the including TeX document.
|
|
Otherwise, e.g., "<B>\newdimen\XFigwidth\XFigwidth=\linewidth</B>"
|
|
would scale the following figures to the line width.
|
|
<P>
|
|
<DT id="157"><B>-w</B>
|
|
|
|
<DD>
|
|
Remove the suffix from included graphics-files.
|
|
With this option on, <I>fig2dev</I> generates code that contains, e.g.,
|
|
"<B>\pgfimage{fig1}</B>" instead of "<B>\pgfimage{fig1.pdf}</B>".
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbBB"> </A>
|
|
<H2>TK and PTK OPTIONS (tcl/tk and Perl/tk)</H2>
|
|
|
|
<P>
|
|
Arc-boxes are not supported for the tk output language, and only X bitmap
|
|
pictures are supported because of the canvas limitation in tk.
|
|
<BR>
|
|
|
|
Picture objects are not scaled with the magnification factor for tk output.
|
|
<BR>
|
|
|
|
Because tk scales canvas items according to the X display resolution,
|
|
polygons, lines, etc. may be scaled differently than imported pictures (bitmaps)
|
|
which aren't scaled at all.
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="158"><B>-g color</B>
|
|
|
|
<DD>
|
|
Use
|
|
<I>color</I>
|
|
|
|
for the background.
|
|
<P>
|
|
<DT id="159"><B>-l dummy_arg</B>
|
|
|
|
<DD>
|
|
Generate figure in landscape mode. The dummy argument is ignored,
|
|
but must appear on the command line for reasons of compatibility.
|
|
This option will override the orientation specification in the
|
|
file (for file versions 3.0 and higher).
|
|
<P>
|
|
<DT id="160"><B>-p dummy_arg</B>
|
|
|
|
<DD>
|
|
Generate figure in portrait mode. The dummy argument is ignored,
|
|
but must appear on the command line for reasons of compatibility.
|
|
This option will override the orientation specification in the
|
|
file (for file versions 3.0 and higher).
|
|
This is the default for Fig files of version 2.1 or lower.
|
|
<P>
|
|
<DT id="161"><B>-P</B>
|
|
|
|
<DD>
|
|
Generate canvas of full page size instead of using the bounding box
|
|
of the figure's objects. The default is to use only the bounding box.
|
|
<P>
|
|
<DT id="162"><B>-w</B>
|
|
|
|
<DD>
|
|
Wrap the figure with code in order to generate a complete perl file.
|
|
That is, you can do
|
|
<B>fig2dev -L ptk -w f.fig f.pl; perl f.pl</B>
|
|
|
|
and a widget pops up that shows the graphics contained in f.pl.
|
|
Only available for ptk output.
|
|
<P>
|
|
<DT id="163"><B>-z papersize</B>
|
|
|
|
<DD>
|
|
Set the paper size. See the POSTSCRIPT OPTIONS for available paper sizes.
|
|
This is only used when the <B>-P</B> option (use full page) is used.
|
|
<P>
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbBC"> </A>
|
|
<H2>TPIC OPTIONS</H2>
|
|
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="164"><B>-f font</B>
|
|
|
|
<DD>
|
|
Set the default font used for text objects to <I>font</I>.
|
|
The default is <I>rm</I>.
|
|
The string <I>font</I> can be one of
|
|
<I>rm</I>, <I>bf</I>, <I>it</I>, <I>sf</I>, <I>tt</I>,
|
|
<I>avant</I>, <I>avantcsc</I>, <I>avantd</I>, <I>avantdi</I>, <I>avanti</I>,
|
|
<I>bookd</I>, <I>bookdi</I>, <I>bookl</I>, <I>booklcsc</I>, <I>bookli</I>,
|
|
<I>chanc</I>, <I>cour</I>, <I>courb</I>, <I>courbi</I>, <I>couri</I>,
|
|
<I>helv</I>, <I>helvb</I>, <I>helvbi</I>, <I>helvc</I>, <I>helvcb</I>,
|
|
<I>helvcbi</I>, <I>helvci</I>, <I>helvcsc</I>, <I>helvi</I>, <I>pal</I>,
|
|
<I>palb</I>, <I>palbi</I>, <I>palbu</I>, <I>palc</I>, <I>palcsc</I>,
|
|
<I>pali</I>, <I>palsl</I>, <I>palu</I>, <I>palx</I>, <I>times</I>,
|
|
<I>timesb</I>, <I>timesbi</I>, <I>timesc</I>, <I>timescsc</I>, <I>timesi</I>,
|
|
<I>timessl</I> or <I>timesx</I>.
|
|
<P>
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbBD"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+xfig">xfig</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+pic">pic</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+pic2fig">pic2fig</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+transfig">transfig</A></B>(1)
|
|
|
|
<P>
|
|
<P>
|
|
<A NAME="lbBE"> </A>
|
|
<H2>BUGS and RESTRICTIONS</H2>
|
|
|
|
Please send bug reports, fixes, new features etc. to:
|
|
<BR>
|
|
|
|
<A HREF="mailto:thomas.loimer@tuwien.ac.at">thomas.loimer@tuwien.ac.at</A>
|
|
|
|
<P>
|
|
<A NAME="lbBF"> </A>
|
|
<H2>COPYRIGHT</H2>
|
|
|
|
Copyright (c) 1991 Micah Beck
|
|
<BR>
|
|
|
|
Parts Copyright (c) 1985-1988 Supoj Sutantavibul
|
|
<BR>
|
|
|
|
Parts Copyright (c) 1989-2015 Brian V. Smith
|
|
<BR>
|
|
|
|
Parts Copyright (c) 2015-2018 by Thomas Loimer
|
|
<P>
|
|
|
|
Permission to use, copy, modify, distribute, and sell this software and its
|
|
documentation for any purpose is hereby granted without fee, provided that
|
|
the above copyright notice appear in all copies and that both that
|
|
copyright notice and this permission notice appear in supporting
|
|
documentation. The authors make no representations about the suitability
|
|
of this software for any purpose. It is provided "as is" without express
|
|
or implied warranty.
|
|
<P>
|
|
|
|
THE AUTHORS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
|
|
INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
|
|
EVENT SHALL THE AUTHORS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
|
|
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
|
|
DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
|
|
TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
PERFORMANCE OF THIS SOFTWARE.
|
|
<P>
|
|
<P>
|
|
<A NAME="lbBG"> </A>
|
|
<H2>AUTHORS</H2>
|
|
|
|
Micah Beck
|
|
<BR>
|
|
|
|
Cornell University
|
|
<BR>
|
|
|
|
Sept 28 1990
|
|
<P>
|
|
and Frank Schmuck (then of Cornell University)
|
|
<BR>
|
|
|
|
and Conrad Kwok (then of U.C. Davis).
|
|
<P>
|
|
Drivers contributed by
|
|
<BR>
|
|
|
|
Jose Alberto Fernandez R. (U. of Maryland)
|
|
<BR>
|
|
|
|
and Gary Beihl (MCC)
|
|
<P>
|
|
Color support, ISO-character encoding and poster support by
|
|
<BR>
|
|
|
|
Herbert Bauer (<A HREF="mailto:heb@regent.e-technik.tu-muenchen.de">heb@regent.e-technik.tu-muenchen.de</A>)
|
|
<P>
|
|
Modified from f2p (fig to PIC), by the author of Fig
|
|
<BR>
|
|
|
|
Supoj Sutanthavibul (<A HREF="mailto:supoj@sally.utexas.edu">supoj@sally.utexas.edu</A>)
|
|
<BR>
|
|
|
|
University of Texas at Austin.
|
|
<P>
|
|
MetaFont driver by
|
|
<BR>
|
|
|
|
Anthony Starks (<A HREF="mailto:ajs@merck.com">ajs@merck.com</A>)
|
|
<P>
|
|
X-splines code by
|
|
<BR>
|
|
|
|
Carole Blanc (<A HREF="mailto:blanc@labri.u-bordeaux.fr">blanc@labri.u-bordeaux.fr</A>)
|
|
<BR>
|
|
|
|
Christophe Schlick (<A HREF="mailto:schlick@labri.u-bordeaux.fr">schlick@labri.u-bordeaux.fr</A>)
|
|
<BR>
|
|
|
|
The initial implementation was done by C. Feuille, S. Grobois, L. Maziere
|
|
and L. Minihot as a student practice (Universite Bordeaux, France).
|
|
<P>
|
|
Japanese text support for LaTeX output
|
|
written by T. Sato (<A HREF="mailto:VEF00200@niftyserve.or.jp">VEF00200@niftyserve.or.jp</A>)
|
|
<P>
|
|
The tk driver was written by
|
|
<BR>
|
|
|
|
Mike Markowski (<A HREF="mailto:mm@udel.edu">mm@udel.edu</A>) with a little touch-up by Brian Smith
|
|
<P>
|
|
The CGM driver (Computer Graphics Metafile) was written by
|
|
<BR>
|
|
|
|
Philippe Bekaert (<A HREF="mailto:Philippe.Bekaert@cs.kuleuven.ac.be">Philippe.Bekaert@cs.kuleuven.ac.be</A>)
|
|
<P>
|
|
The EMF driver (Enhanced Metafile) was written by
|
|
<BR>
|
|
|
|
Michael Schrick (<A HREF="mailto:m_schrick@hotmail.com">m_schrick@hotmail.com</A>)
|
|
<P>
|
|
The GBX (Gerber) driver was written by
|
|
<BR>
|
|
|
|
Edward Grace (<A HREF="mailto:ej.grace@imperial.ac.uk">ej.grace@imperial.ac.uk</A>).
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="165"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="166"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="167"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="168"><A HREF="#lbAE">GENERAL OPTIONS (all drivers)</A><DD>
|
|
<DT id="169"><A HREF="#lbAF">OPTIONS COMMON TO ALL BITMAP FORMATS</A><DD>
|
|
<DT id="170"><A HREF="#lbAG">GIF OPTIONS</A><DD>
|
|
<DT id="171"><A HREF="#lbAH">JPEG OPTIONS</A><DD>
|
|
<DT id="172"><A HREF="#lbAI">CGM OPTIONS</A><DD>
|
|
<DT id="173"><A HREF="#lbAJ">DXF OPTIONS</A><DD>
|
|
<DT id="174"><A HREF="#lbAK">EMF OPTIONS</A><DD>
|
|
<DT id="175"><A HREF="#lbAL">EPIC OPTIONS</A><DD>
|
|
<DT id="176"><A HREF="#lbAM">IBM-GL (HP/GL) OPTIONS</A><DD>
|
|
<DT id="177"><A HREF="#lbAN">LATEX OPTIONS</A><DD>
|
|
<DT id="178"><A HREF="#lbAO">MAP (HTML image map) OPTIONS</A><DD>
|
|
<DT id="179"><A HREF="#lbAP">METAFONT OPTIONS</A><DD>
|
|
<DT id="180"><A HREF="#lbAQ">METAPOST OPTIONS</A><DD>
|
|
<DT id="181"><A HREF="#lbAR">PIC OPTIONS</A><DD>
|
|
<DT id="182"><A HREF="#lbAS">PICT2E OPTIONS</A><DD>
|
|
<DT id="183"><A HREF="#lbAT">PICTEX OPTIONS</A><DD>
|
|
<DT id="184"><A HREF="#lbAU">GBX OPTIONS (Gerber, RS-247-X)</A><DD>
|
|
<DT id="185"><A HREF="#lbAV">POSTSCRIPT, ENCAPSULATED POSTSCRIPT (EPS), and PDF OPTIONS</A><DD>
|
|
<DT id="186"><A HREF="#lbAW">PSTEX and PDFTEX OPTIONS</A><DD>
|
|
<DT id="187"><A HREF="#lbAX">PSTEX_T and PDFTEX_T OPTIONS</A><DD>
|
|
<DT id="188"><A HREF="#lbAY">PSTricks OPTIONS</A><DD>
|
|
<DT id="189"><A HREF="#lbAZ">TEXTYL OPTIONS</A><DD>
|
|
<DT id="190"><A HREF="#lbBA">TIKZ OPTIONS</A><DD>
|
|
<DT id="191"><A HREF="#lbBB">TK and PTK OPTIONS (tcl/tk and Perl/tk)</A><DD>
|
|
<DT id="192"><A HREF="#lbBC">TPIC OPTIONS</A><DD>
|
|
<DT id="193"><A HREF="#lbBD">SEE ALSO</A><DD>
|
|
<DT id="194"><A HREF="#lbBE">BUGS and RESTRICTIONS</A><DD>
|
|
<DT id="195"><A HREF="#lbBF">COPYRIGHT</A><DD>
|
|
<DT id="196"><A HREF="#lbBG">AUTHORS</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>
|