ba79e8043c721a8f65d9c3886a5dba44c3f6d423 — Drew DeVault 3 months ago 85ca241
Check in generated wayland protocols
3 files changed, 1710 insertions(+), 2 deletions(-)

M .gitignore
A xdg-shell-protocol.h
A xdg-shell.c
M .gitignore => .gitignore +0 -2
@@ 1,5 1,3 @@ *.o
  *.pyc
- xdg-shell.c
- xdg-shell-protocol.h
  .import

A xdg-shell-protocol.h => xdg-shell-protocol.h +1536 -0
@@ 0,0 1,1536 @@
+ /* Generated by wayland-scanner 1.17.0 */
+ 
+ #ifndef XDG_SHELL_SERVER_PROTOCOL_H
+ #define XDG_SHELL_SERVER_PROTOCOL_H
+ 
+ #include <stdint.h>
+ #include <stddef.h>
+ #include "wayland-server.h"
+ 
+ #ifdef  __cplusplus
+ extern "C" {
+ #endif
+ 
+ struct wl_client;
+ struct wl_resource;
+ 
+ /**
+  * @page page_xdg_shell The xdg_shell protocol
+  * @section page_ifaces_xdg_shell Interfaces
+  * - @subpage page_iface_xdg_wm_base - create desktop-style surfaces
+  * - @subpage page_iface_xdg_positioner - child surface positioner
+  * - @subpage page_iface_xdg_surface - desktop user interface surface base interface
+  * - @subpage page_iface_xdg_toplevel - toplevel surface
+  * - @subpage page_iface_xdg_popup - short-lived, popup surfaces for menus
+  * @section page_copyright_xdg_shell Copyright
+  * <pre>
+  *
+  * Copyright © 2008-2013 Kristian Høgsberg
+  * Copyright © 2013      Rafael Antognolli
+  * Copyright © 2013      Jasper St. Pierre
+  * Copyright © 2010-2013 Intel Corporation
+  * Copyright © 2015-2017 Samsung Electronics Co., Ltd
+  * Copyright © 2015-2017 Red Hat Inc.
+  *
+  * Permission is hereby granted, free of charge, to any person obtaining a
+  * copy of this software and associated documentation files (the "Software"),
+  * to deal in the Software without restriction, including without limitation
+  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
+  * and/or sell copies of the Software, and to permit persons to whom the
+  * Software is furnished to do so, subject to the following conditions:
+  *
+  * The above copyright notice and this permission notice (including the next
+  * paragraph) shall be included in all copies or substantial portions of the
+  * Software.
+  *
+  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
+  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+  * DEALINGS IN THE SOFTWARE.
+  * </pre>
+  */
+ struct wl_output;
+ struct wl_seat;
+ struct wl_surface;
+ struct xdg_popup;
+ struct xdg_positioner;
+ struct xdg_surface;
+ struct xdg_toplevel;
+ struct xdg_wm_base;
+ 
+ /**
+  * @page page_iface_xdg_wm_base xdg_wm_base
+  * @section page_iface_xdg_wm_base_desc Description
+  *
+  * The xdg_wm_base interface is exposed as a global object enabling clients
+  * to turn their wl_surfaces into windows in a desktop environment. It
+  * defines the basic functionality needed for clients and the compositor to
+  * create windows that can be dragged, resized, maximized, etc, as well as
+  * creating transient windows such as popup menus.
+  * @section page_iface_xdg_wm_base_api API
+  * See @ref iface_xdg_wm_base.
+  */
+ /**
+  * @defgroup iface_xdg_wm_base The xdg_wm_base interface
+  *
+  * The xdg_wm_base interface is exposed as a global object enabling clients
+  * to turn their wl_surfaces into windows in a desktop environment. It
+  * defines the basic functionality needed for clients and the compositor to
+  * create windows that can be dragged, resized, maximized, etc, as well as
+  * creating transient windows such as popup menus.
+  */
+ extern const struct wl_interface xdg_wm_base_interface;
+ /**
+  * @page page_iface_xdg_positioner xdg_positioner
+  * @section page_iface_xdg_positioner_desc Description
+  *
+  * The xdg_positioner provides a collection of rules for the placement of a
+  * child surface relative to a parent surface. Rules can be defined to ensure
+  * the child surface remains within the visible area's borders, and to
+  * specify how the child surface changes its position, such as sliding along
+  * an axis, or flipping around a rectangle. These positioner-created rules are
+  * constrained by the requirement that a child surface must intersect with or
+  * be at least partially adjacent to its parent surface.
+  *
+  * See the various requests for details about possible rules.
+  *
+  * At the time of the request, the compositor makes a copy of the rules
+  * specified by the xdg_positioner. Thus, after the request is complete the
+  * xdg_positioner object can be destroyed or reused; further changes to the
+  * object will have no effect on previous usages.
+  *
+  * For an xdg_positioner object to be considered complete, it must have a
+  * non-zero size set by set_size, and a non-zero anchor rectangle set by
+  * set_anchor_rect. Passing an incomplete xdg_positioner object when
+  * positioning a surface raises an error.
+  * @section page_iface_xdg_positioner_api API
+  * See @ref iface_xdg_positioner.
+  */
+ /**
+  * @defgroup iface_xdg_positioner The xdg_positioner interface
+  *
+  * The xdg_positioner provides a collection of rules for the placement of a
+  * child surface relative to a parent surface. Rules can be defined to ensure
+  * the child surface remains within the visible area's borders, and to
+  * specify how the child surface changes its position, such as sliding along
+  * an axis, or flipping around a rectangle. These positioner-created rules are
+  * constrained by the requirement that a child surface must intersect with or
+  * be at least partially adjacent to its parent surface.
+  *
+  * See the various requests for details about possible rules.
+  *
+  * At the time of the request, the compositor makes a copy of the rules
+  * specified by the xdg_positioner. Thus, after the request is complete the
+  * xdg_positioner object can be destroyed or reused; further changes to the
+  * object will have no effect on previous usages.
+  *
+  * For an xdg_positioner object to be considered complete, it must have a
+  * non-zero size set by set_size, and a non-zero anchor rectangle set by
+  * set_anchor_rect. Passing an incomplete xdg_positioner object when
+  * positioning a surface raises an error.
+  */
+ extern const struct wl_interface xdg_positioner_interface;
+ /**
+  * @page page_iface_xdg_surface xdg_surface
+  * @section page_iface_xdg_surface_desc Description
+  *
+  * An interface that may be implemented by a wl_surface, for
+  * implementations that provide a desktop-style user interface.
+  *
+  * It provides a base set of functionality required to construct user
+  * interface elements requiring management by the compositor, such as
+  * toplevel windows, menus, etc. The types of functionality are split into
+  * xdg_surface roles.
+  *
+  * Creating an xdg_surface does not set the role for a wl_surface. In order
+  * to map an xdg_surface, the client must create a role-specific object
+  * using, e.g., get_toplevel, get_popup. The wl_surface for any given
+  * xdg_surface can have at most one role, and may not be assigned any role
+  * not based on xdg_surface.
+  *
+  * A role must be assigned before any other requests are made to the
+  * xdg_surface object.
+  *
+  * The client must call wl_surface.commit on the corresponding wl_surface
+  * for the xdg_surface state to take effect.
+  *
+  * Creating an xdg_surface from a wl_surface which has a buffer attached or
+  * committed is a client error, and any attempts by a client to attach or
+  * manipulate a buffer prior to the first xdg_surface.configure call must
+  * also be treated as errors.
+  *
+  * Mapping an xdg_surface-based role surface is defined as making it
+  * possible for the surface to be shown by the compositor. Note that
+  * a mapped surface is not guaranteed to be visible once it is mapped.
+  *
+  * For an xdg_surface to be mapped by the compositor, the following
+  * conditions must be met:
+  * (1) the client has assigned an xdg_surface-based role to the surface
+  * (2) the client has set and committed the xdg_surface state and the
+  * role-dependent state to the surface
+  * (3) the client has committed a buffer to the surface
+  *
+  * A newly-unmapped surface is considered to have met condition (1) out
+  * of the 3 required conditions for mapping a surface if its role surface
+  * has not been destroyed.
+  * @section page_iface_xdg_surface_api API
+  * See @ref iface_xdg_surface.
+  */
+ /**
+  * @defgroup iface_xdg_surface The xdg_surface interface
+  *
+  * An interface that may be implemented by a wl_surface, for
+  * implementations that provide a desktop-style user interface.
+  *
+  * It provides a base set of functionality required to construct user
+  * interface elements requiring management by the compositor, such as
+  * toplevel windows, menus, etc. The types of functionality are split into
+  * xdg_surface roles.
+  *
+  * Creating an xdg_surface does not set the role for a wl_surface. In order
+  * to map an xdg_surface, the client must create a role-specific object
+  * using, e.g., get_toplevel, get_popup. The wl_surface for any given
+  * xdg_surface can have at most one role, and may not be assigned any role
+  * not based on xdg_surface.
+  *
+  * A role must be assigned before any other requests are made to the
+  * xdg_surface object.
+  *
+  * The client must call wl_surface.commit on the corresponding wl_surface
+  * for the xdg_surface state to take effect.
+  *
+  * Creating an xdg_surface from a wl_surface which has a buffer attached or
+  * committed is a client error, and any attempts by a client to attach or
+  * manipulate a buffer prior to the first xdg_surface.configure call must
+  * also be treated as errors.
+  *
+  * Mapping an xdg_surface-based role surface is defined as making it
+  * possible for the surface to be shown by the compositor. Note that
+  * a mapped surface is not guaranteed to be visible once it is mapped.
+  *
+  * For an xdg_surface to be mapped by the compositor, the following
+  * conditions must be met:
+  * (1) the client has assigned an xdg_surface-based role to the surface
+  * (2) the client has set and committed the xdg_surface state and the
+  * role-dependent state to the surface
+  * (3) the client has committed a buffer to the surface
+  *
+  * A newly-unmapped surface is considered to have met condition (1) out
+  * of the 3 required conditions for mapping a surface if its role surface
+  * has not been destroyed.
+  */
+ extern const struct wl_interface xdg_surface_interface;
+ /**
+  * @page page_iface_xdg_toplevel xdg_toplevel
+  * @section page_iface_xdg_toplevel_desc Description
+  *
+  * This interface defines an xdg_surface role which allows a surface to,
+  * among other things, set window-like properties such as maximize,
+  * fullscreen, and minimize, set application-specific metadata like title and
+  * id, and well as trigger user interactive operations such as interactive
+  * resize and move.
+  *
+  * Unmapping an xdg_toplevel means that the surface cannot be shown
+  * by the compositor until it is explicitly mapped again.
+  * All active operations (e.g., move, resize) are canceled and all
+  * attributes (e.g. title, state, stacking, ...) are discarded for
+  * an xdg_toplevel surface when it is unmapped.
+  *
+  * Attaching a null buffer to a toplevel unmaps the surface.
+  * @section page_iface_xdg_toplevel_api API
+  * See @ref iface_xdg_toplevel.
+  */
+ /**
+  * @defgroup iface_xdg_toplevel The xdg_toplevel interface
+  *
+  * This interface defines an xdg_surface role which allows a surface to,
+  * among other things, set window-like properties such as maximize,
+  * fullscreen, and minimize, set application-specific metadata like title and
+  * id, and well as trigger user interactive operations such as interactive
+  * resize and move.
+  *
+  * Unmapping an xdg_toplevel means that the surface cannot be shown
+  * by the compositor until it is explicitly mapped again.
+  * All active operations (e.g., move, resize) are canceled and all
+  * attributes (e.g. title, state, stacking, ...) are discarded for
+  * an xdg_toplevel surface when it is unmapped.
+  *
+  * Attaching a null buffer to a toplevel unmaps the surface.
+  */
+ extern const struct wl_interface xdg_toplevel_interface;
+ /**
+  * @page page_iface_xdg_popup xdg_popup
+  * @section page_iface_xdg_popup_desc Description
+  *
+  * A popup surface is a short-lived, temporary surface. It can be used to
+  * implement for example menus, popovers, tooltips and other similar user
+  * interface concepts.
+  *
+  * A popup can be made to take an explicit grab. See xdg_popup.grab for
+  * details.
+  *
+  * When the popup is dismissed, a popup_done event will be sent out, and at
+  * the same time the surface will be unmapped. See the xdg_popup.popup_done
+  * event for details.
+  *
+  * Explicitly destroying the xdg_popup object will also dismiss the popup and
+  * unmap the surface. Clients that want to dismiss the popup when another
+  * surface of their own is clicked should dismiss the popup using the destroy
+  * request.
+  *
+  * A newly created xdg_popup will be stacked on top of all previously created
+  * xdg_popup surfaces associated with the same xdg_toplevel.
+  *
+  * The parent of an xdg_popup must be mapped (see the xdg_surface
+  * description) before the xdg_popup itself.
+  *
+  * The x and y arguments passed when creating the popup object specify
+  * where the top left of the popup should be placed, relative to the
+  * local surface coordinates of the parent surface. See
+  * xdg_surface.get_popup. An xdg_popup must intersect with or be at least
+  * partially adjacent to its parent surface.
+  *
+  * The client must call wl_surface.commit on the corresponding wl_surface
+  * for the xdg_popup state to take effect.
+  * @section page_iface_xdg_popup_api API
+  * See @ref iface_xdg_popup.
+  */
+ /**
+  * @defgroup iface_xdg_popup The xdg_popup interface
+  *
+  * A popup surface is a short-lived, temporary surface. It can be used to
+  * implement for example menus, popovers, tooltips and other similar user
+  * interface concepts.
+  *
+  * A popup can be made to take an explicit grab. See xdg_popup.grab for
+  * details.
+  *
+  * When the popup is dismissed, a popup_done event will be sent out, and at
+  * the same time the surface will be unmapped. See the xdg_popup.popup_done
+  * event for details.
+  *
+  * Explicitly destroying the xdg_popup object will also dismiss the popup and
+  * unmap the surface. Clients that want to dismiss the popup when another
+  * surface of their own is clicked should dismiss the popup using the destroy
+  * request.
+  *
+  * A newly created xdg_popup will be stacked on top of all previously created
+  * xdg_popup surfaces associated with the same xdg_toplevel.
+  *
+  * The parent of an xdg_popup must be mapped (see the xdg_surface
+  * description) before the xdg_popup itself.
+  *
+  * The x and y arguments passed when creating the popup object specify
+  * where the top left of the popup should be placed, relative to the
+  * local surface coordinates of the parent surface. See
+  * xdg_surface.get_popup. An xdg_popup must intersect with or be at least
+  * partially adjacent to its parent surface.
+  *
+  * The client must call wl_surface.commit on the corresponding wl_surface
+  * for the xdg_popup state to take effect.
+  */
+ extern const struct wl_interface xdg_popup_interface;
+ 
+ #ifndef XDG_WM_BASE_ERROR_ENUM
+ #define XDG_WM_BASE_ERROR_ENUM
+ enum xdg_wm_base_error {
+ 	/**
+ 	 * given wl_surface has another role
+ 	 */
+ 	XDG_WM_BASE_ERROR_ROLE = 0,
+ 	/**
+ 	 * xdg_wm_base was destroyed before children
+ 	 */
+ 	XDG_WM_BASE_ERROR_DEFUNCT_SURFACES = 1,
+ 	/**
+ 	 * the client tried to map or destroy a non-topmost popup
+ 	 */
+ 	XDG_WM_BASE_ERROR_NOT_THE_TOPMOST_POPUP = 2,
+ 	/**
+ 	 * the client specified an invalid popup parent surface
+ 	 */
+ 	XDG_WM_BASE_ERROR_INVALID_POPUP_PARENT = 3,
+ 	/**
+ 	 * the client provided an invalid surface state
+ 	 */
+ 	XDG_WM_BASE_ERROR_INVALID_SURFACE_STATE = 4,
+ 	/**
+ 	 * the client provided an invalid positioner
+ 	 */
+ 	XDG_WM_BASE_ERROR_INVALID_POSITIONER = 5,
+ };
+ #endif /* XDG_WM_BASE_ERROR_ENUM */
+ 
+ /**
+  * @ingroup iface_xdg_wm_base
+  * @struct xdg_wm_base_interface
+  */
+ struct xdg_wm_base_interface {
+ 	/**
+ 	 * destroy xdg_wm_base
+ 	 *
+ 	 * Destroy this xdg_wm_base object.
+ 	 *
+ 	 * Destroying a bound xdg_wm_base object while there are surfaces
+ 	 * still alive created by this xdg_wm_base object instance is
+ 	 * illegal and will result in a protocol error.
+ 	 */
+ 	void (*destroy)(struct wl_client *client,
+ 			struct wl_resource *resource);
+ 	/**
+ 	 * create a positioner object
+ 	 *
+ 	 * Create a positioner object. A positioner object is used to
+ 	 * position surfaces relative to some parent surface. See the
+ 	 * interface description and xdg_surface.get_popup for details.
+ 	 */
+ 	void (*create_positioner)(struct wl_client *client,
+ 				  struct wl_resource *resource,
+ 				  uint32_t id);
+ 	/**
+ 	 * create a shell surface from a surface
+ 	 *
+ 	 * This creates an xdg_surface for the given surface. While
+ 	 * xdg_surface itself is not a role, the corresponding surface may
+ 	 * only be assigned a role extending xdg_surface, such as
+ 	 * xdg_toplevel or xdg_popup.
+ 	 *
+ 	 * This creates an xdg_surface for the given surface. An
+ 	 * xdg_surface is used as basis to define a role to a given
+ 	 * surface, such as xdg_toplevel or xdg_popup. It also manages
+ 	 * functionality shared between xdg_surface based surface roles.
+ 	 *
+ 	 * See the documentation of xdg_surface for more details about what
+ 	 * an xdg_surface is and how it is used.
+ 	 */
+ 	void (*get_xdg_surface)(struct wl_client *client,
+ 				struct wl_resource *resource,
+ 				uint32_t id,
+ 				struct wl_resource *surface);
+ 	/**
+ 	 * respond to a ping event
+ 	 *
+ 	 * A client must respond to a ping event with a pong request or
+ 	 * the client may be deemed unresponsive. See xdg_wm_base.ping.
+ 	 * @param serial serial of the ping event
+ 	 */
+ 	void (*pong)(struct wl_client *client,
+ 		     struct wl_resource *resource,
+ 		     uint32_t serial);
+ };
+ 
+ #define XDG_WM_BASE_PING 0
+ 
+ /**
+  * @ingroup iface_xdg_wm_base
+  */
+ #define XDG_WM_BASE_PING_SINCE_VERSION 1
+ 
+ /**
+  * @ingroup iface_xdg_wm_base
+  */
+ #define XDG_WM_BASE_DESTROY_SINCE_VERSION 1
+ /**
+  * @ingroup iface_xdg_wm_base
+  */
+ #define XDG_WM_BASE_CREATE_POSITIONER_SINCE_VERSION 1
+ /**
+  * @ingroup iface_xdg_wm_base
+  */
+ #define XDG_WM_BASE_GET_XDG_SURFACE_SINCE_VERSION 1
+ /**
+  * @ingroup iface_xdg_wm_base
+  */
+ #define XDG_WM_BASE_PONG_SINCE_VERSION 1
+ 
+ /**
+  * @ingroup iface_xdg_wm_base
+  * Sends an ping event to the client owning the resource.
+  * @param resource_ The client's resource
+  * @param serial pass this to the pong request
+  */
+ static inline void
+ xdg_wm_base_send_ping(struct wl_resource *resource_, uint32_t serial)
+ {
+ 	wl_resource_post_event(resource_, XDG_WM_BASE_PING, serial);
+ }
+ 
+ #ifndef XDG_POSITIONER_ERROR_ENUM
+ #define XDG_POSITIONER_ERROR_ENUM
+ enum xdg_positioner_error {
+ 	/**
+ 	 * invalid input provided
+ 	 */
+ 	XDG_POSITIONER_ERROR_INVALID_INPUT = 0,
+ };
+ #endif /* XDG_POSITIONER_ERROR_ENUM */
+ 
+ #ifndef XDG_POSITIONER_ANCHOR_ENUM
+ #define XDG_POSITIONER_ANCHOR_ENUM
+ enum xdg_positioner_anchor {
+ 	XDG_POSITIONER_ANCHOR_NONE = 0,
+ 	XDG_POSITIONER_ANCHOR_TOP = 1,
+ 	XDG_POSITIONER_ANCHOR_BOTTOM = 2,
+ 	XDG_POSITIONER_ANCHOR_LEFT = 3,
+ 	XDG_POSITIONER_ANCHOR_RIGHT = 4,
+ 	XDG_POSITIONER_ANCHOR_TOP_LEFT = 5,
+ 	XDG_POSITIONER_ANCHOR_BOTTOM_LEFT = 6,
+ 	XDG_POSITIONER_ANCHOR_TOP_RIGHT = 7,
+ 	XDG_POSITIONER_ANCHOR_BOTTOM_RIGHT = 8,
+ };
+ #endif /* XDG_POSITIONER_ANCHOR_ENUM */
+ 
+ #ifndef XDG_POSITIONER_GRAVITY_ENUM
+ #define XDG_POSITIONER_GRAVITY_ENUM
+ enum xdg_positioner_gravity {
+ 	XDG_POSITIONER_GRAVITY_NONE = 0,
+ 	XDG_POSITIONER_GRAVITY_TOP = 1,
+ 	XDG_POSITIONER_GRAVITY_BOTTOM = 2,
+ 	XDG_POSITIONER_GRAVITY_LEFT = 3,
+ 	XDG_POSITIONER_GRAVITY_RIGHT = 4,
+ 	XDG_POSITIONER_GRAVITY_TOP_LEFT = 5,
+ 	XDG_POSITIONER_GRAVITY_BOTTOM_LEFT = 6,
+ 	XDG_POSITIONER_GRAVITY_TOP_RIGHT = 7,
+ 	XDG_POSITIONER_GRAVITY_BOTTOM_RIGHT = 8,
+ };
+ #endif /* XDG_POSITIONER_GRAVITY_ENUM */
+ 
+ #ifndef XDG_POSITIONER_CONSTRAINT_ADJUSTMENT_ENUM
+ #define XDG_POSITIONER_CONSTRAINT_ADJUSTMENT_ENUM
+ /**
+  * @ingroup iface_xdg_positioner
+  * vertically resize the surface
+  *
+  * Resize the surface vertically so that it is completely unconstrained.
+  */
+ enum xdg_positioner_constraint_adjustment {
+ 	XDG_POSITIONER_CONSTRAINT_ADJUSTMENT_NONE = 0,
+ 	XDG_POSITIONER_CONSTRAINT_ADJUSTMENT_SLIDE_X = 1,
+ 	XDG_POSITIONER_CONSTRAINT_ADJUSTMENT_SLIDE_Y = 2,
+ 	XDG_POSITIONER_CONSTRAINT_ADJUSTMENT_FLIP_X = 4,
+ 	XDG_POSITIONER_CONSTRAINT_ADJUSTMENT_FLIP_Y = 8,
+ 	XDG_POSITIONER_CONSTRAINT_ADJUSTMENT_RESIZE_X = 16,
+ 	XDG_POSITIONER_CONSTRAINT_ADJUSTMENT_RESIZE_Y = 32,
+ };
+ #endif /* XDG_POSITIONER_CONSTRAINT_ADJUSTMENT_ENUM */
+ 
+ /**
+  * @ingroup iface_xdg_positioner
+  * @struct xdg_positioner_interface
+  */
+ struct xdg_positioner_interface {
+ 	/**
+ 	 * destroy the xdg_positioner object
+ 	 *
+ 	 * Notify the compositor that the xdg_positioner will no longer
+ 	 * be used.
+ 	 */
+ 	void (*destroy)(struct wl_client *client,
+ 			struct wl_resource *resource);
+ 	/**
+ 	 * set the size of the to-be positioned rectangle
+ 	 *
+ 	 * Set the size of the surface that is to be positioned with the
+ 	 * positioner object. The size is in surface-local coordinates and
+ 	 * corresponds to the window geometry. See
+ 	 * xdg_surface.set_window_geometry.
+ 	 *
+ 	 * If a zero or negative size is set the invalid_input error is
+ 	 * raised.
+ 	 * @param width width of positioned rectangle
+ 	 * @param height height of positioned rectangle
+ 	 */
+ 	void (*set_size)(struct wl_client *client,
+ 			 struct wl_resource *resource,
+ 			 int32_t width,
+ 			 int32_t height);
+ 	/**
+ 	 * set the anchor rectangle within the parent surface
+ 	 *
+ 	 * Specify the anchor rectangle within the parent surface that
+ 	 * the child surface will be placed relative to. The rectangle is
+ 	 * relative to the window geometry as defined by
+ 	 * xdg_surface.set_window_geometry of the parent surface.
+ 	 *
+ 	 * When the xdg_positioner object is used to position a child
+ 	 * surface, the anchor rectangle may not extend outside the window
+ 	 * geometry of the positioned child's parent surface.
+ 	 *
+ 	 * If a negative size is set the invalid_input error is raised.
+ 	 * @param x x position of anchor rectangle
+ 	 * @param y y position of anchor rectangle
+ 	 * @param width width of anchor rectangle
+ 	 * @param height height of anchor rectangle
+ 	 */
+ 	void (*set_anchor_rect)(struct wl_client *client,
+ 				struct wl_resource *resource,
+ 				int32_t x,
+ 				int32_t y,
+ 				int32_t width,
+ 				int32_t height);
+ 	/**
+ 	 * set anchor rectangle anchor
+ 	 *
+ 	 * Defines the anchor point for the anchor rectangle. The
+ 	 * specified anchor is used derive an anchor point that the child
+ 	 * surface will be positioned relative to. If a corner anchor is
+ 	 * set (e.g. 'top_left' or 'bottom_right'), the anchor point will
+ 	 * be at the specified corner; otherwise, the derived anchor point
+ 	 * will be centered on the specified edge, or in the center of the
+ 	 * anchor rectangle if no edge is specified.
+ 	 * @param anchor anchor
+ 	 */
+ 	void (*set_anchor)(struct wl_client *client,
+ 			   struct wl_resource *resource,
+ 			   uint32_t anchor);
+ 	/**
+ 	 * set child surface gravity
+ 	 *
+ 	 * Defines in what direction a surface should be positioned,
+ 	 * relative to the anchor point of the parent surface. If a corner
+ 	 * gravity is specified (e.g. 'bottom_right' or 'top_left'), then
+ 	 * the child surface will be placed towards the specified gravity;
+ 	 * otherwise, the child surface will be centered over the anchor
+ 	 * point on any axis that had no gravity specified.
+ 	 * @param gravity gravity direction
+ 	 */
+ 	void (*set_gravity)(struct wl_client *client,
+ 			    struct wl_resource *resource,
+ 			    uint32_t gravity);
+ 	/**
+ 	 * set the adjustment to be done when constrained
+ 	 *
+ 	 * Specify how the window should be positioned if the originally
+ 	 * intended position caused the surface to be constrained, meaning
+ 	 * at least partially outside positioning boundaries set by the
+ 	 * compositor. The adjustment is set by constructing a bitmask
+ 	 * describing the adjustment to be made when the surface is
+ 	 * constrained on that axis.
+ 	 *
+ 	 * If no bit for one axis is set, the compositor will assume that
+ 	 * the child surface should not change its position on that axis
+ 	 * when constrained.
+ 	 *
+ 	 * If more than one bit for one axis is set, the order of how
+ 	 * adjustments are applied is specified in the corresponding
+ 	 * adjustment descriptions.
+ 	 *
+ 	 * The default adjustment is none.
+ 	 * @param constraint_adjustment bit mask of constraint adjustments
+ 	 */
+ 	void (*set_constraint_adjustment)(struct wl_client *client,
+ 					  struct wl_resource *resource,
+ 					  uint32_t constraint_adjustment);
+ 	/**
+ 	 * set surface position offset
+ 	 *
+ 	 * Specify the surface position offset relative to the position
+ 	 * of the anchor on the anchor rectangle and the anchor on the
+ 	 * surface. For example if the anchor of the anchor rectangle is at
+ 	 * (x, y), the surface has the gravity bottom|right, and the offset
+ 	 * is (ox, oy), the calculated surface position will be (x + ox, y
+ 	 * + oy). The offset position of the surface is the one used for
+ 	 * constraint testing. See set_constraint_adjustment.
+ 	 *
+ 	 * An example use case is placing a popup menu on top of a user
+ 	 * interface element, while aligning the user interface element of
+ 	 * the parent surface with some user interface element placed
+ 	 * somewhere in the popup surface.
+ 	 * @param x surface position x offset
+ 	 * @param y surface position y offset
+ 	 */
+ 	void (*set_offset)(struct wl_client *client,
+ 			   struct wl_resource *resource,
+ 			   int32_t x,
+ 			   int32_t y);
+ };
+ 
+ 
+ /**
+  * @ingroup iface_xdg_positioner
+  */
+ #define XDG_POSITIONER_DESTROY_SINCE_VERSION 1
+ /**
+  * @ingroup iface_xdg_positioner
+  */
+ #define XDG_POSITIONER_SET_SIZE_SINCE_VERSION 1
+ /**
+  * @ingroup iface_xdg_positioner
+  */
+ #define XDG_POSITIONER_SET_ANCHOR_RECT_SINCE_VERSION 1
+ /**
+  * @ingroup iface_xdg_positioner
+  */
+ #define XDG_POSITIONER_SET_ANCHOR_SINCE_VERSION 1
+ /**
+  * @ingroup iface_xdg_positioner
+  */
+ #define XDG_POSITIONER_SET_GRAVITY_SINCE_VERSION 1
+ /**
+  * @ingroup iface_xdg_positioner
+  */
+ #define XDG_POSITIONER_SET_CONSTRAINT_ADJUSTMENT_SINCE_VERSION 1
+ /**
+  * @ingroup iface_xdg_positioner
+  */
+ #define XDG_POSITIONER_SET_OFFSET_SINCE_VERSION 1
+ 
+ #ifndef XDG_SURFACE_ERROR_ENUM
+ #define XDG_SURFACE_ERROR_ENUM
+ enum xdg_surface_error {
+ 	XDG_SURFACE_ERROR_NOT_CONSTRUCTED = 1,
+ 	XDG_SURFACE_ERROR_ALREADY_CONSTRUCTED = 2,
+ 	XDG_SURFACE_ERROR_UNCONFIGURED_BUFFER = 3,
+ };
+ #endif /* XDG_SURFACE_ERROR_ENUM */
+ 
+ /**
+  * @ingroup iface_xdg_surface
+  * @struct xdg_surface_interface
+  */
+ struct xdg_surface_interface {
+ 	/**
+ 	 * destroy the xdg_surface
+ 	 *
+ 	 * Destroy the xdg_surface object. An xdg_surface must only be
+ 	 * destroyed after its role object has been destroyed.
+ 	 */
+ 	void (*destroy)(struct wl_client *client,
+ 			struct wl_resource *resource);
+ 	/**
+ 	 * assign the xdg_toplevel surface role
+ 	 *
+ 	 * This creates an xdg_toplevel object for the given xdg_surface
+ 	 * and gives the associated wl_surface the xdg_toplevel role.
+ 	 *
+ 	 * See the documentation of xdg_toplevel for more details about
+ 	 * what an xdg_toplevel is and how it is used.
+ 	 */
+ 	void (*get_toplevel)(struct wl_client *client,
+ 			     struct wl_resource *resource,
+ 			     uint32_t id);
+ 	/**
+ 	 * assign the xdg_popup surface role
+ 	 *
+ 	 * This creates an xdg_popup object for the given xdg_surface and
+ 	 * gives the associated wl_surface the xdg_popup role.
+ 	 *
+ 	 * If null is passed as a parent, a parent surface must be
+ 	 * specified using some other protocol, before committing the
+ 	 * initial state.
+ 	 *
+ 	 * See the documentation of xdg_popup for more details about what
+ 	 * an xdg_popup is and how it is used.
+ 	 */
+ 	void (*get_popup)(struct wl_client *client,
+ 			  struct wl_resource *resource,
+ 			  uint32_t id,
+ 			  struct wl_resource *parent,
+ 			  struct wl_resource *positioner);
+ 	/**
+ 	 * set the new window geometry
+ 	 *
+ 	 * The window geometry of a surface is its "visible bounds" from
+ 	 * the user's perspective. Client-side decorations often have
+ 	 * invisible portions like drop-shadows which should be ignored for
+ 	 * the purposes of aligning, placing and constraining windows.
+ 	 *
+ 	 * The window geometry is double buffered, and will be applied at
+ 	 * the time wl_surface.commit of the corresponding wl_surface is
+ 	 * called.
+ 	 *
+ 	 * When maintaining a position, the compositor should treat the (x,
+ 	 * y) coordinate of the window geometry as the top left corner of
+ 	 * the window. A client changing the (x, y) window geometry
+ 	 * coordinate should in general not alter the position of the
+ 	 * window.
+ 	 *
+ 	 * Once the window geometry of the surface is set, it is not
+ 	 * possible to unset it, and it will remain the same until
+ 	 * set_window_geometry is called again, even if a new subsurface or
+ 	 * buffer is attached.
+ 	 *
+ 	 * If never set, the value is the full bounds of the surface,
+ 	 * including any subsurfaces. This updates dynamically on every
+ 	 * commit. This unset is meant for extremely simple clients.
+ 	 *
+ 	 * The arguments are given in the surface-local coordinate space of
+ 	 * the wl_surface associated with this xdg_surface.
+ 	 *
+ 	 * The width and height must be greater than zero. Setting an
+ 	 * invalid size will raise an error. When applied, the effective
+ 	 * window geometry will be the set window geometry clamped to the
+ 	 * bounding rectangle of the combined geometry of the surface of
+ 	 * the xdg_surface and the associated subsurfaces.
+ 	 */
+ 	void (*set_window_geometry)(struct wl_client *client,
+ 				    struct wl_resource *resource,
+ 				    int32_t x,
+ 				    int32_t y,
+ 				    int32_t width,
+ 				    int32_t height);
+ 	/**
+ 	 * ack a configure event
+ 	 *
+ 	 * When a configure event is received, if a client commits the
+ 	 * surface in response to the configure event, then the client must
+ 	 * make an ack_configure request sometime before the commit
+ 	 * request, passing along the serial of the configure event.
+ 	 *
+ 	 * For instance, for toplevel surfaces the compositor might use
+ 	 * this information to move a surface to the top left only when the
+ 	 * client has drawn itself for the maximized or fullscreen state.
+ 	 *
+ 	 * If the client receives multiple configure events before it can
+ 	 * respond to one, it only has to ack the last configure event.
+ 	 *
+ 	 * A client is not required to commit immediately after sending an
+ 	 * ack_configure request - it may even ack_configure several times
+ 	 * before its next surface commit.
+ 	 *
+ 	 * A client may send multiple ack_configure requests before
+ 	 * committing, but only the last request sent before a commit
+ 	 * indicates which configure event the client really is responding
+ 	 * to.
+ 	 * @param serial the serial from the configure event
+ 	 */
+ 	void (*ack_configure)(struct wl_client *client,
+ 			      struct wl_resource *resource,
+ 			      uint32_t serial);
+ };
+ 
+ #define XDG_SURFACE_CONFIGURE 0
+ 
+ /**
+  * @ingroup iface_xdg_surface
+  */
+ #define XDG_SURFACE_CONFIGURE_SINCE_VERSION 1
+ 
+ /**
+  * @ingroup iface_xdg_surface
+  */
+ #define XDG_SURFACE_DESTROY_SINCE_VERSION 1
+ /**
+  * @ingroup iface_xdg_surface
+  */
+ #define XDG_SURFACE_GET_TOPLEVEL_SINCE_VERSION 1
+ /**
+  * @ingroup iface_xdg_surface
+  */
+ #define XDG_SURFACE_GET_POPUP_SINCE_VERSION 1
+ /**
+  * @ingroup iface_xdg_surface
+  */
+ #define XDG_SURFACE_SET_WINDOW_GEOMETRY_SINCE_VERSION 1
+ /**
+  * @ingroup iface_xdg_surface
+  */
+ #define XDG_SURFACE_ACK_CONFIGURE_SINCE_VERSION 1
+ 
+ /**
+  * @ingroup iface_xdg_surface
+  * Sends an configure event to the client owning the resource.
+  * @param resource_ The client's resource
+  * @param serial serial of the configure event
+  */
+ static inline void
+ xdg_surface_send_configure(struct wl_resource *resource_, uint32_t serial)
+ {
+ 	wl_resource_post_event(resource_, XDG_SURFACE_CONFIGURE, serial);
+ }
+ 
+ #ifndef XDG_TOPLEVEL_RESIZE_EDGE_ENUM
+ #define XDG_TOPLEVEL_RESIZE_EDGE_ENUM
+ /**
+  * @ingroup iface_xdg_toplevel
+  * edge values for resizing
+  *
+  * These values are used to indicate which edge of a surface
+  * is being dragged in a resize operation.
+  */
+ enum xdg_toplevel_resize_edge {
+ 	XDG_TOPLEVEL_RESIZE_EDGE_NONE = 0,
+ 	XDG_TOPLEVEL_RESIZE_EDGE_TOP = 1,
+ 	XDG_TOPLEVEL_RESIZE_EDGE_BOTTOM = 2,
+ 	XDG_TOPLEVEL_RESIZE_EDGE_LEFT = 4,
+ 	XDG_TOPLEVEL_RESIZE_EDGE_TOP_LEFT = 5,
+ 	XDG_TOPLEVEL_RESIZE_EDGE_BOTTOM_LEFT = 6,
+ 	XDG_TOPLEVEL_RESIZE_EDGE_RIGHT = 8,
+ 	XDG_TOPLEVEL_RESIZE_EDGE_TOP_RIGHT = 9,
+ 	XDG_TOPLEVEL_RESIZE_EDGE_BOTTOM_RIGHT = 10,
+ };
+ #endif /* XDG_TOPLEVEL_RESIZE_EDGE_ENUM */
+ 
+ #ifndef XDG_TOPLEVEL_STATE_ENUM
+ #define XDG_TOPLEVEL_STATE_ENUM
+ /**
+  * @ingroup iface_xdg_toplevel
+  * the surface is tiled
+  *
+  * The window is currently in a tiled layout and the bottom edge is
+  * considered to be adjacent to another part of the tiling grid.
+  */
+ enum xdg_toplevel_state {
+ 	/**
+ 	 * the surface is maximized
+ 	 */
+ 	XDG_TOPLEVEL_STATE_MAXIMIZED = 1,
+ 	/**
+ 	 * the surface is fullscreen
+ 	 */
+ 	XDG_TOPLEVEL_STATE_FULLSCREEN = 2,
+ 	/**
+ 	 * the surface is being resized
+ 	 */
+ 	XDG_TOPLEVEL_STATE_RESIZING = 3,
+ 	/**
+ 	 * the surface is now activated
+ 	 */
+ 	XDG_TOPLEVEL_STATE_ACTIVATED = 4,
+ 	/**
+ 	 * @since 2
+ 	 */
+ 	XDG_TOPLEVEL_STATE_TILED_LEFT = 5,
+ 	/**
+ 	 * @since 2
+ 	 */
+ 	XDG_TOPLEVEL_STATE_TILED_RIGHT = 6,
+ 	/**
+ 	 * @since 2
+ 	 */
+ 	XDG_TOPLEVEL_STATE_TILED_TOP = 7,
+ 	/**
+ 	 * @since 2
+ 	 */
+ 	XDG_TOPLEVEL_STATE_TILED_BOTTOM = 8,
+ };
+ /**
+  * @ingroup iface_xdg_toplevel
+  */
+ #define XDG_TOPLEVEL_STATE_TILED_LEFT_SINCE_VERSION 2
+ /**
+  * @ingroup iface_xdg_toplevel
+  */
+ #define XDG_TOPLEVEL_STATE_TILED_RIGHT_SINCE_VERSION 2
+ /**
+  * @ingroup iface_xdg_toplevel
+  */
+ #define XDG_TOPLEVEL_STATE_TILED_TOP_SINCE_VERSION 2
+ /**
+  * @ingroup iface_xdg_toplevel
+  */
+ #define XDG_TOPLEVEL_STATE_TILED_BOTTOM_SINCE_VERSION 2
+ #endif /* XDG_TOPLEVEL_STATE_ENUM */
+ 
+ /**
+  * @ingroup iface_xdg_toplevel
+  * @struct xdg_toplevel_interface
+  */
+ struct xdg_toplevel_interface {
+ 	/**
+ 	 * destroy the xdg_toplevel
+ 	 *
+ 	 * This request destroys the role surface and unmaps the surface;
+ 	 * see "Unmapping" behavior in interface section for details.
+ 	 */
+ 	void (*destroy)(struct wl_client *client,
+ 			struct wl_resource *resource);
+ 	/**
+ 	 * set the parent of this surface
+ 	 *
+ 	 * Set the "parent" of this surface. This surface should be
+ 	 * stacked above the parent surface and all other ancestor
+ 	 * surfaces.
+ 	 *
+ 	 * Parent windows should be set on dialogs, toolboxes, or other
+ 	 * "auxiliary" surfaces, so that the parent is raised when the
+ 	 * dialog is raised.
+ 	 *
+ 	 * Setting a null parent for a child window removes any
+ 	 * parent-child relationship for the child. Setting a null parent
+ 	 * for a window which currently has no parent is a no-op.
+ 	 *
+ 	 * If the parent is unmapped then its children are managed as
+ 	 * though the parent of the now-unmapped parent has become the
+ 	 * parent of this surface. If no parent exists for the now-unmapped
+ 	 * parent then the children are managed as though they have no
+ 	 * parent surface.
+ 	 */
+ 	void (*set_parent)(struct wl_client *client,
+ 			   struct wl_resource *resource,
+ 			   struct wl_resource *parent);
+ 	/**
+ 	 * set surface title
+ 	 *
+ 	 * Set a short title for the surface.
+ 	 *
+ 	 * This string may be used to identify the surface in a task bar,
+ 	 * window list, or other user interface elements provided by the
+ 	 * compositor.
+ 	 *
+ 	 * The string must be encoded in UTF-8.
+ 	 */
+ 	void (*set_title)(struct wl_client *client,
+ 			  struct wl_resource *resource,
+ 			  const char *title);
+ 	/**
+ 	 * set application ID
+ 	 *
+ 	 * Set an application identifier for the surface.
+ 	 *
+ 	 * The app ID identifies the general class of applications to which
+ 	 * the surface belongs. The compositor can use this to group
+ 	 * multiple surfaces together, or to determine how to launch a new
+ 	 * application.
+ 	 *
+ 	 * For D-Bus activatable applications, the app ID is used as the
+ 	 * D-Bus service name.
+ 	 *
+ 	 * The compositor shell will try to group application surfaces
+ 	 * together by their app ID. As a best practice, it is suggested to
+ 	 * select app ID's that match the basename of the application's
+ 	 * .desktop file. For example, "org.freedesktop.FooViewer" where
+ 	 * the .desktop file is "org.freedesktop.FooViewer.desktop".
+ 	 *
+ 	 * See the desktop-entry specification [0] for more details on
+ 	 * application identifiers and how they relate to well-known D-Bus
+ 	 * names and .desktop files.
+ 	 *
+ 	 * [0] http://standards.freedesktop.org/desktop-entry-spec/
+ 	 */
+ 	void (*set_app_id)(struct wl_client *client,
+ 			   struct wl_resource *resource,
+ 			   const char *app_id);
+ 	/**
+ 	 * show the window menu
+ 	 *
+ 	 * Clients implementing client-side decorations might want to
+ 	 * show a context menu when right-clicking on the decorations,
+ 	 * giving the user a menu that they can use to maximize or minimize
+ 	 * the window.
+ 	 *
+ 	 * This request asks the compositor to pop up such a window menu at
+ 	 * the given position, relative to the local surface coordinates of
+ 	 * the parent surface. There are no guarantees as to what menu
+ 	 * items the window menu contains.
+ 	 *
+ 	 * This request must be used in response to some sort of user
+ 	 * action like a button press, key press, or touch down event.
+ 	 * @param seat the wl_seat of the user event
+ 	 * @param serial the serial of the user event
+ 	 * @param x the x position to pop up the window menu at
+ 	 * @param y the y position to pop up the window menu at
+ 	 */
+ 	void (*show_window_menu)(struct wl_client *client,
+ 				 struct wl_resource *resource,
+ 				 struct wl_resource *seat,
+ 				 uint32_t serial,
+ 				 int32_t x,
+ 				 int32_t y);
+ 	/**
+ 	 * start an interactive move
+ 	 *
+ 	 * Start an interactive, user-driven move of the surface.
+ 	 *
+ 	 * This request must be used in response to some sort of user
+ 	 * action like a button press, key press, or touch down event. The
+ 	 * passed serial is used to determine the type of interactive move
+ 	 * (touch, pointer, etc).
+ 	 *
+ 	 * The server may ignore move requests depending on the state of
+ 	 * the surface (e.g. fullscreen or maximized), or if the passed
+ 	 * serial is no longer valid.
+ 	 *
+ 	 * If triggered, the surface will lose the focus of the device
+ 	 * (wl_pointer, wl_touch, etc) used for the move. It is up to the
+ 	 * compositor to visually indicate that the move is taking place,
+ 	 * such as updating a pointer cursor, during the move. There is no
+ 	 * guarantee that the device focus will return when the move is
+ 	 * completed.
+ 	 * @param seat the wl_seat of the user event
+ 	 * @param serial the serial of the user event
+ 	 */
+ 	void (*move)(struct wl_client *client,
+ 		     struct wl_resource *resource,
+ 		     struct wl_resource *seat,
+ 		     uint32_t serial);
+ 	/**
+ 	 * start an interactive resize
+ 	 *
+ 	 * Start a user-driven, interactive resize of the surface.
+ 	 *
+ 	 * This request must be used in response to some sort of user
+ 	 * action like a button press, key press, or touch down event. The
+ 	 * passed serial is used to determine the type of interactive
+ 	 * resize (touch, pointer, etc).
+ 	 *
+ 	 * The server may ignore resize requests depending on the state of
+ 	 * the surface (e.g. fullscreen or maximized).
+ 	 *
+ 	 * If triggered, the client will receive configure events with the
+ 	 * "resize" state enum value and the expected sizes. See the
+ 	 * "resize" enum value for more details about what is required. The
+ 	 * client must also acknowledge configure events using
+ 	 * "ack_configure". After the resize is completed, the client will
+ 	 * receive another "configure" event without the resize state.
+ 	 *
+ 	 * If triggered, the surface also will lose the focus of the device
+ 	 * (wl_pointer, wl_touch, etc) used for the resize. It is up to the
+ 	 * compositor to visually indicate that the resize is taking place,
+ 	 * such as updating a pointer cursor, during the resize. There is
+ 	 * no guarantee that the device focus will return when the resize
+ 	 * is completed.
+ 	 *
+ 	 * The edges parameter specifies how the surface should be resized,
+ 	 * and is one of the values of the resize_edge enum. The compositor
+ 	 * may use this information to update the surface position for
+ 	 * example when dragging the top left corner. The compositor may
+ 	 * also use this information to adapt its behavior, e.g. choose an
+ 	 * appropriate cursor image.
+ 	 * @param seat the wl_seat of the user event
+ 	 * @param serial the serial of the user event
+ 	 * @param edges which edge or corner is being dragged
+ 	 */
+ 	void (*resize)(struct wl_client *client,
+ 		       struct wl_resource *resource,
+ 		       struct wl_resource *seat,
+ 		       uint32_t serial,
+ 		       uint32_t edges);
+ 	/**
+ 	 * set the maximum size
+ 	 *
+ 	 * Set a maximum size for the window.
+ 	 *
+ 	 * The client can specify a maximum size so that the compositor
+ 	 * does not try to configure the window beyond this size.
+ 	 *
+ 	 * The width and height arguments are in window geometry
+ 	 * coordinates. See xdg_surface.set_window_geometry.
+ 	 *
+ 	 * Values set in this way are double-buffered. They will get
+ 	 * applied on the next commit.
+ 	 *
+ 	 * The compositor can use this information to allow or disallow
+ 	 * different states like maximize or fullscreen and draw accurate
+ 	 * animations.
+ 	 *
+ 	 * Similarly, a tiling window manager may use this information to
+ 	 * place and resize client windows in a more effective way.
+ 	 *
+ 	 * The client should not rely on the compositor to obey the maximum
+ 	 * size. The compositor may decide to ignore the values set by the
+ 	 * client and request a larger size.
+ 	 *
+ 	 * If never set, or a value of zero in the request, means that the
+ 	 * client has no expected maximum size in the given dimension. As a
+ 	 * result, a client wishing to reset the maximum size to an
+ 	 * unspecified state can use zero for width and height in the
+ 	 * request.
+ 	 *
+ 	 * Requesting a maximum size to be smaller than the minimum size of
+ 	 * a surface is illegal and will result in a protocol error.
+ 	 *
+ 	 * The width and height must be greater than or equal to zero.
+ 	 * Using strictly negative values for width and height will result
+ 	 * in a protocol error.
+ 	 */
+ 	void (*set_max_size)(struct wl_client *client,
+ 			     struct wl_resource *resource,
+ 			     int32_t width,
+ 			     int32_t height);
+ 	/**
+ 	 * set the minimum size
+ 	 *
+ 	 * Set a minimum size for the window.
+ 	 *
+ 	 * The client can specify a minimum size so that the compositor
+ 	 * does not try to configure the window below this size.
+ 	 *
+ 	 * The width and height arguments are in window geometry
+ 	 * coordinates. See xdg_surface.set_window_geometry.
+ 	 *
+ 	 * Values set in this way are double-buffered. They will get
+ 	 * applied on the next commit.
+ 	 *
+ 	 * The compositor can use this information to allow or disallow
+ 	 * different states like maximize or fullscreen and draw accurate
+ 	 * animations.
+ 	 *
+ 	 * Similarly, a tiling window manager may use this information to
+ 	 * place and resize client windows in a more effective way.
+ 	 *
+ 	 * The client should not rely on the compositor to obey the minimum
+ 	 * size. The compositor may decide to ignore the values set by the
+ 	 * client and request a smaller size.
+ 	 *
+ 	 * If never set, or a value of zero in the request, means that the
+ 	 * client has no expected minimum size in the given dimension. As a
+ 	 * result, a client wishing to reset the minimum size to an
+ 	 * unspecified state can use zero for width and height in the
+ 	 * request.
+ 	 *
+ 	 * Requesting a minimum size to be larger than the maximum size of
+ 	 * a surface is illegal and will result in a protocol error.
+ 	 *
+ 	 * The width and height must be greater than or equal to zero.
+ 	 * Using strictly negative values for width and height will result
+ 	 * in a protocol error.
+ 	 */
+ 	void (*set_min_size)(struct wl_client *client,
+ 			     struct wl_resource *resource,
+ 			     int32_t width,
+ 			     int32_t height);
+ 	/**
+ 	 * maximize the window
+ 	 *
+ 	 * Maximize the surface.
+ 	 *
+ 	 * After requesting that the surface should be maximized, the
+ 	 * compositor will respond by emitting a configure event. Whether
+ 	 * this configure actually sets the window maximized is subject to
+ 	 * compositor policies. The client must then update its content,
+ 	 * drawing in the configured state. The client must also
+ 	 * acknowledge the configure when committing the new content (see
+ 	 * ack_configure).
+ 	 *
+ 	 * It is up to the compositor to decide how and where to maximize
+ 	 * the surface, for example which output and what region of the
+ 	 * screen should be used.
+ 	 *
+ 	 * If the surface was already maximized, the compositor will still
+ 	 * emit a configure event with the "maximized" state.
+ 	 *
+ 	 * If the surface is in a fullscreen state, this request has no
+ 	 * direct effect. It may alter the state the surface is returned to
+ 	 * when unmaximized unless overridden by the compositor.
+ 	 */
+ 	void (*set_maximized)(struct wl_client *client,
+ 			      struct wl_resource *resource);
+ 	/**
+ 	 * unmaximize the window
+ 	 *
+ 	 * Unmaximize the surface.
+ 	 *
+ 	 * After requesting that the surface should be unmaximized, the
+ 	 * compositor will respond by emitting a configure event. Whether
+ 	 * this actually un-maximizes the window is subject to compositor
+ 	 * policies. If available and applicable, the compositor will
+ 	 * include the window geometry dimensions the window had prior to
+ 	 * being maximized in the configure event. The client must then
+ 	 * update its content, drawing it in the configured state. The
+ 	 * client must also acknowledge the configure when committing the
+ 	 * new content (see ack_configure).
+ 	 *
+ 	 * It is up to the compositor to position the surface after it was
+ 	 * unmaximized; usually the position the surface had before
+ 	 * maximizing, if applicable.
+ 	 *
+ 	 * If the surface was already not maximized, the compositor will
+ 	 * still emit a configure event without the "maximized" state.
+ 	 *
+ 	 * If the surface is in a fullscreen state, this request has no
+ 	 * direct effect. It may alter the state the surface is returned to
+ 	 * when unmaximized unless overridden by the compositor.
+ 	 */
+ 	void (*unset_maximized)(struct wl_client *client,
+ 				struct wl_resource *resource);
+ 	/**
+ 	 * set the window as fullscreen on an output
+ 	 *
+ 	 * Make the surface fullscreen.
+ 	 *
+ 	 * After requesting that the surface should be fullscreened, the
+ 	 * compositor will respond by emitting a configure event. Whether
+ 	 * the client is actually put into a fullscreen state is subject to
+ 	 * compositor policies. The client must also acknowledge the
+ 	 * configure when committing the new content (see ack_configure).
+ 	 *
+ 	 * The output passed by the request indicates the client's
+ 	 * preference as to which display it should be set fullscreen on.
+ 	 * If this value is NULL, it's up to the compositor to choose which
+ 	 * display will be used to map this surface.
+ 	 *
+ 	 * If the surface doesn't cover the whole output, the compositor
+ 	 * will position the surface in the center of the output and
+ 	 * compensate with with border fill covering the rest of the
+ 	 * output. The content of the border fill is undefined, but should
+ 	 * be assumed to be in some way that attempts to blend into the
+ 	 * surrounding area (e.g. solid black).
+ 	 *
+ 	 * If the fullscreened surface is not opaque, the compositor must
+ 	 * make sure that other screen content not part of the same surface
+ 	 * tree (made up of subsurfaces, popups or similarly coupled
+ 	 * surfaces) are not visible below the fullscreened surface.
+ 	 */
+ 	void (*set_fullscreen)(struct wl_client *client,
+ 			       struct wl_resource *resource,
+ 			       struct wl_resource *output);
+ 	/**
+ 	 * unset the window as fullscreen
+ 	 *
+ 	 * Make the surface no longer fullscreen.
+ 	 *
+ 	 * After requesting that the surface should be unfullscreened, the
+ 	 * compositor will respond by emitting a configure event. Whether
+ 	 * this actually removes the fullscreen state of the client is
+ 	 * subject to compositor policies.
+ 	 *
+ 	 * Making a surface unfullscreen sets states for the surface based
+ 	 * on the following: * the state(s) it may have had before becoming
+ 	 * fullscreen * any state(s) decided by the compositor * any
+ 	 * state(s) requested by the client while the surface was
+ 	 * fullscreen
+ 	 *
+ 	 * The compositor may include the previous window geometry
+ 	 * dimensions in the configure event, if applicable.
+ 	 *
+ 	 * The client must also acknowledge the configure when committing
+ 	 * the new content (see ack_configure).
+ 	 */
+ 	void (*unset_fullscreen)(struct wl_client *client,
+ 				 struct wl_resource *resource);
+ 	/**
+ 	 * set the window as minimized
+ 	 *
+ 	 * Request that the compositor minimize your surface. There is no
+ 	 * way to know if the surface is currently minimized, nor is there
+ 	 * any way to unset minimization on this surface.
+ 	 *
+ 	 * If you are looking to throttle redrawing when minimized, please
+ 	 * instead use the wl_surface.frame event for this, as this will
+ 	 * also work with live previews on windows in Alt-Tab, Expose or
+ 	 * similar compositor features.
+ 	 */
+ 	void (*set_minimized)(struct wl_client *client,
+ 			      struct wl_resource *resource);
+ };
+ 
+ #define XDG_TOPLEVEL_CONFIGURE 0
+ #define XDG_TOPLEVEL_CLOSE 1
+ 
+ /**
+  * @ingroup iface_xdg_toplevel
+  */
+ #define XDG_TOPLEVEL_CONFIGURE_SINCE_VERSION 1
+ /**
+  * @ingroup iface_xdg_toplevel
+  */
+ #define XDG_TOPLEVEL_CLOSE_SINCE_VERSION 1
+ 
+ /**
+  * @ingroup iface_xdg_toplevel
+  */
+ #define XDG_TOPLEVEL_DESTROY_SINCE_VERSION 1
+ /**
+  * @ingroup iface_xdg_toplevel
+  */
+ #define XDG_TOPLEVEL_SET_PARENT_SINCE_VERSION 1
+ /**
+  * @ingroup iface_xdg_toplevel
+  */
+ #define XDG_TOPLEVEL_SET_TITLE_SINCE_VERSION 1
+ /**
+  * @ingroup iface_xdg_toplevel
+  */
+ #define XDG_TOPLEVEL_SET_APP_ID_SINCE_VERSION 1
+ /**
+  * @ingroup iface_xdg_toplevel
+  */
+ #define XDG_TOPLEVEL_SHOW_WINDOW_MENU_SINCE_VERSION 1
+ /**
+  * @ingroup iface_xdg_toplevel
+  */
+ #define XDG_TOPLEVEL_MOVE_SINCE_VERSION 1
+ /**
+  * @ingroup iface_xdg_toplevel
+  */
+ #define XDG_TOPLEVEL_RESIZE_SINCE_VERSION 1
+ /**
+  * @ingroup iface_xdg_toplevel
+  */
+ #define XDG_TOPLEVEL_SET_MAX_SIZE_SINCE_VERSION 1
+ /**
+  * @ingroup iface_xdg_toplevel
+  */
+ #define XDG_TOPLEVEL_SET_MIN_SIZE_SINCE_VERSION 1
+ /**
+  * @ingroup iface_xdg_toplevel
+  */
+ #define XDG_TOPLEVEL_SET_MAXIMIZED_SINCE_VERSION 1
+ /**
+  * @ingroup iface_xdg_toplevel
+  */
+ #define XDG_TOPLEVEL_UNSET_MAXIMIZED_SINCE_VERSION 1
+ /**
+  * @ingroup iface_xdg_toplevel
+  */
+ #define XDG_TOPLEVEL_SET_FULLSCREEN_SINCE_VERSION 1
+ /**
+  * @ingroup iface_xdg_toplevel
+  */
+ #define XDG_TOPLEVEL_UNSET_FULLSCREEN_SINCE_VERSION 1
+ /**
+  * @ingroup iface_xdg_toplevel
+  */
+ #define XDG_TOPLEVEL_SET_MINIMIZED_SINCE_VERSION 1
+ 
+ /**
+  * @ingroup iface_xdg_toplevel
+  * Sends an configure event to the client owning the resource.
+  * @param resource_ The client's resource
+  */
+ static inline void
+ xdg_toplevel_send_configure(struct wl_resource *resource_, int32_t width, int32_t height, struct wl_array *states)
+ {
+ 	wl_resource_post_event(resource_, XDG_TOPLEVEL_CONFIGURE, width, height, states);
+ }
+ 
+ /**
+  * @ingroup iface_xdg_toplevel
+  * Sends an close event to the client owning the resource.
+  * @param resource_ The client's resource
+  */
+ static inline void
+ xdg_toplevel_send_close(struct wl_resource *resource_)
+ {
+ 	wl_resource_post_event(resource_, XDG_TOPLEVEL_CLOSE);
+ }
+ 
+ #ifndef XDG_POPUP_ERROR_ENUM
+ #define XDG_POPUP_ERROR_ENUM
+ enum xdg_popup_error {
+ 	/**
+ 	 * tried to grab after being mapped
+ 	 */
+ 	XDG_POPUP_ERROR_INVALID_GRAB = 0,
+ };
+ #endif /* XDG_POPUP_ERROR_ENUM */
+ 
+ /**
+  * @ingroup iface_xdg_popup
+  * @struct xdg_popup_interface
+  */
+ struct xdg_popup_interface {
+ 	/**
+ 	 * remove xdg_popup interface
+ 	 *
+ 	 * This destroys the popup. Explicitly destroying the xdg_popup
+ 	 * object will also dismiss the popup, and unmap the surface.
+ 	 *
+ 	 * If this xdg_popup is not the "topmost" popup, a protocol error
+ 	 * will be sent.
+ 	 */
+ 	void (*destroy)(struct wl_client *client,
+ 			struct wl_resource *resource);
+ 	/**
+ 	 * make the popup take an explicit grab
+ 	 *
+ 	 * This request makes the created popup take an explicit grab. An
+ 	 * explicit grab will be dismissed when the user dismisses the
+ 	 * popup, or when the client destroys the xdg_popup. This can be
+ 	 * done by the user clicking outside the surface, using the
+ 	 * keyboard, or even locking the screen through closing the lid or
+ 	 * a timeout.
+ 	 *
+ 	 * If the compositor denies the grab, the popup will be immediately
+ 	 * dismissed.
+ 	 *
+ 	 * This request must be used in response to some sort of user
+ 	 * action like a button press, key press, or touch down event. The
+ 	 * serial number of the event should be passed as 'serial'.
+ 	 *
+ 	 * The parent of a grabbing popup must either be an xdg_toplevel
+ 	 * surface or another xdg_popup with an explicit grab. If the
+ 	 * parent is another xdg_popup it means that the popups are nested,
+ 	 * with this popup now being the topmost popup.
+ 	 *
+ 	 * Nested popups must be destroyed in the reverse order they were
+ 	 * created in, e.g. the only popup you are allowed to destroy at
+ 	 * all times is the topmost one.
+ 	 *
+ 	 * When compositors choose to dismiss a popup, they may dismiss
+ 	 * every nested grabbing popup as well. When a compositor dismisses
+ 	 * popups, it will follow the same dismissing order as required
+ 	 * from the client.
+ 	 *
+ 	 * The parent of a grabbing popup must either be another xdg_popup
+ 	 * with an active explicit grab, or an xdg_popup or xdg_toplevel,
+ 	 * if there are no explicit grabs already taken.
+ 	 *
+ 	 * If the topmost grabbing popup is destroyed, the grab will be
+ 	 * returned to the parent of the popup, if that parent previously
+ 	 * had an explicit grab.
+ 	 *
+ 	 * If the parent is a grabbing popup which has already been
+ 	 * dismissed, this popup will be immediately dismissed. If the
+ 	 * parent is a popup that did not take an explicit grab, an error
+ 	 * will be raised.
+ 	 *
+ 	 * During a popup grab, the client owning the grab will receive
+ 	 * pointer and touch events for all their surfaces as normal
+ 	 * (similar to an "owner-events" grab in X11 parlance), while the
+ 	 * top most grabbing popup will always have keyboard focus.
+ 	 * @param seat the wl_seat of the user event
+ 	 * @param serial the serial of the user event
+ 	 */
+ 	void (*grab)(struct wl_client *client,
+ 		     struct wl_resource *resource,
+ 		     struct wl_resource *seat,
+ 		     uint32_t serial);
+ };
+ 
+ #define XDG_POPUP_CONFIGURE 0
+ #define XDG_POPUP_POPUP_DONE 1
+ 
+ /**
+  * @ingroup iface_xdg_popup
+  */
+ #define XDG_POPUP_CONFIGURE_SINCE_VERSION 1
+ /**
+  * @ingroup iface_xdg_popup
+  */
+ #define XDG_POPUP_POPUP_DONE_SINCE_VERSION 1
+ 
+ /**
+  * @ingroup iface_xdg_popup
+  */
+ #define XDG_POPUP_DESTROY_SINCE_VERSION 1
+ /**
+  * @ingroup iface_xdg_popup
+  */
+ #define XDG_POPUP_GRAB_SINCE_VERSION 1
+ 
+ /**
+  * @ingroup iface_xdg_popup
+  * Sends an configure event to the client owning the resource.
+  * @param resource_ The client's resource
+  * @param x x position relative to parent surface window geometry
+  * @param y y position relative to parent surface window geometry
+  * @param width window geometry width
+  * @param height window geometry height
+  */
+ static inline void
+ xdg_popup_send_configure(struct wl_resource *resource_, int32_t x, int32_t y, int32_t width, int32_t height)
+ {
+ 	wl_resource_post_event(resource_, XDG_POPUP_CONFIGURE, x, y, width, height);
+ }
+ 
+ /**
+  * @ingroup iface_xdg_popup
+  * Sends an popup_done event to the client owning the resource.
+  * @param resource_ The client's resource
+  */
+ static inline void
+ xdg_popup_send_popup_done(struct wl_resource *resource_)
+ {
+ 	wl_resource_post_event(resource_, XDG_POPUP_POPUP_DONE);
+ }
+ 
+ #ifdef  __cplusplus
+ }
+ #endif
+ 
+ #endif

A xdg-shell.c => xdg-shell.c +174 -0
@@ 0,0 1,174 @@
+ /* Generated by wayland-scanner 1.17.0 */
+ 
+ /*
+  * Copyright © 2008-2013 Kristian Høgsberg
+  * Copyright © 2013      Rafael Antognolli
+  * Copyright © 2013      Jasper St. Pierre
+  * Copyright © 2010-2013 Intel Corporation
+  * Copyright © 2015-2017 Samsung Electronics Co., Ltd
+  * Copyright © 2015-2017 Red Hat Inc.
+  *
+  * Permission is hereby granted, free of charge, to any person obtaining a
+  * copy of this software and associated documentation files (the "Software"),
+  * to deal in the Software without restriction, including without limitation
+  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
+  * and/or sell copies of the Software, and to permit persons to whom the
+  * Software is furnished to do so, subject to the following conditions:
+  *
+  * The above copyright notice and this permission notice (including the next
+  * paragraph) shall be included in all copies or substantial portions of the
+  * Software.
+  *
+  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
+  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+  * DEALINGS IN THE SOFTWARE.
+  */
+ 
+ #include <stdlib.h>
+ #include <stdint.h>
+ #include "wayland-util.h"
+ 
+ #ifndef __has_attribute
+ # define __has_attribute(x) 0  /* Compatibility with non-clang compilers. */
+ #endif
+ 
+ #if (__has_attribute(visibility) || defined(__GNUC__) && __GNUC__ >= 4)
+ #define WL_PRIVATE __attribute__ ((visibility("hidden")))
+ #else
+ #define WL_PRIVATE
+ #endif
+ 
+ extern const struct wl_interface wl_output_interface;
+ extern const struct wl_interface wl_seat_interface;
+ extern const struct wl_interface wl_surface_interface;
+ extern const struct wl_interface xdg_popup_interface;
+ extern const struct wl_interface xdg_positioner_interface;
+ extern const struct wl_interface xdg_surface_interface;
+ extern const struct wl_interface xdg_toplevel_interface;
+ 
+ static const struct wl_interface *types[] = {
+ 	NULL,
+ 	NULL,
+ 	NULL,
+ 	NULL,
+ 	&xdg_positioner_interface,
+ 	&xdg_surface_interface,
+ 	&wl_surface_interface,
+ 	&xdg_toplevel_interface,
+ 	&xdg_popup_interface,
+ 	&xdg_surface_interface,
+ 	&xdg_positioner_interface,
+ 	&xdg_toplevel_interface,
+ 	&wl_seat_interface,
+ 	NULL,
+ 	NULL,
+ 	NULL,
+ 	&wl_seat_interface,
+ 	NULL,
+ 	&wl_seat_interface,
+ 	NULL,
+ 	NULL,
+ 	&wl_output_interface,
+ 	&wl_seat_interface,
+ 	NULL,
+ };
+ 
+ static const struct wl_message xdg_wm_base_requests[] = {
+ 	{ "destroy", "", types + 0 },
+ 	{ "create_positioner", "n", types + 4 },
+ 	{ "get_xdg_surface", "no", types + 5 },
+ 	{ "pong", "u", types + 0 },
+ };
+ 
+ static const struct wl_message xdg_wm_base_events[] = {
+ 	{ "ping", "u", types + 0 },
+ };
+ 
+ WL_PRIVATE const struct wl_interface xdg_wm_base_interface = {
+ 	"xdg_wm_base", 2,
+ 	4, xdg_wm_base_requests,
+ 	1, xdg_wm_base_events,
+ };
+ 
+ static const struct wl_message xdg_positioner_requests[] = {
+ 	{ "destroy", "", types + 0 },
+ 	{ "set_size", "ii", types + 0 },
+ 	{ "set_anchor_rect", "iiii", types + 0 },
+ 	{ "set_anchor", "u", types + 0 },
+ 	{ "set_gravity", "u", types + 0 },
+ 	{ "set_constraint_adjustment", "u", types + 0 },
+ 	{ "set_offset", "ii", types + 0 },
+ };
+ 
+ WL_PRIVATE const struct wl_interface xdg_positioner_interface = {
+ 	"xdg_positioner", 2,
+ 	7, xdg_positioner_requests,
+ 	0, NULL,
+ };
+ 
+ static const struct wl_message xdg_surface_requests[] = {
+ 	{ "destroy", "", types + 0 },
+ 	{ "get_toplevel", "n", types + 7 },
+ 	{ "get_popup", "n?oo", types + 8 },
+ 	{ "set_window_geometry", "iiii", types + 0 },
+ 	{ "ack_configure", "u", types + 0 },
+ };
+ 
+ static const struct wl_message xdg_surface_events[] = {
+ 	{ "configure", "u", types + 0 },
+ };
+ 
+ WL_PRIVATE const struct wl_interface xdg_surface_interface = {
+ 	"xdg_surface", 2,
+ 	5, xdg_surface_requests,
+ 	1, xdg_surface_events,
+ };
+ 
+ static const struct wl_message xdg_toplevel_requests[] = {
+ 	{ "destroy", "", types + 0 },
+ 	{ "set_parent", "?o", types + 11 },
+ 	{ "set_title", "s", types + 0 },
+ 	{ "set_app_id", "s", types + 0 },
+ 	{ "show_window_menu", "ouii", types + 12 },
+ 	{ "move", "ou", types + 16 },
+ 	{ "resize", "ouu", types + 18 },
+ 	{ "set_max_size", "ii", types + 0 },
+ 	{ "set_min_size", "ii", types + 0 },
+ 	{ "set_maximized", "", types + 0 },
+ 	{ "unset_maximized", "", types + 0 },
+ 	{ "set_fullscreen", "?o", types + 21 },
+ 	{ "unset_fullscreen", "", types + 0 },
+ 	{ "set_minimized", "", types + 0 },
+ };
+ 
+ static const struct wl_message xdg_toplevel_events[] = {
+ 	{ "configure", "iia", types + 0 },
+ 	{ "close", "", types + 0 },
+ };
+ 
+ WL_PRIVATE const struct wl_interface xdg_toplevel_interface = {
+ 	"xdg_toplevel", 2,
+ 	14, xdg_toplevel_requests,
+ 	2, xdg_toplevel_events,
+ };
+ 
+ static const struct wl_message xdg_popup_requests[] = {
+ 	{ "destroy", "", types + 0 },
+ 	{ "grab", "ou", types + 22 },
+ };
+ 
+ static const struct wl_message xdg_popup_events[] = {
+ 	{ "configure", "iiii", types + 0 },
+ 	{ "popup_done", "", types + 0 },
+ };
+ 
+ WL_PRIVATE const struct wl_interface xdg_popup_interface = {
+ 	"xdg_popup", 2,
+ 	2, xdg_popup_requests,
+ 	2, xdg_popup_events,
+ };
+