Finish first draft of manual.
[enjoyable.git] / Enjoyable Help / pgs / mouse.html
index f7b5097..e02df2e 100644 (file)
     </div>
 
     <p>
     </div>
 
     <p>
-      Like keyboard events, you can also map joystick input to mouse actions.
+      You can use Enjoyable to map input to mouse buttons, moving, and
+      scrolling.
     </p>
 
     </p>
 
-    <h3><a name="analog"></a>Analog Inputs</h3>
-    
+    <h3>Movement</h3>
+    <p>
+      Select the direction you'd like the input to move the
+      mouse. Adjust the movement speed using the slider underneath.  If
+      you are mapping an analog input then this is the maximum speed;
+      for a button it's a constant speed.
+    </p>
+    <p>
+      The speed is set independently for each input. You can have
+      faster horizontal movement than vertical movement, or map one
+      set of inputs to a fast speed and another set to a slow
+      speed.
+    </p>
 
 
-    <h3><a name="mousemode"></a>Toggle Mouse Mode</h3>
-    
+    <h3>Buttons</h3>
+    <p>
+      Select the mouse button you'd like the input to simulate.
+    </p>
 
 
+    <h3><a name="scrolling"></a>Scrolling</h3>
+    <p>
+      Simulated scrolling can be continuous like the scrolling
+      gestures on a trackpad, or discrete like a mouse wheel that
+      clicks as you spin it.
+    </p>
+    <p>
+      To use <em>continuous scrolling</em> choose ↑ or ↓. Use the
+      slider underneath them to adjust the scrolling speed. If you are
+      mapping an analog input then this is the maximum speed; for a
+      button it's a constant speed.
+    <p>
+      To use <em>discrete scrolling</em> choose ⤒ or ⤓. The input
+      will trigger scrolling up or down by exactly one line and stop,
+      regardless of how long you hold the button down or how far
+      you move an analog input.
+    </p>
+    <p>
+      The arrows indicate the direction you would spin a mouse wheel
+      or move your fingers. Depending on settings this may mean you
+      need to choose a down arrow to scroll up and vice versa. You can
+      also change this globally in <b> > System Preferences… >
+      Mouse</b> and <b> > System Preferences… > Trackpad</b>.
+    </p>
+    
     <h3><a name="mouseissues"></a>Known Issues</h3>
     <p>
       Mouse events are more fragile than keyboard ones. While Enjoyble
       will work fine for most games, regular OS X (Cocoa) applications
       require specially formatted mouse events. Features such as
     <h3><a name="mouseissues"></a>Known Issues</h3>
     <p>
       Mouse events are more fragile than keyboard ones. While Enjoyble
       will work fine for most games, regular OS X (Cocoa) applications
       require specially formatted mouse events. Features such as
-      click-and-drag or double-clicking will not work correctly, and
-      so many applications will behave incorrectly if driven by an
+      click-and-drag or double-clicking will not work correctly, so
+      many applications will behave incorrectly if driven by an
       Enjoyable simulated mouse.
     </p>
     <p>
       If you find a non-Cocoa application that has problems with
       Enjoyable's mouse
       Enjoyable simulated mouse.
     </p>
     <p>
       If you find a non-Cocoa application that has problems with
       Enjoyable's mouse
-      support, <a href="https://github.com/joewreschnig/enjoyable/issues">please
+      support <a href="https://github.com/joewreschnig/enjoyable/issues">please
       file a ticket in the issue tracker</a>.
     </p>
     
       file a ticket in the issue tracker</a>.
     </p>