[PATCH libinput v2 03/11] Add configuration option to select scroll mode
Hans de Goede
hdegoede at redhat.com
Mon Nov 10 02:59:14 PST 2014
Add a configuration option to allow selecting between 2-finger / edge / none
scrolling (for touchpads).
Signed-off-by: Hans de Goede <hdegoede at redhat.com>
---
src/libinput-private.h | 13 ++++
src/libinput.c | 85 ++++++++++++++++++++++
src/libinput.h | 194 +++++++++++++++++++++++++++++++++++++++++++++++++
3 files changed, 292 insertions(+)
diff --git a/src/libinput-private.h b/src/libinput-private.h
index 92bd96b..5310160 100644
--- a/src/libinput-private.h
+++ b/src/libinput-private.h
@@ -132,6 +132,18 @@ struct libinput_device_config_left_handed {
int (*get_default)(struct libinput_device *device);
};
+struct libinput_device_config_scroll_mode {
+ uint32_t (*get_modes)(struct libinput_device *device);
+ enum libinput_config_status (*set_mode)(struct libinput_device *device,
+ enum libinput_config_scroll_mode mode);
+ enum libinput_config_scroll_mode (*get_mode)(struct libinput_device *device);
+ enum libinput_config_scroll_mode (*get_default_mode)(struct libinput_device *device);
+ enum libinput_config_status (*set_button)(struct libinput_device *device,
+ uint32_t button);
+ uint32_t (*get_button)(struct libinput_device *device);
+ uint32_t (*get_default_button)(struct libinput_device *device);
+};
+
struct libinput_device_config {
struct libinput_device_config_tap *tap;
struct libinput_device_config_calibration *calibration;
@@ -139,6 +151,7 @@ struct libinput_device_config {
struct libinput_device_config_accel *accel;
struct libinput_device_config_natural_scroll *natural_scroll;
struct libinput_device_config_left_handed *left_handed;
+ struct libinput_device_config_scroll_mode *scroll_mode;
};
struct libinput_device {
diff --git a/src/libinput.c b/src/libinput.c
index a293f0f..202c239 100644
--- a/src/libinput.c
+++ b/src/libinput.c
@@ -1531,3 +1531,88 @@ libinput_device_config_buttons_get_default_left_handed(struct libinput_device *d
return device->config.left_handed->get_default(device);
}
+
+LIBINPUT_EXPORT uint32_t
+libinput_device_config_scroll_get_modes(struct libinput_device *device)
+{
+ if (device->config.scroll_mode)
+ return device->config.scroll_mode->get_modes(device);
+ else
+ return 0;
+}
+
+LIBINPUT_EXPORT enum libinput_config_status
+libinput_device_config_scroll_set_mode(struct libinput_device *device,
+ enum libinput_config_scroll_mode mode)
+{
+ if ((libinput_device_config_scroll_get_modes(device) & mode) != mode)
+ return LIBINPUT_CONFIG_STATUS_UNSUPPORTED;
+
+ /* Check mode is a single valid mode */
+ switch (mode) {
+ case LIBINPUT_CONFIG_SCROLL_NO_SCROLL:
+ case LIBINPUT_CONFIG_SCROLL_2FG:
+ case LIBINPUT_CONFIG_SCROLL_EDGE:
+ case LIBINPUT_CONFIG_SCROLL_ON_BUTTON_DOWN:
+ break;
+ default:
+ return LIBINPUT_CONFIG_STATUS_INVALID;
+ }
+
+ if (device->config.scroll_mode)
+ return device->config.scroll_mode->set_mode(device, mode);
+ else /* mode must be _NO_SCROLL to get here */
+ return LIBINPUT_CONFIG_STATUS_SUCCESS;
+}
+
+LIBINPUT_EXPORT enum libinput_config_scroll_mode
+libinput_device_config_scroll_get_mode(struct libinput_device *device)
+{
+ if (device->config.scroll_mode)
+ return device->config.scroll_mode->get_mode(device);
+ else
+ return LIBINPUT_CONFIG_SCROLL_NO_SCROLL;
+}
+
+LIBINPUT_EXPORT enum libinput_config_scroll_mode
+libinput_device_config_scroll_get_default_mode(struct libinput_device *device)
+{
+ if (device->config.scroll_mode)
+ return device->config.scroll_mode->get_default_mode(device);
+ else
+ return LIBINPUT_CONFIG_SCROLL_NO_SCROLL;
+}
+
+LIBINPUT_EXPORT enum libinput_config_status
+libinput_device_config_scroll_set_button(struct libinput_device *device,
+ uint32_t button)
+{
+ if ((libinput_device_config_scroll_get_modes(device) &
+ LIBINPUT_CONFIG_SCROLL_ON_BUTTON_DOWN) == 0)
+ return LIBINPUT_CONFIG_STATUS_UNSUPPORTED;
+
+ if (!libinput_device_has_button(device, button))
+ return LIBINPUT_CONFIG_STATUS_INVALID;
+
+ return device->config.scroll_mode->set_button(device, button);
+}
+
+LIBINPUT_EXPORT uint32_t
+libinput_device_config_scroll_get_button(struct libinput_device *device)
+{
+ if ((libinput_device_config_scroll_get_modes(device) &
+ LIBINPUT_CONFIG_SCROLL_ON_BUTTON_DOWN) == 0)
+ return 0;
+
+ return device->config.scroll_mode->get_button(device);
+}
+
+LIBINPUT_EXPORT uint32_t
+libinput_device_config_scroll_get_default_button(struct libinput_device *device)
+{
+ if ((libinput_device_config_scroll_get_modes(device) &
+ LIBINPUT_CONFIG_SCROLL_ON_BUTTON_DOWN) == 0)
+ return 0;
+
+ return device->config.scroll_mode->get_default_button(device);
+}
diff --git a/src/libinput.h b/src/libinput.h
index b9a889b..a108631 100644
--- a/src/libinput.h
+++ b/src/libinput.h
@@ -2035,6 +2035,200 @@ libinput_device_config_buttons_get_left_handed(struct libinput_device *device);
int
libinput_device_config_buttons_get_default_left_handed(struct libinput_device *device);
+/**
+ * The scroll mode of a device selects when to generate scroll axis events
+ * instead of pointer motion events.
+ */
+enum libinput_config_scroll_mode {
+ /**
+ * Never send scroll events instead of pointer motion events.
+ * Note scroll wheels, etc. will still send scroll events.
+ */
+ LIBINPUT_CONFIG_SCROLL_NO_SCROLL = 0,
+ /**
+ * Send scroll events when 2 fingers are down on the device.
+ */
+ LIBINPUT_CONFIG_SCROLL_2FG = (1 << 0),
+ /**
+ * Send scroll events when a finger is moved along the bottom or
+ * right edge of a device.
+ */
+ LIBINPUT_CONFIG_SCROLL_EDGE = (1 << 1),
+ /**
+ * Send scroll events when a button is down and the device moves
+ * along a scroll-capable axis.
+ */
+ LIBINPUT_CONFIG_SCROLL_ON_BUTTON_DOWN = (1 << 2),
+};
+
+/**
+ * @ingroup config
+ *
+ * Check which scroll modes a device supports. The mode defines when to
+ * generate scroll axis events instead of pointer motion events.
+ *
+ * @param device The device to configure
+ *
+ * @return A bitmask of possible modes.
+ *
+ * @see libinput_device_config_scroll_set_mode
+ * @see libinput_device_config_scroll_get_mode
+ * @see libinput_device_config_scroll_get_default_mode
+ * @see libinput_device_config_scroll_set_button
+ * @see libinput_device_config_scroll_get_button
+ * @see libinput_device_config_scroll_get_default_button
+ */
+uint32_t
+libinput_device_config_scroll_get_modes(struct libinput_device *device);
+
+/**
+ * @ingroup config
+ *
+ * Set the scroll mode for this device. The mode defines when to
+ * generate scroll axis events instead of pointer motion events.
+ *
+ * Note setting @ref LIBINPUT_CONFIG_SCROLL_ON_BUTTON_DOWN works as
+ * @ref LIBINPUT_CONFIG_SCROLL_NO_SCROLL when no button is set (when
+ * libinput_device_config_scroll_get_button() returns 0).
+ *
+ * @param device The device to configure
+ * @param mode The scroll mode for this device.
+ *
+ * @return A config status code.
+ *
+ * @see libinput_device_config_scroll_get_modes
+ * @see libinput_device_config_scroll_get_mode
+ * @see libinput_device_config_scroll_get_default_mode
+ * @see libinput_device_config_scroll_set_button
+ * @see libinput_device_config_scroll_get_button
+ * @see libinput_device_config_scroll_get_default_button
+ */
+enum libinput_config_status
+libinput_device_config_scroll_set_mode(struct libinput_device *device,
+ enum libinput_config_scroll_mode mode);
+
+/**
+ * @ingroup config
+ *
+ * Get the scroll mode for this device. The mode defines when to
+ * generate scroll axis events instead of pointer motion events.
+ *
+ * @param device The device to configure
+ * @return The current scroll mode for this device.
+ *
+ * @see libinput_device_config_scroll_get_modes
+ * @see libinput_device_config_scroll_set_mode
+ * @see libinput_device_config_scroll_get_default_mode
+ * @see libinput_device_config_scroll_set_button
+ * @see libinput_device_config_scroll_get_button
+ * @see libinput_device_config_scroll_get_default_button
+ */
+enum libinput_config_scroll_mode
+libinput_device_config_scroll_get_mode(struct libinput_device *device);
+
+/**
+ * @ingroup config
+ *
+ * Get the default scroll mode for this device. The mode defines when to
+ * generate scroll axis events instead of pointer motion events.
+ *
+ * @param device The device to configure
+ * @return The default scroll mode for this device.
+ *
+ * @see libinput_device_config_scroll_get_modes
+ * @see libinput_device_config_scroll_set_mode
+ * @see libinput_device_config_scroll_get_mode
+ * @see libinput_device_config_scroll_set_button
+ * @see libinput_device_config_scroll_get_button
+ * @see libinput_device_config_scroll_get_default_button
+ */
+enum libinput_config_scroll_mode
+libinput_device_config_scroll_get_default_mode(struct libinput_device *device);
+
+/**
+ * @ingroup config
+ *
+ * Set the button for @ref LIBINPUT_CONFIG_SCROLL_ON_BUTTON_DOWN mode for this
+ * device.
+ *
+ * When libinput_device_config_scroll_set_mode() is set to @ref
+ * LIBINPUT_CONFIG_SCROLL_ON_BUTTON_DOWN, no button press / release events will
+ * be send for the configured button.
+ *
+ * When the configured button is pressed any motion events along a
+ * scroll-capable axis are turned into scroll axis events.
+ *
+ * Note setting the button does not change the scroll mode, to change the
+ * scoll mode call libinput_device_config_scroll_set_mode().
+ *
+ * @param device The device to configure
+ * @param button The button which when pressed switches to sending scroll events
+ *
+ * @return On success @ref LIBINPUT_CONFIG_STATUS_SUCCESS is returned, if
+ * @ref LIBINPUT_CONFIG_SCROLL_ON_BUTTON_DOWN is not supported @ref
+ * LIBINPUT_CONFIG_STATUS_UNSUPPORTED is returned, if the device does not have
+ * the passed in button @ref LIBINPUT_CONFIG_STATUS_INVALID is returned.
+ *
+ * @see libinput_device_config_scroll_get_modes
+ * @see libinput_device_config_scroll_set_mode
+ * @see libinput_device_config_scroll_get_mode
+ * @see libinput_device_config_scroll_get_default_mode
+ * @see libinput_device_config_scroll_get_button
+ * @see libinput_device_config_scroll_get_default_button
+ */
+enum libinput_config_status
+libinput_device_config_scroll_set_button(struct libinput_device *device,
+ uint32_t button);
+
+/**
+ * @ingroup config
+ *
+ * Get the button for LIBINPUT_CONFIG_SCROLL_ON_BUTTON_DOWN mode for this
+ * device.
+ *
+ * If @ref LIBINPUT_CONFIG_SCROLL_ON_BUTTON_DOWN scroll mode is not supported,
+ * or no button is set, this function returns 0.
+ *
+ * Note the return value is independent of the actual scroll-mode, @ref
+ * LIBINPUT_CONFIG_SCROLL_ON_BUTTON_DOWN is only active if both this function
+ * returns non 0, and libinput_device_config_scroll_get_mode() returns @ref
+ * LIBINPUT_CONFIG_SCROLL_ON_BUTTON_DOWN.
+ *
+ * @param device The device to configure
+ * @return The button which when pressed switches to sending scroll events
+ *
+ * @see libinput_device_config_scroll_get_modes
+ * @see libinput_device_config_scroll_set_mode
+ * @see libinput_device_config_scroll_get_mode
+ * @see libinput_device_config_scroll_get_default_mode
+ * @see libinput_device_config_scroll_set_button
+ * @see libinput_device_config_scroll_get_default_button
+ */
+uint32_t
+libinput_device_config_scroll_get_button(struct libinput_device *device);
+
+/**
+ * @ingroup config
+ *
+ * Get the default button for LIBINPUT_CONFIG_SCROLL_ON_BUTTON_DOWN mode
+ * for this device.
+ *
+ * If @ref LIBINPUT_CONFIG_SCROLL_ON_BUTTON_DOWN scroll mode is not supported,
+ * or no default button is set, this function returns 0.
+ *
+ * @param device The device to configure
+ * @return The default button for LIBINPUT_CONFIG_SCROLL_ON_BUTTON_DOWN mode
+ *
+ * @see libinput_device_config_scroll_get_modes
+ * @see libinput_device_config_scroll_set_mode
+ * @see libinput_device_config_scroll_get_mode
+ * @see libinput_device_config_scroll_get_default_mode
+ * @see libinput_device_config_scroll_set_button
+ * @see libinput_device_config_scroll_get_button
+ */
+uint32_t
+libinput_device_config_scroll_get_default_button(struct libinput_device *device);
+
#ifdef __cplusplus
}
#endif
--
2.1.0
More information about the wayland-devel
mailing list