Add functions to look up subdevices of composite input devices

[libs/gui.git] / source / input / device.h

diff --git a/source/input/device.h b/source/input/device.h
index 3338137eb51e46e50528cf51af02c73beb31ce50..4544776ac3a36f1f6b36d7dfe0d7a79cdaacb232 100644 (file)
--- a/source/input/device.h
+++ b/source/input/device.h
@@ -3,32 +3,74 @@
 
 #include <string>
 #include <vector>
+#include <stdexcept>
 #include <sigc++/signal.h>
+#include <msp/strings/lexicalcast.h>
 
 namespace Msp {
 namespace Input {
 
+class device_not_available: public std::runtime_error
+{
+public:
+       device_not_available(const std::string &w): std::runtime_error(w) { }
+       virtual ~device_not_available() throw() { }
+};
+
+
+enum DeviceType
+{
+       UNSPECIFIED,
+       KEYBOARD,
+       MOUSE,
+       TOUCH_SURFACE,
+       GAME_CONTROLLER
+};
+
+
 /**
 Base class for input devices.  Input devices have two types of controls:
 buttons and axes.  Buttons are either on or off.  Axes have a floating point
-value in the range [-1, 1].
+value nominally in the range [-1, 1].
+
+Event handlers return a boolean indicating whether the event is considered
+processed.  If a handler returns true, no further handlers are invoked.
 */
 class Device
 {
+protected:
+       struct EventAccumulator
+       {
+               typedef void result_type;
+
+               template<typename Iter>
+               result_type operator()(Iter begin, Iter end) const
+               {
+                       for(Iter i=begin; i!=end; ++i)
+                               if(*i)
+                                       return;
+               }
+       };
+
 public:
-       sigc::signal<void, unsigned> signal_button_press;
-       sigc::signal<void, unsigned> signal_button_release;
-       sigc::signal<void, unsigned, float, float> signal_axis_motion;
+       sigc::signal<bool, unsigned>::accumulated<EventAccumulator> signal_button_press;
+       sigc::signal<bool, unsigned>::accumulated<EventAccumulator> signal_button_release;
+       sigc::signal<bool, unsigned, float, float>::accumulated<EventAccumulator> signal_axis_motion;
 
 protected:
+       DeviceType type;
        std::string name;
        std::vector<char> buttons;
        std::vector<float> axes;
 
-       Device() { }
+       Device(DeviceType);
 public:
-       virtual ~Device() { }
+       virtual ~Device();
+
+       DeviceType get_type() const { return type; }
        const std::string &get_name() const { return name; }
+       virtual Device *find_subdevice(DeviceType, unsigned = 0);
+       virtual Device *find_subdevice(const std::string &);
        bool get_button_state(unsigned) const;
        float get_axis_value(unsigned) const;
 
@@ -39,6 +81,10 @@ protected:
        void set_axis_value(unsigned, float, bool);
 };
 
+
+void operator>>(const LexicalConverter &, DeviceType &);
+void operator<<(LexicalConverter &, DeviceType);
+
 } // namespace Input
 } // namespace Msp