  Help Library file:   rasp
 
  HELP
 
      RASP Version 1.8    22 December 1988
 
      Format:  HELP [keyword [keyword [keyword...]]]
 
      The HELP command prints information on a list of keywords.
      "*" is a wildcard, while "*..." matches anything at the current
      level or below.  Thus "HELP *..." prints all HELP information
      available.  When responding to a "Topic?" or "Subtopic?" prompt,
      a "?" causes information for the current level to be repeated;
      a <RETURN> pops HELP up one level, and an end-of-file (or "EOF")
      terminates the HELP session.
 
 
  General_information
 
      In this documentation, information which can be included on a
      command line which is optional is enclosed in [square brackets].
      Control characters are denoted by a preceding caret (^) (i.e.,
      ^D for control-D).
 
      Arguments can be delimited by either blanks or commas, and real
      numbers entered as integers (no decimal point) will be interpreted
      correctly.
 
      PLO opcodes are not accepted.
 
      RASP Version 1.0 is compatible with PLOT3D Version 3.5.
 
 
  Journal_file
 
      During a RASP session, a "journal file" named RASP.JOU is kept
      of all commands entered to the program.  In the case of an abnormal
      termination (i.e., crash), this file is saved.  The file can also
      be saved by exiting from RASP using EXIT/SAVE (or QUIT/SAVE).
      Normally the journal file is deleted when the program terminates.
 
 
  Special_characters
 
      The following characters are treated specially when encountered
      on ANY line of input.
 
      -  If the last character on a line of input, "-" means to
         consider the next input line to be a continuation of the
         current line.
      '  Expected to surround a symbol, to be translated (by calling an
         appropriate system routine) into a character string.
      "  Expected to surround a character string, the contents of which
         are not to be disturbed.  The string is treated as a single
         character argument.
      !  Denotes that all input following on this line is to be
         considered a comment and ignored.
      @  If the first (nonblank) character on a line of input, the rest
         of the line is taken as a file name to be read as input to
         RASP.  When an end-of-file (or EOF) is encountered, input
         continues from the previous source.
     EOF If the ONLY nonblank characters on an input line are EOF, this
         is equivalent to an end-of-file reading input.  Further input
         is taken from the previous input file (or device).
 
 
  @file
 
      Use the given file as input for RASP commands.  On an end-of-file,
      control is returned to the previous source of input.  This command may
      be entered at any time during a RASP session, not necessarily at the
      main command level.
 
 
  End-of-file
 
      An end-of-file can be used in many commands to prematurely terminate a
      set of input, preventing that input from being incorporated into the
      program.  Most computer systems have a control character for entering
      an "end-of-file" from the terminal; in VAX/VMS, it is ^Z.  As an
      alternative, the letters "EOF" can be entered as an input line,
      signalling an end-of-file.
 
 
  $system-command
 
      If a "$" is the first character of a command line (at the main command
      level), the rest of the line is passed to the operating system as a
      command (for example $DIR when running under VAX/VMS would result in
      the "DIR" being sent to VMS).  A "$" alone means return to the system
      for awhile.  Upon completion (LOGOUT in VMS, ^D in Unix), return to
      RASP.
 
 
  IRIS_interface
 
      RASP will run with or without the IRIS window manager MEX.  Under
      MEX, RASP can open multiple graphics ports.  By default, each plot
      is NOT deleted when a <RETURN> is entered and the program returns
      to the RASP command prompt.  Subsequent plots are displayed as
      additional graphics ports connected to RASP.  Mouse and keyboard
      input can be attached to the different ports by using the window
      manager "attach" menu item while mouse and keyboard manipulation is
      active in RASP (i.e., while a picture is being displayed).
 
      To delete a graphics window, attach to the window (again, while a
      picture is being displayed, NOT in RASP command mode) and type
      <DELETE>.
 
      NOTE: a "hogwhiledown" keyboard button can be identified in the
      user's ".mexrc" file to allow attaching to different RASP graphics
      windows.  The .mexrc file lines
            reservebut 13
            bindfunc hogwhiledown 13
      bind the "no scroll" key to the hogwhiledown function.  For more
      information on the .mexrc file and hogwhiledown, read the Window
      Manager section in the IRIS User's Guide.
 
 
    Seiko_color_printer_screen_save
 
        Type "S" to save the current graphics window.
        Type "F" to save the full screen.
 
        The following message will appear when the save is done:
           "Graphics window [or Screen image] saved as file RASP.N.sei"
        N is the frame number (starting from 1 for each RASP run).
        These files can be printed by typing the Unix command
           "lp -dseiko RASP.N.sei".
 
        Once the image has been saved, the picture can again be manipulated
        with the mouse.
 
        This screen save option is a fixed-up version of the routine SCRSAVE
        supplied by Silicon Graphics under W3.5-GL2 and documented in the
        GL2-W3.5 Release Notes, p. 4-38.  It still references routines in the
        library "/usr/people/gifts/mextools/imglib/libimage.a".
 
 
    Screen_dump_to_QMS
 
        Type "Q" to save the graphics window.
 
        The following message will appear when the save is done:
           "Graphics window saved as page N in file RASP.qms"
 
        This is intended for line drawings only--anything that is not
        the background color (usually black) will be colored black on the
        QMS (where the background is, of course, white).
 
        Once the image has been saved, the picture can again be manipulated
        with the mouse.
 
        A new file is opened for every RASP run.  Thus if the file already
        exists, it is deleted!
 
 
    RAS_screen_save
 
        Type "R" to save the graphics window.
 
        The following message will appear when the save is done:
           "Graphics window saved as frame N in file RASP.ras"
 
        One file is opened per RASP run.  Frames are added to the existing
        file, if there is one (so we don't delete it by creating a new one!).
 
        The ARCGraph GRAFIX RAS file format is used.  See the file
        "arcgraph/graifs.doc", ARCGraph Internal Functional Specifications
        for a description of the format.
 
 
    PostScript_screen_save
 
        A bitmapped screen dump to a PostScript file is available.
        Type "D" to save the graphics window.
 
        "D" stands for both "dump" and "dangerous"!  A fullsize shaded
        image can tie up a reasonably powerful printer for a looong time!
        Please be courteous to other users.
 
        The following message will appear when the save is done:
           "Graphics window saved as page N in file xxx.psd"
        The filename used is the Q filename (or XYZ filename, or simply
        "PLOT3D") with a .PSD extension.
 
        The color of any object is converted to a "gray" value based on its
        difference from the background color, and the background color
        becomes equivalent to an "erase":
 
           gray = 1 - max(|R-Rbackground|,|G-Gbackground|,|B-Bbackground|)
 
        where a value of zero is black and one is white.  Thus to generate
        a shaded image, make the body to be shaded white, and plot with a
        white background (as it should appear on the page).
 
        Once the image has been saved, the picture can again be manipulated
        with the mouse.
 
        A new file is opened for every PLOT3D run.  Thus if the file already
        exists, it is deleted!
 
 
  EXIT
 
 
      Format:  EXIT
 
      Exit out of RASP.  Same as QUIT.
 
 
    Qualifiers
 
      /SAVE
        Save the journal file.  Default is to delete it.
 
 
  QUIT
 
 
      Format:  QUIT
 
      Exit out of RASP.  Same as EXIT.
 
 
    Qualifiers
 
      /SAVE
        Save the journal file.  Default is to delete it.
 
 
  PLOT
 
 
      Format:  PLOT [frame number]
 
      Plot a given frame of a RAS file.
 
      If no frame number is given, plot the next frame in the current
      file.
 
      Unless otherwise specified, use the background color and origin
      in the file.  (Under the window manager, ignore any origin and
      allow interactive placement of the window.)
 
 
    Qualifiers
 
      /FILE=file
        Specify the RAS file to be read.  Default file type is ".RAS".
      /BACKGROUND=color
      /NOBACKGROUND (D)
        Specify a background color for the window.  This overrides the
        color in the file.  This color remains in effect until cancelled
        with /NOBACKGROUND.
      /ORIGIN=(x,y)
      /NOORIGIN (D)
        Specify an origin for the window.  This overrides the origin in
        the file.  (This origin has no effect under the window manager.)
        This origin remains in effect until cancelled with /NOORIGIN.
 
 
  OVERLAY
 
 
      Format:  OVERLAY [frame number]
 
      Overlay this RAS file frame on top of the image in the most
      recently used window.  If this raster image is larger than the
      current window, it will be clipped to the size of this window.
 
      If no frame number is given, use the next frame in the current
      file.
 
      Ignore any background color and origin in the file.
 
 
    Qualifiers
 
      /FILE=file
        Specify the RAS file to be read.  Default file type is ".RAS".
      /BACKGROUND=color
      /NOBACKGROUND (D)
        Specify a background color for the window.  This overrides the
        current background color of the window.  This color remains in
        effect ONLY FOR THIS PLOT.
      /ORIGIN=(x,y)
      /NOORIGIN (D)
        Specify an origin for the overlay.  This overrides the origin in
        the file.  This origin remains in effect ONLY FOR THIS OVERLAY.
 
 
  COMPOSITE
 
 
      Format:  COMPOSITE [frame number]
 
      Construct a composite of various RAS frames.  This implies that
      if a frame overlaps a previously drawn image it will obscure it,
      rather than appear as an overlay on top of it (as in the OVERLAY
      command).
 
      If no frame number is given, use the next frame in the current
      file.
 
      Unless otherwise specified, use the background color and origin
      in the file.  (Under the window manager, this frame will be drawn
      in a separate window, and thus acts identically to the PLOT
      command; any origin is ignored, allowing interactive placement of
      the window.)
 
 
    Qualifiers
 
      /FILE=file
        Specify the RAS file to be read.  Default file type is ".RAS".
      /BACKGROUND=color
      /NOBACKGROUND (D)
        Specify a background color for the window.  This overrides the
        color in the file.  This color remains in effect ONLY FOR THIS
        PLOT.
      /ORIGIN=(x,y)
      /NOORIGIN (D)
        Specify an origin for the window.  This overrides the origin in
        the file.  (This origin has no effect under the window manager.)
        This origin remains in effect ONLY FOR THIS PLOT.
 

 Programmed STOP 
