NAME¶
tek2plot - translate Tektronix files to other graphics formats
SYNOPSIS¶
tek2plot [
options ] [
files ]
DESCRIPTION¶
tek2plot translates Tektronix graphics files to other formats, or
displays them on an X Window System display. The output format is specified
with the
-T option. The possible output formats are the same as those
supported by
graph(1),
plot(1),
pic2plot(1), and
plotfont(1). If an output file is produced, it is written to standard
output.
Options and file names may be interspersed on the command line, but the options
are processed before the file names are read. If
-- is seen, it is
interpreted as the end of the options. If no file names are specified, or the
file name
- is encountered, the standard input is read.
OPTIONS¶
General Options¶
- -T type
-
- --output-format type
- Select type as the output format. It may be
"X", "png", "pnm", "gif",
"svg", "ai", "ps", "cgm",
"fig", "pcl", "hpgl", "regis",
"tek", or "meta" (the default). These refer
respectively to the X Window System, PNG (Portable Network Graphics)
format, portable anymap format (PBM/PGM/PPM), a pseudo-GIF format that
does not use LZW encoding, the new XML-based Scalable Vector Graphics
format, the format used by Adobe Illustrator, Postscript or Encapsulated
Postscript (EPS) that can be edited with idraw(1), CGM format (by
default, confirming to the WebCGM profile), the format used by the
xfig(1) drawing editor, the Hewlett-Packard PCL 5 printer language,
the Hewlett-Packard Graphics Language, ReGIS graphics format (which can be
displayed by the dxterm(1) terminal emulator or by a VT330 or VT340
terminal), Tektronix format itself, and device-independent GNU metafile
format. Unless type is "X", an output file is produced
and written to standard output.
-
- Omitting the -T option is equivalent to specifying
-T meta. GNU metafile format may be translated to other formats
with plot(1).
- -p n
-
- --page-number n
- Output only page number n, within the Tektronix file
or sequence of Tektronix files that is being translated. n must be
a non-negative integer, since a Tektronix file may consist of one or more
pages, numbered beginning with zero.
-
- The default behavior if the -p option is not used is
to output all nonempty pages in succession. For example, tek2plot -T
X displays each Tektronix page in its own X window. If the -T
png, -T pnm, -T gif, -T ai, or -T fig
option is used, the default behavior is to output only the first nonempty
Tektronix page, since files in those output formats contain only a single
page of graphics.
-
- Most Tektronix files consist of either one page (page #0)
or two pages (an empty page #0, and page #1). Tektronix files produced by
the GNU plotting utilities (e.g., by graph -T tek) are normally of
the latter sort.
- -F name
-
- --font-name name
- Use the font name for rendering the native Textronix
fonts, if it is available. The default font is "Courier" except
for tek2plot -T png, tek2plot -T pnm, tek2plot -T
gif, tek2plot -T hpgl, tek2plot -T regis, and
tek2plot -T tek, for which it is "HersheySerif". A list
of available fonts can be obtained with the --help-fonts option
(see below). If a font outside the Courier family is used, the
--position-chars option (see below) should probably be
specified.
-
- The -F option is useful only if you have a Tektronix
file that draws text using native Tektronix fonts. Tektronix files
produced by the GNU plotting utilities (e.g., by graph -T tek) do
not use native Tektronix fonts: they use Hershey vector fonts
instead.
- -W line_width
-
- --line-width line_width
- Set the width of lines, as a fraction of the width of the
display, to be line_width. A negative value means that a default
value should be used. This value is format-dependent. The interpretation
of zero line width is also format-dependent (in some output formats, a
zero-width line is the thinnest line that can be drawn; in others, a
zero-width line is invisible).
- --bg-color name
- Set the color used for the background to be name.
This is relevant only to tek2plot -T X, tek2plot -T png,
tek2plot -T pnm, tek2plot -T gif, tek2plot -T svg,
tek2plot -T cgm, and tek2plot -T regis. An unrecognized name
sets the color to the default, which is "white". The environment
variable BG_COLOR can equally well be used to specify the
background color. If the -T svg or -T cgm option is used, an
output file without a background may be produced by setting the background
color to "none".
-
- If the -T png or -T gif option is used, a
transparent PNG file or a transparent pseudo-GIF, respectively, may be
produced by setting the TRANSPARENT_COLOR environment variable to
the name of the background color.
- --bitmap-size bitmap_size
- Set the size of the graphics display in which the plot will
be drawn, in terms of pixels, to be bitmap_size. The default is
"570x570". This is relevant only to plot -T X, plot -T
png, plot -T pnm, and plot -T gif. If you choose a
rectangular (non-square) window size, the fonts in the plot will be scaled
anisotropically, i.e., by different factors in the horizontal and vertical
directions. For plot -T X, this requires an X11R6 display. Any font
that cannot be scaled in this way will be replaced by a default scalable
font, such as the vector font "HersheySerif".
-
- The environment variable BITMAPSIZE can equally
well be used to specify the window size. For backward compatibility, the X
resource Xplot.geometry may be used instead.
- --emulate-color option
- If option is yes, replace each color in the
output by an appropriate shade of gray. This is seldom useful, except when
using ` tek2plot -T pcl to prepare output for a PCL 5 device. (Many
monochrome PCL 5 devices, such as monochrome LaserJets, do a poor job of
emulating color on their own.) You may equally well request color
emulation by setting the environment variable EMULATE_COLOR to
"yes".
- --max-line-length max_line_length
- Set the maximum number of points that a polygonal line may
contain, before it is flushed out, to be max_line_length. If this
flushing occurs, the polygonal line will be split into two or more
sub-lines, though the splitting should not be noticeable. The default
value of max_line_length is 500.
-
- The reason for splitting long polygonal lines is that some
display devices (e.g., old Postscript printers and HP-GL pen plotters)
have limited buffer sizes. The environment variable MAX_LINE_LENGTH
can also be used to specify the maximum line length.
- --page-size pagesize
- Set the size of the page on which the plot will be
positioned. This is relevant only to tek2plot -T svg, tek2plot
-T ai, tek2plot -T ps, tek2plot -T cgm, tek2plot -T
fig, tek2plot -T pcl, and tek2plot -T hpgl. The default
is "letter", which means an 8.5 inch by 11 inch page. Any ISO
page size in the range "a0"..."a4" or ANSI page size
in the range "a"..."e" may be specified
("letter" is an alias for "a" and "tabloid"
is an alias for "b"). "legal" and "ledger"
are recognized page sizes also. The environment variable PAGESIZE
can equally well be used to specify the page size.
-
- The graphics display in which the plot is drawn will be a
square region that would occupy nearly the full width of the specified
page. An alternative size for the graphics display can be specified. For
example, the page size could be specified as
"letter,xsize=4in,ysize=6in", or
"a4,xsize=5.0cm,ysize=100mm". For all of the above except
tek2plot -T hpgl, the graphics display will, by default, be
centered on the page. For all of the above except tek2plot -T svg
and tek2plot -T cgm, the graphics display may be repositioned
manually, by specifying the location of its lower left corner, relative to
the lower left corner of the page. For example, the page size could be
specified as "letter,xorigin=2in,yorigin=3in", or
"a4,xorigin=0.5cm,yorigin=0.5cm". It is also possible to specify
an offset vector. For example, the page size could be specified as
"letter,xoffset=1in", or
"letter,xoffset=1in,yoffset=1.2in", or
"a4,yoffset=-1cm". In SVG format and WebCGM format it is
possible to specify the size of the graphics display, but not its
position.
- --pen-color name
- Set the pen color to be name. An unrecognized name
sets the pen color to the default, which is "black".
- --position-chars
- Position the characters in each text string individually.
If the text font is not a member of the Courier family, and especially if
it is not a fixed-width font, this option is recommended. It will improve
the appearance of text strings, at the price of making it difficult to
edit the output file with xfig(1), idraw(1), or
Illustrator.
- --rotation angle
- Rotate the graphics display by angle degrees.
Recognized values are "0", "90", "180", and
"270". "no" and "yes" are equivalent to
"0" and "90", respectively. The environment variable
ROTATION can also be used to specify a rotation angle.
- --use-tek-fonts
- Use the bitmap fonts that were used on the original
Tektronix 4010/4014 terminal. This option is relevant only to tek2plot
-T X. The four relevant bitmap fonts are distributed with most
versions of the GNU plotting utilities, under the names
"tekfont0"..."tekfont3". They can easily be installed
on any modern X Window System display. For this option to work properly,
you must also select a window size of 1024x1024 pixels, either by using
the --bitmap-size 1024x1024 option or by setting the value of the
Xplot.geometry resource. This is because bitmap fonts, unlike the
scalable fonts that tek2plot normally uses, cannot be
rescaled.
-
- This option is useful only if you have a file in Tektronix
format that draws text using native Tektronix fonts. Tektronix files
produced by the GNU plotting utilities (e.g., by graph -T tek) do
not use native Tektronix fonts: they use Hershey vector fonts
instead.
The following option is relevant only if the
-T option is omitted or if
-T meta is used. In this case
tek2plot outputs a GNU graphics
metafile, which must be translated to other formats with
plot(1).
- -O
-
- --portable-output
- Output the portable (human-readable) version of GNU
metafile format, rather than a binary version (the default). The format of
the binary version is machine-dependent.
- --help
- Print a list of command-line options, and exit.
- --help-fonts
- Print a table of available fonts, and exit. The table will
depend on which output format is specified with the -T option.
tek2plot -T X, tek2plot -T svg, tek2plot -T ai,
tek2plot -T ps, tek2plot -T cgm, and tek2plot -T fig
each support the 35 standard Postscript fonts. tek2plot -T svg,
tek2plot -T pcl, and tek2plot -T hpgl support the 45
standard PCL 5 fonts, and the latter two support a number of
Hewlett-Packard vector fonts. All seven support a set of 22 Hershey vector
fonts, as do tek2plot -T png, tek2plot -T pnm, tek2plot
-T gif, tek2plot -T regis, and tek2plot -T tek.
tek2plot without a -T option in principle supports any of
these fonts, since its output must be translated to other formats with
plot(1).
-
- The plotfont(1) utility may be used to obtain a
character map of any supported font.
- --list-fonts
- Like --help-fonts, but lists the fonts in a single
column to facilitate piping to other programs. If no output format is
specified with the -T option, the full set of supported fonts is
listed.
- --version
- Print the version number of tek2plot and the
plotting utilities package, and exit.
ENVIRONMENT¶
The environment variables
BITMAPSIZE, PAGESIZE, BG_COLOR,
EMULATE_COLOR, MAX_LINE_LENGTH and
ROTATION serve
as backups for the options
--bitmap-size,
--page-size,
--bg-color,
--emulate-color,
--max-line-length, and
--rotation, respectively. The remaining environment variables are
specific to individual output formats.
tek2plot -T X, which pops up a window on an X Window System display and
draws graphics in it, checks the
DISPLAY environment variable. Its
value determines the display that will be used.
tek2plot -T png and
tek2plot -T gif, which produce output in PNG
format and pseudo-GIF format respectively, are affected by the
INTERLACE
environment variable. If its value is "yes", the output will be
interlaced. Also, if the
TRANSPARENT_COLOR environment variable is set
to the name of a color, that color will be treated as transparent in the
output.
tek2plot -T pnm, which produces output in portable anymap (PBM/PGM/PPM)
format, is affected by the
PNM_PORTABLE environment variable. If its
value is "yes", the output will be in a human-readable format rather
than binary (the default).
tek2plot -T cgm, which produces output in CGM (Computer Graphics
Metafile) format, is affected by the
CGM_MAX_VERSION and
CGM_ENCODING environment variables. By default, it produces a
binary-encoded version of CGM version 3 format. For backward compatibility,
the version number may be reduced by setting
CGM_MAX_VERSION to
"2" or "1". Irrespective of version, the output CGM file
will use the human-readable clear text encoding if
CGM_ENCODING is set
to "clear_text". However, only binary-encoded CGM files conform to
the WebCGM profile.
tek2plot -T pcl, which produces PCL 5 output for Hewlett-Packard printers
and plotters, is affected by the environment variable
PCL_ASSIGN_COLORS.
It should be set to "yes" when producing PCL 5 output for a
color printer or other color device. This will ensure accurate color
reproduction by giving the output device complete freedom in assigning colors,
internally, to its "logical pens". If it is "no" then the
device will use a fixed set of colored pens, and will emulate other colors by
shading. The default is "no" because monochrome PCL 5 devices, which
are much more common than colored ones, must use shading to emulate color.
tek2plot -T hpgl, which produces Hewlett-Packard Graphics Language
output, is affected by several environment variables. The most important is
HPGL_VERSION, which may be set to "1", "1.5", or
"2" (the default). "1" means that the output should be
generic HP-GL, "1.5" means that the output should be suitable for
the HP7550A graphics plotter and the HP758x, HP7595A and HP7596A drafting
plotters (HP-GL with some HP-GL/2 extensions), and "2" means that
the output should be modern HP-GL/2. If the version is "1" or
"1.5" then the only available fonts will be vector fonts, and all
lines will be drawn with a default width (the
-W option will not work).
The position of the
tek2plot -T hpgl graphics display on the page can be
rotated 90 degrees counterclockwise by setting the
HPGL_ROTATE
environment variable to "yes". This is not the same as the rotation
obtained with the
--rotation option, since it both rotates the graphics
display and repositions its lower left corner toward another corner of the
page. Besides "no" and "yes", recognized values for
HPGL_ROTATE are "0", "90", "180", and
"270". "no" and "yes" are equivalent to
"0" and "90", respectively. "180" and
"270" are supported only if
HPGL_VERSION is "2"
(the default).
By default,
tek2plot -T hpgl will draw with a fixed set of pens. Which
pens are present may be specified by setting the
HPGL_PENS environment
variable. If
HPGL_VERSION is "1", the default value of
HPGL_PENS is "1=black"; if
HPGL_VERSION is
"1.5" or "2", the default value of
HPGL_PENS is
"1=black:2=red:3=green:4=yellow:5=blue:6=magenta:7=cyan". The format
should be self-explanatory. By setting
HPGL_PENS you may specify a
color for any pen in the range #1...#31. All color names recognized by the X
Window System may be used. Pen #1 must always be present, though it need not
be black. Any other pen in the range #1...#31 may be omitted.
If
HPGL_VERSION is "2" then
tek2plot -T hpgl will also
be affected by the environment variable
HPGL_ASSIGN_COLORS. If its
value is "yes", then
tek2plot -T hpgl will not be restricted
to the palette specified in
HPGL_PENS: it will assign colors to
"logical pens" in the range #1...#31, as needed. The default value
is "no" because other than color LaserJet printers and DesignJet
plotters, not many HP-GL/2 devices allow the assignment of colors to logical
pens.
The drawing of visible white lines is supported only if
HPGL_VERSION is
"2" and the environment variable
HPGL_OPAQUE_MODE is
"yes" (the default). If its value is "no" then white lines
(if any), which are normally drawn with pen #0, will not be drawn. This
feature is to accommodate older HP-GL/2 devices. HP-GL/2 pen plotters, for
example, do not support the use of pen #0 to draw visible white lines. Some
older HP-GL/2 devices may, in fact, malfunction if asked to draw opaque
objects.
SEE ALSO¶
plot(1),
plotfont(1), and "The GNU Plotting Utilities
Manual".
AUTHORS¶
tek2plot was written by Robert S. Maier (
rsm@math.arizona.edu).
It incorporates a Tektronix parser written by Edward Moy (
moy@parc.xerox.com).
BUGS¶
Email bug reports to
bug-gnu-utils@gnu.org.