Struct input::DeviceGroup

pub struct DeviceGroup { /* fields omitted */ }

Device group

Some physical devices like graphics tablets are represented by multiple kernel devices and thus by multiple Devices.

libinput assigns these devices to the same DeviceGroup allowing the caller to identify such devices and adjust configuration settings accordingly. For example, setting a tablet to left-handed often means turning it upside down. A touch device on the same tablet would need to be turned upside down too to work correctly.

All devices are part of a device group though for most devices the group will be a singleton. A device is assigned to a device group on DeviceAddedEvent and removed from that group on DeviceRemovedEvent. It is up to the caller to track how many devices are in each device group.

Device groups do not get re-used once the last device in the group was removed, i.e. unplugging and re-plugging a physical device with grouped devices will return a different device group after every unplug.

Device groups are assigned based on the LIBINPUT_DEVICE_GROUP udev property, see Static device configuration via udev.

Trait Implementations

impl Eq for DeviceGroup

impl Debug for DeviceGroup

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl FromRaw<libinput_device_group> for DeviceGroup

unsafe fn from_raw(ffi: *mut libinput_device_group) -> Self

Create a new instance of this type from a raw pointer.

impl AsRaw<libinput_device_group> for DeviceGroup

fn as_raw(&self) -> *const libinput_device_group

Receive a raw pointer representing this type.

impl Userdata for DeviceGroup

unsafe fn userdata_raw<T: 'static>(&self) -> *mut T

unsafe fn set_userdata_raw<T: 'static>(&self, ptr: *mut T)

unsafe fn userdata<T: 'static>(&self) -> Option<&T>

Receive a reference to the attached userdata, if one exists.

unsafe fn userdata_mut<T: 'static>(&mut self) -> Option<&mut T>

Receive a mutable reference to the attached userdata, if one exists.

unsafe fn set_userdata<T: 'static, U: 'static>(&mut self,
                                               new: Option<T>)
                                               -> Option<U>

Set userdata and receive the currently set userdata

impl Clone for DeviceGroup

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Drop for DeviceGroup

fn drop(&mut self)

A method called when the value goes out of scope.

impl PartialEq for DeviceGroup

fn eq(&self, other: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl Hash for DeviceGroup

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the state given, updating the hasher as necessary.

fn hash_slice<H>(data: &[Self], state: &mut H) where H: Hasher

Feeds a slice of this type into the state provided.