Enum Event

#[non_exhaustive]
pub enum Event<'a> {
    Begin {
        serial: u32,
        time: u32,
        surface: WlSurface,
        fingers: u32,
    },
    Update {
        time: u32,
        dx: f64,
        dy: f64,
        scale: f64,
        rotation: f64,
    },
    End {
        serial: u32,
        time: u32,
        cancelled: i32,
    },
}

Available on crate feature wayland and Linux only.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Begin

multi-finger pinch begin

This event is sent when a multi-finger pinch gesture is detected on the device.

Fields

serial: u32

time: u32

timestamp with millisecond granularity

surface: WlSurface

fingers: u32

number of fingers

Update

multi-finger pinch motion

This event is sent when a multi-finger pinch gesture changes the position of the logical center, the rotation or the relative scale.

The dx and dy coordinates are relative coordinates in the surface coordinate space of the logical center of the gesture.

The scale factor is an absolute scale compared to the pointer_gesture_pinch.begin event, e.g. a scale of 2 means the fingers are now twice as far apart as on pointer_gesture_pinch.begin.

The rotation is the relative angle in degrees clockwise compared to the previous pointer_gesture_pinch.begin or pointer_gesture_pinch.update event.

Fields

time: u32

timestamp with millisecond granularity

dx: f64

delta x coordinate in surface coordinate space

dy: f64

delta y coordinate in surface coordinate space

scale: f64

scale relative to the initial finger position

rotation: f64

angle in degrees cw relative to the previous event

End

multi-finger pinch end

This event is sent when a multi-finger pinch gesture ceases to be valid. This may happen when one or more fingers are lifted or the gesture is cancelled.

When a gesture is cancelled, the client should undo state changes caused by this gesture. What causes a gesture to be cancelled is implementation-dependent.

Fields

serial: u32

time: u32

timestamp with millisecond granularity

cancelled: i32

1 if the gesture was cancelled, 0 otherwise

Implementations

impl<'a> Event<'a>

pub fn opcode(&self) -> u16

Get the opcode number of this message

Trait Implementations

impl<'a> Debug for Event<'a>

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.