PLOT2DEV(1) PLOT2DEV(1)
1 Mar 2000
NAME
plot2dev - a unix plot file to graphics code translator.
SYNOPSIS
plot2dev [-option value] ...
DESCRIPTION
plot2dev reads plotting instructions (see plot (5)) from the specified
input files and/or the standard input and produces a fig or gremlin
code on it's standard output. This output file can be edited with the
fig (Facility for Interactive Generation of figures) graphics editor
or xgremlin respectively. The output, if fig can subsequently be
converted to pictex, postscript, latex, epic, eepic, and tpic
languages using the transfig (1) translator. Any unrecognized options
on the command line are assumed to be input files. The standard input
is read by default only if no other files specified on the command
line are successfully opened. A single dash (-) on the command line
indicates the standard input is to be read. Each option is set and
each file read in the order they are specified on the command line.
This is free software, and you are welcome to redistribute it. Type
`plot2dev -warranty' for warranty details and copying conditions. The
byte ordering of two byte integers in unix plot files is machine
dependent. Although plot2dev applies a heuristic test to determine the
byte ordering and adjusts automaticly, it can be fooled. You can use
the -h and -l options to specify the byte ordering explicitly if
plot2dev fails to guess correctly. For compatibility with pic2fig,
plot2dev ignores leading white space in labels. Labels containing all
white space are ignored.
OPTIONS
-d NAME
-device NAME
Default: the default device is fig. The other option is gremlin.
Alternatively, the program will look into the environmental
variable PLOT2DEV if exists. If so, it will set the device name
to that value.
-fn NAME
-fontname NAME
Default: the default font of the transfig or gremlin output
device. This option sets the font for all subsequent text to
NAME. Recognized font names are typewriter, modern, italic, bold,
and times. In addition, courier is an alias for typewriter and
roman is an alias for times. Note that the fonts are device
dependent.
-fs SIZE
- 1 - Formatted: November 14, 2024
PLOT2DEV(1) PLOT2DEV(1)
1 Mar 2000
-fontsize SIZE
Default: 12 for fig and 1 for gremlin. This option sets for fig
the size of subsequent text to SIZE (in printer's points).
-h
-high-byte-first
This option specifies that the byte ordering of two byte integers
in the input unix plot file is high byte first.
-l
-low-byte-first
This option specifies that the byte ordering of two byte integers
in the input unix plot file is low byte first.
-warranty
-copying
This option prints out the copying conditions and warranty
information.
-signed
-unsigned
Default: signed. This option specifies whether two byte integers
in the input unix plot file are unsigned or signed.
- This option specifies explicitly that the standard input should
be read for plotting instructions.
SEE ALSO
graph(1G), lpr(1), plot(3X), plot(5), plot3d(1), grn(1), gremlin(1),
pbmtoplot(1).
EXAMPLES
To create a simple plot file one can use:
% echo 0 0 1 1 2 0 | spline | graph | plot2dev > test.xx
In the case of fig to edit the plot:
% fig test.fig
To convert the fig file into dvi code:
% transfig -L latex test.fig
% make test.tex
% cat >t.tex
\documentstyle[]{article}
\begin{document}
- 2 - Formatted: November 14, 2024
PLOT2DEV(1) PLOT2DEV(1)
1 Mar 2000
\input{test}
\end{document}
% latex t.tex
To edit a plot of data arranged in ordered pairs of x and y
coordinates in an ascii file, one can use:
% graph < asciiDataFile | plot2dev > file.fig
% xfig file.fig
In addition to similar processes for gremlin, one can convert a file
in ``pbm'' format using the PBMPLUS filters by doing something like:
% ... | pbmtoplot | plot2dev -d gremlin > file.g
% xgremlin file.g
and after include it in a *roff document.
BUGS
This utility hasn't been fully tested on all unixplot commands.
Comments are criticism are welcome. Richard Murphey
<Richard-Murphey@Rice.edu> and Daniel Senderowicz
<daniel@synchrods.com>.
- 3 - Formatted: November 14, 2024
