Package org.freedesktop.wayland.server

Class WlShellSurfaceResource

java.lang.Object

org.freedesktop.wayland.server.Resource<WlShellSurfaceRequests>

org.freedesktop.wayland.server.WlShellSurfaceResource

All Implemented Interfaces:

WaylandObject

public class WlShellSurfaceResource
extends Resource<WlShellSurfaceRequests>

desktop-style metadata interface

An interface that may be implemented by a wl_surface, for implementations that provide a desktop-style user interface.

It provides requests to treat surfaces like toplevel, fullscreen or popup windows, move, resize or maximize them, associate metadata like title and class, etc.

On the server side the object is automatically destroyed when the related wl_surface is destroyed. On the client side, wl_shell_surface_destroy() must be called before destroying the wl_surface object.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	INTERFACE_NAME

Fields inherited from class org.freedesktop.wayland.server.Resource

wlResourcePtr

Constructor Summary

Constructors

Constructor	Description
WlShellSurfaceResource(MemorySegment pointer)
WlShellSurfaceResource(Client client, int version, int id, WlShellSurfaceRequests implementation)

Method Summary

Modifier and Type	Method	Description
void	configure(int edges, int width, int height)	suggest resize
void	ping(int serial)	ping client
void	popupDone()	popup interaction is done

Methods inherited from class org.freedesktop.wayland.server.Resource

addDestroyListener, destroy, equals, getClient, getId, getImplementation, getPointer, getVersion, hashCode, postError, postEvent, postEvent, register, unregister

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Field Details

INTERFACE_NAME

public static final String INTERFACE_NAME

See Also:

• Constant Field Values

Constructor Details

WlShellSurfaceResource

public WlShellSurfaceResource(Client client,
 int version,
 int id,
 WlShellSurfaceRequests implementation)

WlShellSurfaceResource

public WlShellSurfaceResource(MemorySegment pointer)

Method Details

ping

public void ping(int serial)

ping client

Ping a client to check if it is receiving events and sending requests. A client is expected to reply with a pong request.

Parameters:

serial - serial number of the ping

configure

public void configure(int edges,
 int width,
 int height)

suggest resize

The configure event asks the client to resize its surface.

The size is a hint, in the sense that the client is free to ignore it if it doesn't resize, pick a smaller size (to satisfy aspect ratio or resize in steps of NxM pixels).

The edges parameter provides a hint about how the surface was resized. The client may use this information to decide how to adjust its content to the new size (e.g. a scrolling area might adjust its content position to leave the viewable content unmoved).

The client is free to dismiss all but the last configure event it received.

The width and height arguments specify the size of the window in surface-local coordinates.

Parameters:

edges - how the surface was resized

width - new width of the surface

height - new height of the surface

popupDone

public void popupDone()

popup interaction is done

The popup_done event is sent out when a popup grab is broken, that is, when the user clicks a surface that doesn't belong to the client owning the popup surface.