home *** CD-ROM | disk | FTP | other *** search
/ Encyclopedia of Graphics File Formats Companion / GFF_CD.ISO / software / unix / saoimage / saodoc.tar / mouse.txt < prev    next >
Text File  |  1989-08-23  |  5KB  |  93 lines
  1.  
  2. mouse control in SAOimage
  3.  
  4. As with most interactive workstation programs, SAOimage uses the mouse
  5. and its buttons for many of its interactions.  To take full advantage of
  6. SAOimage's features, the user must understand how to use the mouse.
  7. There are three basic types of mouse interactions: moving, clicking, and
  8. dragging.  Moving means moving the mouse while keeping it flat on its
  9. mouse pad or desk surface.  Clicking means pressing one of the buttons
  10. on the mouse and then releasing it.  Dragging means holding one or more
  11. of the mouse's buttons down while moving the mouse.  Rotating the mouse
  12. is not a meaningful action.
  13.  
  14. The mouse is represented on the screen by an "icon", a simple symbol
  15. about a half centimeter on a side, which moves on the screen as you move
  16. the mouse on your table.  The box with buttons which you hold in your
  17. hand and the icon on the screen are interchangeably (or in concert)
  18. referred to as the mouse.  In X11 literature, the mouse is commonly
  19. referred to as the "pointer."  The mouse "occupies" a window or object
  20. when its icon on the screen is within the borders of that window or
  21. object.  The mouse interaction (as well as the keyboard interaction)
  22. is governed by the window or object which the mouse occupies.
  23.  
  24. The mouse icon has a point (called the "hot spot") which is used to
  25. determine its screen coordinates.  This point is usually in the center of
  26. the icon or at a corner.  The shape of the icon should make it easy to
  27. guess where the hot-spot is.  The mouse location (or "where the mouse
  28. is pointing") refers to the hot-spot.  Often dragging is initiated by
  29. pointing the mouse at a particular object (i.e. the vertex of a graph or
  30. polygon) as the appropriate mouse button is pressed, and then "dragging"
  31. that object while continuing to hold the mouse button down.
  32.  
  33. Some interactions may be performed while dragging with more than one
  34. mouse button down at the same time.  In the color graph, for example,
  35. each mouse button corresponds to one of the three display colors (red,
  36. green, blue).  One can make a change in gray level, by dragging with
  37. all three buttons held down while moving the graph vertex.
  38.  
  39. Some actions perform a completion action only after the last mouse
  40. button is released.  For example, consider the pan window interaction.
  41. In the pan window, you may manipulate both the magnification and the
  42. center of the main display window (zoom and pan).  The main display
  43. window is not actually redrawn until all mouse buttons are released.
  44. The area that would appear in the main display window, if the mouse
  45. buttons were released at that point, is represented by a box drawn in
  46. the pan window.  You may switch directly from adjusting the zoom to
  47. adjusting the pan (or visa-versa) by pressing the other mouse button
  48. down while still holding the former button down.
  49.  
  50. tracking
  51.  
  52. Some interactions actually "track" the mouse.  By this we mean that that
  53. which is being controlled is repeatedly updated as the mouse is moved,
  54. giving the impression of smooth, continuous change.  An example of this
  55. is moving a cursor with the mouse.  As you move the mouse, the displayed
  56. cursor moves across the screen.  Another example is the magnifier window.
  57. As you move the mouse, the view in the magnifier shifts (or pans), as if
  58. watching moving scenery.
  59.  
  60. While tracking is generally desirable, your workstation processor may
  61. not be fast enough to make many repeated updates for the illusion of
  62. smooth continuous change.  This is especially a problem for complicated
  63. processes (e.g. redrawing the main display window or drawing several
  64. elliptical annuli) or when many things are all tracking at the same time
  65. (e.g. changing the colors while also updating the graph which represents
  66. the color map).  When this happens, the effect of moving the mouse may
  67. lag annoyingly behind the actual movement of the mouse.
  68.  
  69. Recognizing that some processors are slower than others, SAOimage allows
  70. some tracking actions to be enabled or disabled.  The magnifier window
  71. can track the mouse as it moves across the main display or pan windows.
  72. The color table graph can track changes to the color map as they are
  73. controlled either in the main display window or directly on the graph
  74. (see the Color section).  Both of these tracking functions are enabled
  75. or disabled by the "track" button in the "etc" button submenu.  The
  76. "track" selection can be overridden (reversed) temporarily by pressing
  77. the "Shift" key or more long term by toggling the "Caps lock" key.  The
  78. running text display of the mouse coordinates and the corresponding pixel
  79. value can be enabled or disabled by the "coord" button in the "etc"
  80. button submenu.  This is also overridden by the "Shift" and "Caps" keys. 
  81.  
  82. fine movement
  83.  
  84. SAOimage uses the user's default mouse movement velocity settings.  To
  85. move the mouse one pixel at a time in any direction, use the keyboard
  86. arrow keys (see the Keyboard section).  The arrow keys can be used at any
  87. time in place of physically moving the mouse.  Thus to perform a fine
  88. movement while dragging, hold the mouse steady with the mouse button (or
  89. buttons) depressed with one hand, while pressing the appropriate arrow
  90. keys with the other hand.  If you are not already tracking, you may wish
  91. to hold the shift key down as you do so, to better see the effect of the
  92. fine movements.
  93.