[Gzz-commits] libvob doc/pegboard/controllers_events--mudyc/p...

[Tuomas J. Lukka]

CVSROOT:        /cvsroot/libvob
Module name:    libvob
Branch:         
Changes by:     Tuomas J. Lukka <address@hidden>        03/08/05 14:07:18

Modified files:
        doc/pegboard/controllers_events--mudyc: peg.rst 
Added files:
        org/nongnu/libvob/mouse: MouseClickListener.java 
                                 MouseDragListener.java 
                                 MouseMultiplexer.java 
                                 MousePressListener.java 

Log message:
        First draft of cleaned-up mouse multiplexing code

CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/libvob/libvob/doc/pegboard/controllers_events--mudyc/peg.rst.diff?tr1=1.5&tr2=1.6&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/libvob/libvob/org/nongnu/libvob/mouse/MouseClickListener.java?rev=1.1
http://savannah.gnu.org/cgi-bin/viewcvs/libvob/libvob/org/nongnu/libvob/mouse/MouseDragListener.java?rev=1.1
http://savannah.gnu.org/cgi-bin/viewcvs/libvob/libvob/org/nongnu/libvob/mouse/MouseMultiplexer.java?rev=1.1
http://savannah.gnu.org/cgi-bin/viewcvs/libvob/libvob/org/nongnu/libvob/mouse/MousePressListener.java?rev=1.1

Patches:
Index: libvob/doc/pegboard/controllers_events--mudyc/peg.rst
diff -u libvob/doc/pegboard/controllers_events--mudyc/peg.rst:1.5 
libvob/doc/pegboard/controllers_events--mudyc/peg.rst:1.6
--- libvob/doc/pegboard/controllers_events--mudyc/peg.rst:1.5   Tue Aug  5 
09:50:26 2003
+++ libvob/doc/pegboard/controllers_events--mudyc/peg.rst       Tue Aug  5 
14:07:18 2003
@@ -5,8 +5,8 @@
 
 :Authors:  Matti J. Katila
 :Date-Created: 2003-07-15
-:Last-Modified: $Date: 2003/08/05 13:50:26 $
-:Revision: $Revision: 1.5 $
+:Last-Modified: $Date: 2003/08/05 18:07:18 $
+:Revision: $Revision: 1.6 $
 :Status:   Current
 :Scope:    Minor
 :Type:     Architecture requirements
@@ -35,7 +35,10 @@
 - Should normal mouse controller and custom LEGO controllers 
   fit in the same API at some level?
 
-    RESOLVED: Yes, 'cause to user they are just controllers.
+    RESOLVED: Yes and no. Mouse uses the buttons and modifiers
+    while other controllers are not "modified" to such a degree.
+    There is some commonality - the mouse should be usable to control
+    things that controllers can but probably not vice versa.
 
 - Should custom LEGO controllers be able to control many things
   in different contexts, like fiddling zoom pan in buoyoing view and
@@ -125,7 +128,7 @@
 press event through a vob.mouse.MousePressListener::
 
     public interface MousePressListener {
-       /** The mouse was pressed
+       /** The mouse was pressed down.
         * @param x,y The coordinates.
         * @return If non-null, the return value is the drag listener
         *      to be used if the mouse is dragged from here.
@@ -156,10 +159,34 @@
        /** The mouse was clicked.
         * @param x,y The coordinates.
         */
-       MouseDragListener pressed(int x, int y);
+       MouseDragListener clicked(int x, int y);
     }
 
 Separating these three classes allows the easiest assembling of 
 event handling structures at run time.
+
+Multiplexer
+-----------
+
+The multiplexer sends mouse events it is given to the appropriate
+listeners.
+
+    /** A class to send mouse events to the listeners that want them.
+     */
+    public class MouseMultiplexer {
+       public static final int HORIZONTAL;
+       public static final int VERTICAL;
+
+       public void setListener(int button, int modifiers, String description, 
MousePressListener l);
+       public void setListener(int button, int modifiers, String description, 
MouseClickListener l);
+       public void setListener(int button, int modifiers, int dir, String 
description, RelativeAxisListener l);
+
+       public void setWheelListener(int modifiers, String description, 
RelativeAxisListener l);
+
+       public boolean deliverEvent(VobMouseEvent e);
+    }
+
+
+