xenial (1) tek2plot.1.gz

Provided by: plotutils_2.6-3ubuntu1_amd64 bug

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.

   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.

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.