1 GTEX

  GTEX is a text processing/graphics utility, primarily designed for the 
  processing of DVI files produced by TeX and the manipulation of CGM 
  metafiles produced by NCAR, DI3000, DISSPLA, etc.   For information
  on the production of these metafiles or to report problems with
  GPLOT call User Services or send mail to REMARKS.  Please also contact
  User Services with any suggestions for increased capabilities or extra
  supported devices. 

  Format:
    GTEX dvifile_name/qualifiers

  GTEX will try the default extension .DVI for the dvifile name if
  you have not specified the extension.

  The qualifiers can be used to select other than default values for the 
  page size, number of copies, particular pages, etc.

2 Local_Information

  GTEX is available only on the VMS front ends at the Pittsburgh
  Supercomputing Center.  Users who would like to see GTEX installed
  on their own local systems may request a copy of the GTEX source.
  However, GTEX requires that TeX be installed as well.  TeX is freely
  available, but requires a knowledgeable person to install properly.

  Information on GTEX is available in the file PSCDOC:GTEX.DOC, and
  will soon be available via the VMS command "HELP GTEX".  There is
  also a bulletin board for GTEX which contains announcements, bug
  reports and so on.  To read through this bulletin board, type
  "BULLETIN", "SELECT GTEX", "READ", and then when you are done
  type "EXIT".  Read the document PSCDOC:BULLETIN.DOC if you wish
  to be automatically informed when new items are placed on the
  GTEX bulletin board.

2 /COPIES

  Format:
    GTEX dvifile_name/COPIES=number

  If the output device supports a hardware multiple copies command, this
  will be invoked.

2 /DEBUG

  Tells GTEX to display informational messages, most useful if you are
  reporting a bug.

2 /DEGREES

  Format:
    GTEX dvifile_name/DEGREES=number

  Tells GTEX to rotate the image the specified number of degrees
  counter clockwise from its default orientation. If /DEGREES is not
  specified GTEX will try to guess the best orientation based on the
  aspect ratios of the dvifile bounding box and the output page. You
  may wish to override this, e.g, when driving a Tektronix screen you
  may not wish the image to be on its side. Also, if firmware fonts are
  used, they may not be available in the orientation chosen by GTEX (or
  by you, for that matter).

2 /DEVICE 

  Format:
    GTEX dvifile_name/DEVICE=device_name 

  The present possible devices are:

  4010       (Tektronix 4010 format) 
  4014       (Tektronix 4014 format) 
  4207       (Tektronix 4207 format) 
  4510       (Tektronix 4510 format) 
  APS        (APS phototypesetter)
  GKS        (make Graphical Kernel System calls)
  IMPRESS    (impress commands for an IMAGEN device)
  PERITEK    (A color frame buffer device) 
  PS         (PostScript)
  QMS800     (quic commands for a QMS800)
  QMS1200    (quic commands for a QMS1200)
  QMS2400    (quic commands for a QMS2400)

2 /DIAQUEST

  Format:
    GTEX dvifile_name/DIAQUEST=device_name

  Tells GTEX that it is feeding images to a remotely controlled editing
  VCR (VTR) using a Diaquest controller connected to the specified
  device.

2 /PAGES

  Tells GTEX to select individual pages (no re-ordering), e.g.,

    GTEX FOO/PAGES="-1,2,5,7_9,-10_-5" 
    or
    GTEX FOO/PAGES=(-1,2,5,7_9,-10_-5)

  The above page string means do pages -1, 2, 5, 7 thru 9 and -10 thru -5.
  Negative pages are normally only allowed in TeX output dvi files.

2 /PXL_PER_IN

  Format:
    GTEX dvifile_name/PXL_PER_IN=number

  Tells GTEX the resolution of the output device in pixels per inch.
  GTEX has a table of values for each output device, but this option
  allows you to override the default.

2 /SCREEN

  Format:
    GTEX dvifile_name/SCREEN=screen_type

  The present possible screen types are:

  4010    (Tektronix 4010, default)
  4014    (Tektronix 4014)
  4207    (Tektronix 4207)
  GKS     (GKS system)
 
  The difference between /dev and /scre for similar devices is that
  /screen implies /tty, that is, interactive usage of GTEX.

2 /START

  Format:
    GTEX dvifile_name/START=number

  Will begin the output at that number frame on an editing VTR. Useful
  for combining sequences of images on a VTR.

2 /TTY

  Tells GTEX that the controlling device is a terminal. GTEX will beep
  the terminal at the end of a page and wait for some response before
  proceeding. This is the default behavior when /SCREEN in specified. 
  Informational messages are also diverted to a .lis file.

2 /X_OFFSET

  Format:
    GTEX dvifile_name/X_OFFSET=number

  Moves the origin in the x direction by the specified amount in inches.

2 /X_SIZE

  Format:
    GTEX dvifile_name/X_SIZE=number

  Overides the default page width (in inches) for the output device
  used.

2 /Y_OFFSET

  Format:
    GTEX dvifile_name/Y_OFFSET=number

  Moves the origin in the y direction by the specified amount in inches.

2 /Y_SIZE

  Format:
    GTEX dvifile_name/Y_SIZE=number

  Overides the default page height (in inches) for the output device
  used.

2 Special_Commands

  GTEX supports several special commands. These commands are extensions
  to the normal TeX syntax and are very device driver dependent. Easily
  the most interesting one involves the inclusion of externally
  generated graphics.

3 GPLOT

  Format \special{gplot gplot_directives}

  Gplot is a CGM file processor. Any graphics images encoded in a CGM
  file can be included in the output stream. For example,

    \special{gplot foo/page=3/x_size=3/y_size=3} 

  will include the third frame from the computer graphics metafile 
  foo.cgm, scale it to fit within a 3 inch by 3 inch square and position 
  it with the location of the \special command at the origin. There are
  a plethora of GPLOT commands. Consult the GPLOT help file or the 
  hardcopy PSCDOC:GPLOT.DOC for more information.

3 include-string

  Format \special{include-string string_to_be_included}
 
  Everything inside the \special command after the include-string plus
  one space is included in the output string.

3 escape-string

  Format \special{escape-string string_to_be_included}
 
  Everything inside the \special command after the escape-string plus
  one space is included in the output string, and is preceded by an
  escape character (octal code 33).
