1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

use {ffi, AsRaw, FromRaw, Libinput};
use std::ffi::CStr;

ffi_ref_struct!(
/// A seat has two identifiers, the physical name and the logical name.
///
/// A device is always assigned to exactly one seat. It may change to a
/// different logical seat but it cannot change physical seats. See
/// [Seats](https://wayland.freedesktop.org/libinput/doc/latest/seats.html)
/// for details.
struct Seat, ffi::libinput_seat, ffi::libinput_seat_ref, ffi::libinput_seat_unref);

impl Seat {
    /// Get the libinput context from the seat.
    pub fn context(&self) -> Libinput {
        self.context.clone()
    }

    /// Return the physical name of the seat.
    ///
    /// For libinput contexts created from udev, this is always the
    /// same value as passed into `udev_assign_seat` and all
    /// seats from that context will have the same physical name.
    ///
    /// The physical name of the seat is one that is usually set by the
    /// system or lower levels of the stack. In most cases, this is the
    /// base filter for devices - devices assigned to seats outside the
    /// current seat will not be available to the caller.
    pub fn physical_name(&self) -> &str {
        unsafe {
            CStr::from_ptr(ffi::libinput_seat_get_physical_name(self.as_raw_mut()))
                .to_str()
                .expect("Seat physical_name is no valid utf-8")
        }
    }

    /// Return the logical name of the seat.
    ///
    /// This is an identifier to group sets of devices within the
    /// compositor.
    pub fn logical_name(&self) -> &str {
        unsafe {
            CStr::from_ptr(ffi::libinput_seat_get_logical_name(self.as_raw_mut()))
                .to_str()
                .expect("Seat logical_name is no valid utf-8")
        }
    }
}