pointer_gestures_unstable_v1 Module

ZwpPointerGesturePinchV1

class pywayland.protocol.pointer_gestures_unstable_v1.ZwpPointerGesturePinchV1

A pinch gesture object

A pinch gesture object notifies a client about a multi-finger pinch gesture detected on an indirect input device such as a touchpad. The gesture is usually initiated by multiple fingers moving towards each other or away from each other, or by two or more fingers rotating around a logical center of gravity. The precise conditions of when such a gesture is detected are implementation-dependent.

A gesture consists of three stages: begin, update (optional) and end. There cannot be multiple simultaneous pinch or swipe gestures on a same pointer/seat, how compositors prevent these situations is implementation- dependent.

A gesture may be cancelled by the compositor or the hardware. Clients should not consider performing permanent or irreversible actions until the end of a gesture has been received.

destroy()

Request – opcode 0 (attached to Resource instance)

Destroy the pinch gesture object

begin(serial, time, surface, fingers)

Event – opcode 0 (attached to Proxy instance)

Multi-finger pinch begin

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

Parameters:
  • serial (uint) –
  • time (uint) – timestamp with millisecond granularity
  • surface (WlSurface) –
  • fingers (uint) – number of fingers
update(time, dx, dy, scale, rotation)

Event – opcode 1 (attached to Proxy instance)

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.

Parameters:
  • time (uint) – timestamp with millisecond granularity
  • dx (fixed) – delta x coordinate in surface coordinate space
  • dy (fixed) – delta y coordinate in surface coordinate space
  • scale (fixed) – scale relative to the initial finger position
  • rotation (fixed) – angle in degrees cw relative to the previous event
end(serial, time, cancelled)

Event – opcode 2 (attached to Proxy instance)

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.

Parameters:
  • serial (uint) –
  • time (uint) – timestamp with millisecond granularity
  • cancelled (int) – 1 if the gesture was cancelled, 0 otherwise

ZwpPointerGesturesV1

class pywayland.protocol.pointer_gestures_unstable_v1.ZwpPointerGesturesV1

Touchpad gestures

A global interface to provide semantic touchpad gestures for a given pointer.

Two gestures are currently supported: swipe and zoom/rotate. All gestures follow a three-stage cycle: begin, update, end and are identified by a unique id.

Warning! The protocol described in this file is experimental and backward incompatible changes may be made. Backward compatible changes may be added together with the corresponding interface version bump. Backward incompatible changes are done by bumping the version number in the protocol and interface names and resetting the interface version. Once the protocol is to be declared stable, the ‘z’ prefix and the version number in the protocol and interface names are removed and the interface version number is reset.

get_swipe_gesture(pointer)

Request – opcode 0 (attached to Resource instance)

Get swipe gesture

Create a swipe gesture object. See the wl_pointer_gesture_swipe interface for details.

Parameters:pointer (WlPointer) –
Returns:ZwpPointerGestureSwipeV1
get_pinch_gesture(pointer)

Request – opcode 1 (attached to Resource instance)

Get pinch gesture

Create a pinch gesture object. See the wl_pointer_gesture_pinch interface for details.

Parameters:pointer (WlPointer) –
Returns:ZwpPointerGesturePinchV1
release()

Request – opcode 2 (attached to Resource instance)

Destroy the pointer gesture object

Destroy the pointer gesture object. Swipe and pinch objects created via this gesture object remain valid.

ZwpPointerGestureSwipeV1

class pywayland.protocol.pointer_gestures_unstable_v1.ZwpPointerGestureSwipeV1

A swipe gesture object

A swipe gesture object notifies a client about a multi-finger swipe gesture detected on an indirect input device such as a touchpad. The gesture is usually initiated by multiple fingers moving in the same direction but once initiated the direction may change. The precise conditions of when such a gesture is detected are implementation-dependent.

A gesture consists of three stages: begin, update (optional) and end. There cannot be multiple simultaneous pinch or swipe gestures on a same pointer/seat, how compositors prevent these situations is implementation- dependent.

A gesture may be cancelled by the compositor or the hardware. Clients should not consider performing permanent or irreversible actions until the end of a gesture has been received.

destroy()

Request – opcode 0 (attached to Resource instance)

Destroy the pointer swipe gesture object

begin(serial, time, surface, fingers)

Event – opcode 0 (attached to Proxy instance)

Multi-finger swipe begin

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

Parameters:
  • serial (uint) –
  • time (uint) – timestamp with millisecond granularity
  • surface (WlSurface) –
  • fingers (uint) – number of fingers
update(time, dx, dy)

Event – opcode 1 (attached to Proxy instance)

Multi-finger swipe motion

This event is sent when a multi-finger swipe gesture changes the position of the logical center.

The dx and dy coordinates are relative coordinates of the logical center of the gesture compared to the previous event.

Parameters:
  • time (uint) – timestamp with millisecond granularity
  • dx (fixed) – delta x coordinate in surface coordinate space
  • dy (fixed) – delta y coordinate in surface coordinate space
end(serial, time, cancelled)

Event – opcode 2 (attached to Proxy instance)

Multi-finger swipe end

This event is sent when a multi-finger swipe 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.

Parameters:
  • serial (uint) –
  • time (uint) – timestamp with millisecond granularity
  • cancelled (int) – 1 if the gesture was cancelled, 0 otherwise