home *** CD-ROM | disk | FTP | other *** search
/ Encyclopedia of Graphics File Formats Companion / GFF_CD.ISO / software / unix / saoimage / saodoc.tar / keyboard.txt < prev    next >
Text File  |  1989-11-21  |  6KB  |  133 lines
  1.  
  2. SAOimage keyboard input
  3.  
  4. Many of the keys on the keyboard are mapped to perform useful functions.
  5. Striking the key results in an immediate response.  The response may be
  6. dependent on the window in which the mouse cursor is positioned.  Some
  7. responses are also dependent on the main menu mode (i.e. Cursor).  Both
  8. upper and lower case are mapped the same.
  9.  
  10. In addition to the instant action keys, the control, shift, and meta (left
  11. and right) keys change the response to mouse actions when held down while
  12. performing the mouse action.
  13.  
  14. Sometimes, SAOimage will ask for text or numeric input with a pop-up
  15. window.  Input in this situation is as one would expect and is
  16. unaffected by the mappings which are otherwise in effect.  The cursor
  17. read-back mode of IRAF, also overrides many keyboard functions.
  18.  
  19.  
  20. Mapped key commands
  21.  
  22.  Up Arrow, Down Arrow, Left Arrow, Right Arror:
  23.     The four arrow keys can be used to move the mouse cursor one
  24.     screen pixel in the given direction.  The mouse interaction is
  25.     exactly as if you moved the mouse by hand.  This facilitates
  26.     fine positioning and works in all windows and all modes.
  27.  
  28.  R:    ("raise") Raise all SAOimage windows to the front of any other
  29.     windows on the screen.  The 'A' key also performs this function.
  30.  
  31.  A:    ("refresh") Raise and redraw the display windows.  This is 
  32.     equivalent to ctrl-L in a character terminal window.
  33.  
  34.  N:    ("new") enter new command-line arguments.  This brings up a popup
  35.     window for text input.  Use the same switches and arguments as you
  36.     would on the command line (see cmdline help).  All of the command
  37.     line arguments which affect selection and display of an image can
  38.     be used.  Some configuration arguments (e.g. -d, -g, & -G) are not
  39.     affective at this time.
  40.  
  41.  T:    ("table") When the mouse is in the main display window or the pan
  42.     window, this prints a table of the pixel values surrounding the
  43.     current mouse position.  The table is printed in the terminal
  44.     window from which SAOimage was called.  The values are scaled to
  45.     their original file values.  (L has a seemingly similar affect
  46.     but is useful only for debugging purposes).
  47.  
  48.  S:    ("save") When in cursor mode, and the mouse is in the display
  49.     window, the current cursor is saved as a region (of type include).
  50.  
  51.  E:    ("exclude") When in cursor mode, and the mouse is in the display
  52.     window, the current cursor is saved as a region (of type exclude).
  53.  
  54.  D:    ("delete") When in cursor mode, and the mouse is in the display
  55.     window, the smallest region which encloses the mouse is deleted.
  56.     In the case of a point region, its area is defined as the area of
  57.     the first character of its label.
  58.  
  59.  Delete:
  60.     When in cursor mode, and the mouse is in the display window, the
  61.     most recently saved region is deleted.
  62.  
  63.  
  64.  
  65. Modifier keys
  66.  
  67.     For an explanation of mouse clicking and dragging, see the help
  68.     section on mouse control.
  69.  
  70.  Shift:
  71.     Holding the shift key down toggles the 'track' and 'coord'
  72.     tracking actions.
  73.           If no tracking was selected and the mouse is in either the
  74.       main main display window or the pan window, touching the shift
  75.       key will update the magnifier window to the current mouse
  76.       location.  If the mouse is in the main display window, the
  77.       coordinates and pixel value will also appear in the upper
  78.       right, above the buttons.
  79.           If you are in Color mode and dragging the mouse with a
  80.       button down in either the main or color graph window, the
  81.       graph will be updated to the current state of the color table.
  82.           By contining to hold the shift key down, tracking will
  83.       continue to update as you move the mouse.
  84.           If you were tracking before touching the shift key,
  85.       pressing the shift key will suspend tracking, enabling you to
  86.       preserve the existing tracking displays while moving the mouse.
  87.  
  88.  Caps or ShiftLock:
  89.     Toggling to caps mode by using the Caps or shift lock key has
  90.     the same effect as holding the shift key down.  When using this
  91.     option, you may need to toggle it off to make normal text entry
  92.     in the pop-up or a terminal window.
  93.  
  94.  Control:
  95.     When manipulating the color map in the main diplay window,
  96.     holding the control key down, restricts the affect to only the
  97.     color(s) corresponding to the mouse button(s) being pressed
  98.     (left=red, middle=green, right=blue).
  99.  
  100.  Meta keys:
  101.     The meta keys have traditionally been used for window manager
  102.     functioning.  SAOimage normally ignores keyboard and mouse
  103.     input while a meta key is held down.
  104.  
  105.  
  106. Pop-up text and numeric input:
  107.  
  108.     When SAOimage needs string input such as the name of a file or new
  109.     command line arguments, it presents a pop-up window for you to
  110.     type in.  The line starts with a default already typed in.  Many
  111.     keyboard editor keys are recognized, including the arrows.  The
  112.     popup window also recognizes many EMACS style line edit commands.
  113.     The input is taken when the user strikes the return key.
  114.  
  115.  CtrlA:  Move text cursor to beginning of line
  116.  CtrlB:  Move the text cursor back one character (backspace)
  117.  CtrlC:  Abort the interaction and return to SAOimage
  118.  CtrlD:  Delete the character under the text cursor
  119.  CtrlE:  Move the text cursor to the end of the line
  120.  CtrlF:  Move forward one space
  121.  CtrlG:  clear escape if just typed
  122.  CtrlK:  Delete all characters from the text cursor to the end of the line
  123.  CtrlN:  recall next input line (clear input line if no next in buffer)
  124.  CtrlP:  recall prior input line
  125.  Delete: Delete character before the text cursor
  126.  escape B: move to beginning of previous word
  127.  escape D: delete to end of next word
  128.  escape F: move to end of next word
  129.  
  130.     For numeric input, the typed input must be in acceptable integer or
  131.     real (where allowed) format.  Multiple entries, when desired, must be
  132.     separated by spaces, commas, or tabs.  (The line is read using scanf).
  133.