SYNOPSIS

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.

Options for Metafile Output

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.

Informational Options

--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.

AUTHORS