Package org.freedesktop.wayland.server

Interface WlPointerRequestsV8

All Superinterfaces:

WlPointerRequests, WlPointerRequestsV2, WlPointerRequestsV3, WlPointerRequestsV4, WlPointerRequestsV5, WlPointerRequestsV6, WlPointerRequestsV7

All Known Subinterfaces:

WlPointerRequestsV9

public interface WlPointerRequestsV8
extends WlPointerRequestsV7

pointer input device

The wl_pointer interface represents one or more input devices, such as mice, which control the pointer location and pointer_focus of a seat.

The wl_pointer interface generates motion, enter and leave events for the surfaces that the pointer is located over, and button and axis events for button presses, button releases and scrolling.

Field Summary

Fields

Modifier and Type	Field	Description
static final int	VERSION

Method Summary

Modifier and Type	Method	Description
void	release(WlPointerResource requester)	release the pointer object
void	setCursor(WlPointerResource requester, int serial, WlSurfaceResource surface, int hotspotX, int hotspotY)	set the pointer surface

Field Details

VERSION

static final int VERSION

See Also:

• Constant Field Values

Method Details

setCursor

void setCursor(WlPointerResource requester,
 int serial,
 @Nullable
 WlSurfaceResource surface,
 int hotspotX,
 int hotspotY)

set the pointer surface

Set the pointer surface, i.e., the surface that contains the pointer image (cursor). This request gives the surface the role of a cursor. If the surface already has another role, it raises a protocol error.

The cursor actually changes only if the pointer focus for this device is one of the requesting client's surfaces or the surface parameter is the current pointer surface. If there was a previous surface set with this request it is replaced. If surface is NULL, the pointer image is hidden.

The parameters hotspot_x and hotspot_y define the position of the pointer surface relative to the pointer location. Its top-left corner is always at (x, y) - (hotspot_x, hotspot_y), where (x, y) are the coordinates of the pointer location, in surface-local coordinates.

On wl_surface.offset requests to the pointer surface, hotspot_x and hotspot_y are decremented by the x and y parameters passed to the request. The offset must be applied by wl_surface.commit as usual.

The hotspot can also be updated by passing the currently set pointer surface to this request with new values for hotspot_x and hotspot_y.

The input region is ignored for wl_surfaces with the role of a cursor. When the use as a cursor ends, the wl_surface is unmapped.

The serial parameter must match the latest wl_pointer.enter serial number sent to the client. Otherwise the request will be ignored.

Specified by:

setCursor in interface WlPointerRequests

Specified by:

setCursor in interface WlPointerRequestsV2

Specified by:

setCursor in interface WlPointerRequestsV3

Specified by:

setCursor in interface WlPointerRequestsV4

Specified by:

setCursor in interface WlPointerRequestsV5

Specified by:

setCursor in interface WlPointerRequestsV6

Specified by:

setCursor in interface WlPointerRequestsV7

Parameters:

requester - The protocol object that made the request.

serial - serial number of the enter event

surface - pointer surface

hotspotX - surface-local x coordinate

hotspotY - surface-local y coordinate

release

void release(WlPointerResource requester)

release the pointer object

Using this request a client can tell the server that it is not going to use the pointer object anymore.

This request destroys the pointer proxy object, so clients must not call wl_pointer_destroy() after using this request.

Specified by:

release in interface WlPointerRequestsV3

Specified by:

release in interface WlPointerRequestsV4

Specified by:

release in interface WlPointerRequestsV5

Specified by:

release in interface WlPointerRequestsV6

Specified by:

release in interface WlPointerRequestsV7

Parameters:

requester - The protocol object that made the request.