DataMuseum.dk

top - metrics - download

    Length: 4367 (0x110f)
    Types: TextFile
    Names: »fig2tex.1«

└─⟦52210d11f⟧ Bits:30007239 EUUGD2: TeX 3 1992-12
    └─⟦c319c2751⟧ »unix3.0/TeX3.0.tar.Z« 
        └─⟦036c765ac⟧ 
            └─⟦this⟧ »TeX3.0/Man-pages/other-manuals/fig2tex.1« 
└─⟦060c9c824⟧ Bits:30007080 DKUUG TeX 2/12/89
    └─⟦this⟧ »./tex82/TeXgraphics/transfig/fig2tex/fig2tex.1« 
└─⟦52210d11f⟧ Bits:30007239 EUUGD2: TeX 3 1992-12
    └─⟦63303ae94⟧ »unix3.14/TeX3.14.tar.Z« 
        └─⟦c58930e5c⟧ 
            └─⟦this⟧ »TeX3.14/Man-pages/other-manuals/fig2tex.1« 

TextFile

.TH FIG2TEX 1 "11 Februrary 1988"
.SH NAME
fig2tex \- translates Fig intermediate code into PicTeX macros
.SH SYNOPSIS
.B fig2tex
[
.B \-a 
] [
.B \-m
.I mag
] [
.B \-f 
.I fspec
] [
.B \-p 
.I psymbol
] [
.B \-l 
.I lwidth
] [
\fIfig-file\fR [ \fItex-file\fR ] ]
.SH DESCRIPTION
.I Fig2tex
translates fig objects in the named
.I fig-file
into PicTeX macros and puts them in
.I tex-file.
If a file name is presented, it is assumed to be the input file (fig 
output file). The output file
.I (tex-file), 
if not presented, will be the stdout.
If the 
.I fig-file 
is not presented, input will be assumed to come from the stdin.
The output from fig2tex can be edited to change font sizes/types.
.LP
Fig (Facility for Interactive Generation of figures) is a screen-oriented
tool which allows the user to draw and manipulate objects interactively.
It runs under the Suntools/Sunview window environment.
Fig2tex is compatible with Fig version 1.3.10.
.LP
PicTeX is an enhanced picture generating environment for TeX or
LaTeX documents.
It was developed by Michael Wichura of the Department of Statistics
at the University of Chicago.
.SH OPTIONS
.TP
.B \-m
Set the magnification at which the figure is rendered to
.I mag.
The default is 1.0.
.TP
.B \-f 
Set the font specification command which precedes every text object in the
picture to
.I fspec.
The default is "\fB\\twltt\fR".
.TP
.B \-p 
Set the symbol used by PicTeX for plotting lines and curves to 
.I psymbol.
The default is "\fB\\sevrm .\fR"
.TP
.B \-l 
Set the width of any rules used to draw lines and boxes within the picture to 
.I lwidth.
The default is "\fB0.7pt\fR".
.TP
.B \-a
Text is assumed to be arbitrary TeX input, and so no \fB\\hbox\fR is generated
to specify its width.
.SH TEX MACROS
In order to include PiCTeX pictures into a document, it is necessary to
load the PiCTeX macros, and to load the commands which control the picture
style of pictures produced by fig2tex

The file to control the picture style is called fig2tex.tex, and is loaded
using the command \fB\\input{fig2tex}\fR.  It defines the following
picture modes, which can be set on a per-picture basis.
.LP
\fB\\pictures\fR
Plot all lines and curves normally.  This is the default.
.LP
\fB\\dottedpictures\fR
Plot all lines and curves in \fIdotted\fR mode.
.LP
\fB\\nopictures\fR
Supress the plotting of lines and curves.  Fig2tex calculates the bounding box
for the picture, leaving an appropriate space in the document.
.LP
\fB\\optimizedpictures\fR
Optimize the picture by using LaTeX line and circle picture objects
when possible.
.SH LIMITATIONS
PicTeX uses TeX integer register arithmetic to generate curves,
and so it is very slow.
PicTeX draws curves by \fB\\put\fR-ing the \fIpsymbol\fR 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.
.LP
Generating pictures with dotted curves and lines (\fB\\dottedpictures\fR mode)
speeds PicTeX up and
reduces its memory requirements.
Generating them with no plotting (\fB\\nopictures\fR mode) is even faster.
Thus, draft versions  of a document can be generated more quickly.
Pictures can be generated at a reduced magnification (\fB-m\fR option),
decreasing the TeX memory requirement.
.SH OPTIMIZING
When used in optimizing mode (\fB\\optimizedpictures\fR mode),
Fig2tex then substitutes LaTeX picture objects for PicTeX
lines and circles whenever possible.
In order to produce figures which optimize well, the Fig grid
and point rounding ("magnet") should and used.
However, point rounding should be turned off when entering text.
.LP
LaTeX picture objects are drawn with special graphics fonts,
and so are much faster and use less memory than PicTeX.
However, LaTeX lines can be drawn only at a fixed set of slopes,
and circles only at a fixed set of diameters.
.SH BUGS
The width of text in figures is often not the same as shown by Fig.
Underfull hbox warnings from TeX can result.
.SH "SEE ALSO"
fig(1),
ftop(1)
.SH AUTHOR
Micah Beck (beck@svax.cs.cornell.edu)
.br
Cornell University
.br
December 20 1987
.sp
modified from Ftp, the fig-to-pic translator by the author of Fig,
.sp
Supoj Sutanthavibul (supoj@sally.utexas.edu)
.br
University of Texas at Austin, 
.br
January 29, 1985.