1 GPLOT
GPLOT is a graphics utility program, designed for the processing of CGM
metafiles produced by DI3000, DISSPLA10, DISSPLA11, DRAWCGM,
NCARGKS1 and NCARGKS2.  Source code for GPLOT will be released to other sites,
so that graphics created at PSC can be processed locally.
 
Graphics produced by GPLOT can be combined with TEX formatted text by the
GTEX program.
 
The version of GPLOT installed on the PSC machines includes drivers for
PostScript, Tektronix 4010/4014/4207/4510, Cleartext CGM, and
BinaryCGM output.  Other device drivers are available for use at other sites,
including DEC/GKS, Peritek, Silicon Graphics GL (IRIS), SUN, SUN monochrome,
UIS, X Windows.  GPLOT cannot handle CGM character-encoded files.
 
Version:         4.2
 
VMS help:        HELP GPLOT
                   or
                 BULLETIN GPLOT
                   to read bulletin board announcements.
 
VMS examples:    DOC$ROOT1:[EXAMPLES.GPLOT]
                 CAR.CGM,     CGM74.CGM,   CGMBIN.CGM,   CGMGEN_TEST.CGM,
                 CGMTOPS.COM, CGMTOPS.LOG, CGMTOTEK.COM, CGMTOTEK.LOG,
                 DNA.CGM,     EXAMPLE_1.CGM,
                 GRAPHIC.CGM, GRAPHIC.PS,  GRAPHIC.TEK,  MDIBF2.CGM,
                 SMPL07.CGM,  STATION.CGM, TG1BF2.CGM,   X29.CGM,
 
VMS document:    PSCDOC:GPLOT.DOC
 
VMS usage:       GPLOT metafile/qualifiers, for example:
 
                 GPLOT/DEV=PS myfile.cgm
                   for PostScript output to the file "myfile.PS".
                 GPLOT/SCREEN=4010 myfile.cgm
                   for Tektronix 4010 output to the screen.
                 GPLOT/CLEAR_TEXT/DEV=PS myfile.cgmc
                   to create PostScript from a CGM clear text file.
                 GPLOT/CLEAR_TEXT/DEV=CGMB myfile.cgmc
                   to create a CGM binary file from a clear text file.
                 GPLOT/DEV=CGMC myfile.cgm
                   to create a CGM clear text from a CGM binary file.
 
CFS document:    /usr/local/doc/gplot.doc
 
CFS examples:    /usr/local/examples/gplot/
                 car.cgm,    cgm74.cgm,   cgmbin.cgm, cgmgen_test.cgm,
                 cgmtops.com,  cgmtotek.com, dna.cgm, example_1.cgm,
                 graphic.cgm, mdibf2.cgm, smpl07.cgm, station.cgm,
                 tg1bf2.cgm, x29.cgm,
 
CFS source:      /usr/local/src/bin/gplot/
                 cache.c, carray.c, cc.opt, ccdefs.h, ccgm.c,
                 cgm.c, cgmb.c, cgmc.c, defs.h, descrip.mms, devices.c,
                 dq.c, drvcla.c, emul.c, excl.c, fs.mar, gks.c, gksdefs.h,
                 gplot.bak, gplot.c, gplot.hlp, gplot.man, gplot.man1,
                 gplot.tex, gplot.txt, gplot_vms.cli, gpt_commands.cld,
                 gtex.c, hfonts.bin, hfonts.c, hfonts.h, hload.c, hload.h,
                 igl.c, index.tex, install.doc,
                 io.c, makefile, makefile.full, makegplot.com, makegtex,
                 peritek.c, pkras.c, ps.c, qms.c, sundriv.c,
                 tek.c, tty.c, uis.c, unixdemo.tex, update.mms, utils.c,
                 vmsdemo.tex,
                 xws_cellarray.c, xws_cla.c, xws_color.c, xws_color.h,
                 xws_defs.h, xws_delim.c, xws_delimiter.c,
                 xws_fill.h, xws_marker.c, xws_polygon.c, xws_polyline.c,
                 xws_setup.c, xws_text.c, xwsmakefile,
 
UNICOS usage:    gplot -dps MYFILE.CGM > MYFILE.PS    (for PostScript output)
                 gplot -s MYFILE.CGM                  (for Tektronix output)
                 gplot -stek4010 MYFILE.CGM      (To specify Tektronix 4010)
                 gplot -dcgmc MYFILE.CGM > MYFILE.CGMC (Convert CGM binary
                                                        to cleartext)
                 gplot -dcgmb -C MYFILE.CGMC > MYFILE.CGM  (Convert CGM
                                                    cleartext to CGM binary)
 
See also:        ANIMATION, CGM, DI3000, DISSPLA10, DISSPLA11,
                 DRAWCGM, GTEX, NCARGKS2, TEX,
 
Command Format:
  GPLOT metafile/qualifiers
 
 
GPLOT will try the default extension .CGM for a binary format metafile
name and .CGMC for a clear text metafile if no extension is given for
the metafile name.
 
The qualifiers can be used to select other than default values for the
graph size, number of copies, particular pages, etc.
 
 
2 Local_information
 
 
GPLOT is available on the VMS front ends, and on UNICOS.  Users have the
following options:
 
  Create a metafile on UNICOS, view it there.
  Create a metafile on UNICOS, transfer if to VMS, and view it.
  Create a metafile on VMS, view it there.
 
  Create a metafile on UNICOS/VMS, transfer it to the user's home
  site, and use a local copy of GPLOT to view it.  Contact PSC User
  Services for information on getting a copy of GPLOT.
 
There is a bulletin board for GPLOT.  Announcements, bug reports and
so on will often appear there.  To access this information once,
type "BULLETIN", "SELECT GPLOT" and then "READ".  Type "EXIT"
when you are done.  To find out how to be automatically notified
when new information is put into the GPLOT bulletin board, refer
to PSCDOC:BULLETIN.DOC.
 
2 /CLEAR_TEXT
  Tells GPLOT to expect a clear text metafile rather than binary format.
 
2 /COPIES
 
  Format:
    GPLOT metafile_name/COPIES=number
 
  If the output device supports a hardware multiple copies command, this
  will be invoked.
 
2 /DEBUG
 
  Tells GPLOT to display informational messages, most useful if you are
  reporting a bug.
 
2 /DEGREES
 
  Format:
    GPLOT metafile_name/DEGREES=number
 
  Tells GPLOT to rotate the image the specified number of degrees
  counter clockwise from its default orientation. If /DEGREES is not
  specified GPLOT will try to guess the best orientation based on the
  aspect ratios of the metafile bounding box and the output page. You
  may wish to override this. Also, if firmware fonts are
  used, they may not be available in the orientation chosen by GPLOT (or
  by you, for that matter).
 
2 /DEVICE
 
  Format:
    GPLOT metafile_name/DEVICE=device_name
 
  The present possible devices are:
 
    CGMB	       (outputs a CGM binary file)
    CGMC	       (outputs a clear text CGM file)
    GKS                (make Graphical Kernel System calls)
    PERITEK            (A color frame buffer device)
    PS                 (PostScript)
    SUN		       (SUN workstation)
    SUNBW	       (Monochrome SUN workstation)
    tek4010            (Tektronix 4010 format)
    tek4014            (Tektronix 4014 format)
    tek4207            (Tektronix 4207 format)
    UIS                (DEC's windowing system for VaxStations)
    XWS		       (X11 window workstation)
 
 
2 /DIAQUEST
 
  Format:
    GPLOT metafile_name/DIAQUEST=device_name
 
  Tells GPLOT that it is feeding images to a remotely controlled editing
  VCR (VTR) using a Diaquest controller connected to the specified
  device.
 
2 /FONT_TYPE
 
  Format:
    GPLOT metafile_name/FONT_TYPE=number
 
  The number can be
    0, use all device fonts
    1, use Hershey vector fonts, if loaded
    2, use PK raster fonts, if loaded
 
2 /INCLUDED
 
  Tells GPLOT that its ouput is being included in another file. This
  option is normally only used by GTEX when it is calling GPLOT to include
  a frame in the output.
 
2 /INDEX
 
  If indexing blocks are present in the CGM file, GPLOT will print out a
  short table of contents with the position of each picture and its
  title, if any.
 
2 /LIST
 
  GPLOT will create a listing file showing its interpretation of the CGM
  metafile.  This is most useful if you are reporting a bug.   /LIST will
  cause the debug output to go to the listing file.
 
2 /NINDEX
 
  Tells GPLOT to ignore any indexing blocks on input, and not to produce
  any on output.
 
2 /PAGES
 
  Tells GPLOT to select individual pages (no re-ordering), e.g.,
 
    GPLOT FOO/PAGES="-1,2,5,7_9,-10_-5"
      or
    GPLOT 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:
    GPLOT metafile_name/PXL_PER_IN=number
 
  Tells GPLOT the resolution of the output device in pixels per inch.
  GPLOT has a table of values for each output device, but this option
  allows you to override the default.
 
2 /SCALE
 
  Format:
    GPLOT metafile_name/SCALE
 
  Ignore any metric scaling mode elements, and always scale to fit the
  output device.
 
2 /SCREEN
 
  Format:
    GPLOT metafile_name/SCREEN=screen_type
 
  The difference between /dev and /scre for similar devices is that
  /screen implies /tty, that is, that GPLOT is running interactively,
  and output will go to the screen.
 
2 /START
 
  Format:
    GPLOT metafile_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 /TEXT_MAG
 
  Format:
    GPLOT metafile_name/TEXT_MAG=number
 
  GPLOT will magnify any text size by this (real) number.
 
2 /TITLE_STRING
 
  Format:
    GPLOT metafile_name/TITLE="Page Title"
 
  When the CGM file includes indexing blocks, this command will allow
  GPLOT to pick out only those pictures that contain the string argument
  to /TITLE in their title.  No reordering is done.
 
2 /TTY
 
  Tells GPLOT that the controlling device is a terminal.  GPLOT 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 file with extension .LIS.
 
2 /X_OFFSET
 
  Format:
    GPLOT metafile_name/X_OFFSET=number
 
  Moves the origin in the X direction by the specified amount in inches.
 
2 /X_SIZE
 
  Format:
    GPLOT metafile_name/X_SIZE=number
 
  Overides the default page width (in inches) for the output device
  used.
 
2 /Y_OFFSET
 
  Format:
    GPLOT metafile_name/Y_OFFSET=number
 
  Moves the origin in the Y direction by the specified amount in inches.
 
2 /Y_SIZE
 
  Format:
    GPLOT metafile_name/Y_SIZE=number
 
  Overides the default page height (in inches) for the output device used.
 
2 UNIX
 
 The following is a UNIX man page for GPLOT
 
 
                                                         gplot(1)
 
 
NAME
     gplot - graphics utility for the processing of CGM metafiles
 
SYNTAX
     gplot [options] metafile [outfile]
 
DESCRIPTION
     The gplot command translates a CGM metafile into input for a
     graphics device.  The input is placed into the outfile and
     in the absence of an outfile, it is sent to the stdout.
 
OPTIONS
     The following flags are interpreted by gplot.
 
     -bn  Specifies the starting frame to be number n for
          addressable output media like videotape.
 
     -cn  If the output device supports a hardware multiple
          copies command, gplot will produce n copies.
 
     -dd  Specifies the output device, d.  See Restrictions
	  section for a list of acceptable devices.
 
     -C   Specifies the input to be a clear text format CGM file,
          default is a binary format.
 
     -i   The output is to be used in another file.  This option
          is normally only used by GTEX when it is calling gplot
          to include a frame in the output.
 
     -fn  Use font type n, (0 device fonts) (1 Hershey fonts)
          (2 PK raster fonts)
 
     -l   Creates a listing file showing its interpretation of
          the CGM metafile.
 
     -mn  Magnify the text by n.
 
     -pn  Tells gplot to select individual pages, n.  n can be
          individual pages, multiple page numbers separated by
          commas or a range, e.g. 7_9.
 
     -rn  Rotate the image the specified number of degrees, n,
          counter clockwise from its default orientation.
 
     -sd  Synonymous with -dd -t
          See Restrictions section for a list of acceptable dev-
          ices.
 
     -t   Specifies that the controlling device is a terminal.
          Gplot will beep at the end of a page and pause awaiting
          a response.  This option is implied by the -s option.
 
     -xn  Moves the origin in the x direction by the specified
          amount, n, in inches.  n is a real number.
 
     -yn  Moves the origin in the y direction by the specified
          amount, n, in inches.  n is a real number.
 
     -D   Displays informational messages.  Useful for debugging
          purposes.
 
     -I   If indexing blocks are present gplot will display a short
          table of contents.
 
     -N   Tells GPLOT to ignore indexing blocks on input, not to
          produce them on output.
 
     -Pn  Overrides the default pixels per inch settings.  The
          resolution of the output device is set to n pixels per
          inch.
 
     -S	  Ignore metric scaling and scale image to fit device.
 
     -Tt  Where t is a string displays only those pictures which have
          t in the title.
 
     -Xn  Overrides the default page width in inches for the out-
          put device.  The new page width is set to n which is a
          real number.
 
     -Yn  Overrides the default page height in inches for the
          output device.  The new page height is set to n which
          is a real number.
 
RESTRICTIONS
     The present devices currently recognized by gplot are:
 
          tek4010        Tektronix 4010 (Default)
          tek4014        Tektronix 4014
          tek4107        Tektronix 4107
          tek4207        Tektronix 4207
          PERITEK        A color frame buffer device
          PS             PostScript
          XWS            X11
          sun            Color Sun
          sunbw          Monochrome Sun
          cgmb           Binary format CGM file
          cgmc           Clear Text CGM file
	  igl		 Iris GL
	  qms		 QMS laser printer
	  excl		 EXCL-based laser printer
 
     The Athena Widget library, the X Toolkit and the Xlib needs
     to be present to install Gplot.
 
 
KNOWN BUGS
     Gplot currently does not handle pattern fills on
     most devices.
 
     X switches like -display are parsed but must not be the last
     option specified.
 
 
FILES
          metafile       metafile
          outfile        output file
 
 
COPYRIGHT
     gplot is copyrighted (1987) by the Pittsburgh Supercomputing
     Center.
