SDL 2.0
xdg-shell-unstable-v6-client-protocol.h
Go to the documentation of this file.
1/* Generated by wayland-scanner 1.20.0 */
2
3#ifndef XDG_SHELL_UNSTABLE_V6_CLIENT_PROTOCOL_H
4#define XDG_SHELL_UNSTABLE_V6_CLIENT_PROTOCOL_H
5
6#include <stdint.h>
7#include <stddef.h>
8#include "wayland-client.h"
9
10#ifdef __cplusplus
11extern "C" {
12#endif
13
14/**
15 * @page page_xdg_shell_unstable_v6 The xdg_shell_unstable_v6 protocol
16 * @section page_ifaces_xdg_shell_unstable_v6 Interfaces
17 * - @subpage page_iface_zxdg_shell_v6 - create desktop-style surfaces
18 * - @subpage page_iface_zxdg_positioner_v6 - child surface positioner
19 * - @subpage page_iface_zxdg_surface_v6 - desktop user interface surface base interface
20 * - @subpage page_iface_zxdg_toplevel_v6 - toplevel surface
21 * - @subpage page_iface_zxdg_popup_v6 - short-lived, popup surfaces for menus
22 * @section page_copyright_xdg_shell_unstable_v6 Copyright
23 * <pre>
24 *
25 * Copyright © 2008-2013 Kristian Høgsberg
26 * Copyright © 2013 Rafael Antognolli
27 * Copyright © 2013 Jasper St. Pierre
28 * Copyright © 2010-2013 Intel Corporation
29 *
30 * Permission is hereby granted, free of charge, to any person obtaining a
31 * copy of this software and associated documentation files (the "Software"),
32 * to deal in the Software without restriction, including without limitation
33 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
34 * and/or sell copies of the Software, and to permit persons to whom the
35 * Software is furnished to do so, subject to the following conditions:
36 *
37 * The above copyright notice and this permission notice (including the next
38 * paragraph) shall be included in all copies or substantial portions of the
39 * Software.
40 *
41 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
42 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
43 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
44 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
45 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
46 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
47 * DEALINGS IN THE SOFTWARE.
48 * </pre>
49 */
50struct wl_output;
51struct wl_seat;
52struct wl_surface;
53struct zxdg_popup_v6;
54struct zxdg_positioner_v6;
55struct zxdg_shell_v6;
56struct zxdg_surface_v6;
57struct zxdg_toplevel_v6;
58
59#ifndef ZXDG_SHELL_V6_INTERFACE
60#define ZXDG_SHELL_V6_INTERFACE
61/**
62 * @page page_iface_zxdg_shell_v6 zxdg_shell_v6
63 * @section page_iface_zxdg_shell_v6_desc Description
64 *
65 * xdg_shell allows clients to turn a wl_surface into a "real window"
66 * which can be dragged, resized, stacked, and moved around by the
67 * user. Everything about this interface is suited towards traditional
68 * desktop environments.
69 * @section page_iface_zxdg_shell_v6_api API
70 * See @ref iface_zxdg_shell_v6.
71 */
72/**
73 * @defgroup iface_zxdg_shell_v6 The zxdg_shell_v6 interface
74 *
75 * xdg_shell allows clients to turn a wl_surface into a "real window"
76 * which can be dragged, resized, stacked, and moved around by the
77 * user. Everything about this interface is suited towards traditional
78 * desktop environments.
79 */
80extern const struct wl_interface zxdg_shell_v6_interface;
81#endif
82#ifndef ZXDG_POSITIONER_V6_INTERFACE
83#define ZXDG_POSITIONER_V6_INTERFACE
84/**
85 * @page page_iface_zxdg_positioner_v6 zxdg_positioner_v6
86 * @section page_iface_zxdg_positioner_v6_desc Description
87 *
88 * The xdg_positioner provides a collection of rules for the placement of a
89 * child surface relative to a parent surface. Rules can be defined to ensure
90 * the child surface remains within the visible area's borders, and to
91 * specify how the child surface changes its position, such as sliding along
92 * an axis, or flipping around a rectangle. These positioner-created rules are
93 * constrained by the requirement that a child surface must intersect with or
94 * be at least partially adjacent to its parent surface.
95 *
96 * See the various requests for details about possible rules.
97 *
98 * At the time of the request, the compositor makes a copy of the rules
99 * specified by the xdg_positioner. Thus, after the request is complete the
100 * xdg_positioner object can be destroyed or reused; further changes to the
101 * object will have no effect on previous usages.
102 *
103 * For an xdg_positioner object to be considered complete, it must have a
104 * non-zero size set by set_size, and a non-zero anchor rectangle set by
105 * set_anchor_rect. Passing an incomplete xdg_positioner object when
106 * positioning a surface raises an error.
107 * @section page_iface_zxdg_positioner_v6_api API
108 * See @ref iface_zxdg_positioner_v6.
109 */
110/**
111 * @defgroup iface_zxdg_positioner_v6 The zxdg_positioner_v6 interface
112 *
113 * The xdg_positioner provides a collection of rules for the placement of a
114 * child surface relative to a parent surface. Rules can be defined to ensure
115 * the child surface remains within the visible area's borders, and to
116 * specify how the child surface changes its position, such as sliding along
117 * an axis, or flipping around a rectangle. These positioner-created rules are
118 * constrained by the requirement that a child surface must intersect with or
119 * be at least partially adjacent to its parent surface.
120 *
121 * See the various requests for details about possible rules.
122 *
123 * At the time of the request, the compositor makes a copy of the rules
124 * specified by the xdg_positioner. Thus, after the request is complete the
125 * xdg_positioner object can be destroyed or reused; further changes to the
126 * object will have no effect on previous usages.
127 *
128 * For an xdg_positioner object to be considered complete, it must have a
129 * non-zero size set by set_size, and a non-zero anchor rectangle set by
130 * set_anchor_rect. Passing an incomplete xdg_positioner object when
131 * positioning a surface raises an error.
132 */
133extern const struct wl_interface zxdg_positioner_v6_interface;
134#endif
135#ifndef ZXDG_SURFACE_V6_INTERFACE
136#define ZXDG_SURFACE_V6_INTERFACE
137/**
138 * @page page_iface_zxdg_surface_v6 zxdg_surface_v6
139 * @section page_iface_zxdg_surface_v6_desc Description
140 *
141 * An interface that may be implemented by a wl_surface, for
142 * implementations that provide a desktop-style user interface.
143 *
144 * It provides a base set of functionality required to construct user
145 * interface elements requiring management by the compositor, such as
146 * toplevel windows, menus, etc. The types of functionality are split into
147 * xdg_surface roles.
148 *
149 * Creating an xdg_surface does not set the role for a wl_surface. In order
150 * to map an xdg_surface, the client must create a role-specific object
151 * using, e.g., get_toplevel, get_popup. The wl_surface for any given
152 * xdg_surface can have at most one role, and may not be assigned any role
153 * not based on xdg_surface.
154 *
155 * A role must be assigned before any other requests are made to the
156 * xdg_surface object.
157 *
158 * The client must call wl_surface.commit on the corresponding wl_surface
159 * for the xdg_surface state to take effect.
160 *
161 * Creating an xdg_surface from a wl_surface which has a buffer attached or
162 * committed is a client error, and any attempts by a client to attach or
163 * manipulate a buffer prior to the first xdg_surface.configure call must
164 * also be treated as errors.
165 *
166 * For a surface to be mapped by the compositor, the following conditions
167 * must be met: (1) the client has assigned a xdg_surface based role to the
168 * surface, (2) the client has set and committed the xdg_surface state and
169 * the role dependent state to the surface and (3) the client has committed a
170 * buffer to the surface.
171 * @section page_iface_zxdg_surface_v6_api API
172 * See @ref iface_zxdg_surface_v6.
173 */
174/**
175 * @defgroup iface_zxdg_surface_v6 The zxdg_surface_v6 interface
176 *
177 * An interface that may be implemented by a wl_surface, for
178 * implementations that provide a desktop-style user interface.
179 *
180 * It provides a base set of functionality required to construct user
181 * interface elements requiring management by the compositor, such as
182 * toplevel windows, menus, etc. The types of functionality are split into
183 * xdg_surface roles.
184 *
185 * Creating an xdg_surface does not set the role for a wl_surface. In order
186 * to map an xdg_surface, the client must create a role-specific object
187 * using, e.g., get_toplevel, get_popup. The wl_surface for any given
188 * xdg_surface can have at most one role, and may not be assigned any role
189 * not based on xdg_surface.
190 *
191 * A role must be assigned before any other requests are made to the
192 * xdg_surface object.
193 *
194 * The client must call wl_surface.commit on the corresponding wl_surface
195 * for the xdg_surface state to take effect.
196 *
197 * Creating an xdg_surface from a wl_surface which has a buffer attached or
198 * committed is a client error, and any attempts by a client to attach or
199 * manipulate a buffer prior to the first xdg_surface.configure call must
200 * also be treated as errors.
201 *
202 * For a surface to be mapped by the compositor, the following conditions
203 * must be met: (1) the client has assigned a xdg_surface based role to the
204 * surface, (2) the client has set and committed the xdg_surface state and
205 * the role dependent state to the surface and (3) the client has committed a
206 * buffer to the surface.
207 */
208extern const struct wl_interface zxdg_surface_v6_interface;
209#endif
210#ifndef ZXDG_TOPLEVEL_V6_INTERFACE
211#define ZXDG_TOPLEVEL_V6_INTERFACE
212/**
213 * @page page_iface_zxdg_toplevel_v6 zxdg_toplevel_v6
214 * @section page_iface_zxdg_toplevel_v6_desc Description
215 *
216 * This interface defines an xdg_surface role which allows a surface to,
217 * among other things, set window-like properties such as maximize,
218 * fullscreen, and minimize, set application-specific metadata like title and
219 * id, and well as trigger user interactive operations such as interactive
220 * resize and move.
221 * @section page_iface_zxdg_toplevel_v6_api API
222 * See @ref iface_zxdg_toplevel_v6.
223 */
224/**
225 * @defgroup iface_zxdg_toplevel_v6 The zxdg_toplevel_v6 interface
226 *
227 * This interface defines an xdg_surface role which allows a surface to,
228 * among other things, set window-like properties such as maximize,
229 * fullscreen, and minimize, set application-specific metadata like title and
230 * id, and well as trigger user interactive operations such as interactive
231 * resize and move.
232 */
233extern const struct wl_interface zxdg_toplevel_v6_interface;
234#endif
235#ifndef ZXDG_POPUP_V6_INTERFACE
236#define ZXDG_POPUP_V6_INTERFACE
237/**
238 * @page page_iface_zxdg_popup_v6 zxdg_popup_v6
239 * @section page_iface_zxdg_popup_v6_desc Description
240 *
241 * A popup surface is a short-lived, temporary surface. It can be used to
242 * implement for example menus, popovers, tooltips and other similar user
243 * interface concepts.
244 *
245 * A popup can be made to take an explicit grab. See xdg_popup.grab for
246 * details.
247 *
248 * When the popup is dismissed, a popup_done event will be sent out, and at
249 * the same time the surface will be unmapped. See the xdg_popup.popup_done
250 * event for details.
251 *
252 * Explicitly destroying the xdg_popup object will also dismiss the popup and
253 * unmap the surface. Clients that want to dismiss the popup when another
254 * surface of their own is clicked should dismiss the popup using the destroy
255 * request.
256 *
257 * The parent surface must have either the xdg_toplevel or xdg_popup surface
258 * role.
259 *
260 * A newly created xdg_popup will be stacked on top of all previously created
261 * xdg_popup surfaces associated with the same xdg_toplevel.
262 *
263 * The parent of an xdg_popup must be mapped (see the xdg_surface
264 * description) before the xdg_popup itself.
265 *
266 * The x and y arguments passed when creating the popup object specify
267 * where the top left of the popup should be placed, relative to the
268 * local surface coordinates of the parent surface. See
269 * xdg_surface.get_popup. An xdg_popup must intersect with or be at least
270 * partially adjacent to its parent surface.
271 *
272 * The client must call wl_surface.commit on the corresponding wl_surface
273 * for the xdg_popup state to take effect.
274 * @section page_iface_zxdg_popup_v6_api API
275 * See @ref iface_zxdg_popup_v6.
276 */
277/**
278 * @defgroup iface_zxdg_popup_v6 The zxdg_popup_v6 interface
279 *
280 * A popup surface is a short-lived, temporary surface. It can be used to
281 * implement for example menus, popovers, tooltips and other similar user
282 * interface concepts.
283 *
284 * A popup can be made to take an explicit grab. See xdg_popup.grab for
285 * details.
286 *
287 * When the popup is dismissed, a popup_done event will be sent out, and at
288 * the same time the surface will be unmapped. See the xdg_popup.popup_done
289 * event for details.
290 *
291 * Explicitly destroying the xdg_popup object will also dismiss the popup and
292 * unmap the surface. Clients that want to dismiss the popup when another
293 * surface of their own is clicked should dismiss the popup using the destroy
294 * request.
295 *
296 * The parent surface must have either the xdg_toplevel or xdg_popup surface
297 * role.
298 *
299 * A newly created xdg_popup will be stacked on top of all previously created
300 * xdg_popup surfaces associated with the same xdg_toplevel.
301 *
302 * The parent of an xdg_popup must be mapped (see the xdg_surface
303 * description) before the xdg_popup itself.
304 *
305 * The x and y arguments passed when creating the popup object specify
306 * where the top left of the popup should be placed, relative to the
307 * local surface coordinates of the parent surface. See
308 * xdg_surface.get_popup. An xdg_popup must intersect with or be at least
309 * partially adjacent to its parent surface.
310 *
311 * The client must call wl_surface.commit on the corresponding wl_surface
312 * for the xdg_popup state to take effect.
313 */
314extern const struct wl_interface zxdg_popup_v6_interface;
315#endif
316
317#ifndef ZXDG_SHELL_V6_ERROR_ENUM
318#define ZXDG_SHELL_V6_ERROR_ENUM
320 /**
321 * given wl_surface has another role
322 */
324 /**
325 * xdg_shell was destroyed before children
326 */
328 /**
329 * the client tried to map or destroy a non-topmost popup
330 */
332 /**
333 * the client specified an invalid popup parent surface
334 */
336 /**
337 * the client provided an invalid surface state
338 */
340 /**
341 * the client provided an invalid positioner
342 */
344};
345#endif /* ZXDG_SHELL_V6_ERROR_ENUM */
346
347/**
348 * @ingroup iface_zxdg_shell_v6
349 * @struct zxdg_shell_v6_listener
350 */
352 /**
353 * check if the client is alive
354 *
355 * The ping event asks the client if it's still alive. Pass the
356 * serial specified in the event back to the compositor by sending
357 * a "pong" request back with the specified serial. See
358 * xdg_shell.ping.
359 *
360 * Compositors can use this to determine if the client is still
361 * alive. It's unspecified what will happen if the client doesn't
362 * respond to the ping request, or in what timeframe. Clients
363 * should try to respond in a reasonable amount of time.
364 *
365 * A compositor is free to ping in any way it wants, but a client
366 * must always respond to any xdg_shell object it created.
367 * @param serial pass this to the pong request
368 */
369 void (*ping)(void *data,
370 struct zxdg_shell_v6 *zxdg_shell_v6,
371 uint32_t serial);
372};
373
374/**
375 * @ingroup iface_zxdg_shell_v6
376 */
377static inline int
378zxdg_shell_v6_add_listener(struct zxdg_shell_v6 *zxdg_shell_v6,
379 const struct zxdg_shell_v6_listener *listener, void *data)
380{
381 return wl_proxy_add_listener((struct wl_proxy *) zxdg_shell_v6,
382 (void (**)(void)) listener, data);
383}
384
385#define ZXDG_SHELL_V6_DESTROY 0
386#define ZXDG_SHELL_V6_CREATE_POSITIONER 1
387#define ZXDG_SHELL_V6_GET_XDG_SURFACE 2
388#define ZXDG_SHELL_V6_PONG 3
389
390/**
391 * @ingroup iface_zxdg_shell_v6
392 */
393#define ZXDG_SHELL_V6_PING_SINCE_VERSION 1
394
395/**
396 * @ingroup iface_zxdg_shell_v6
397 */
398#define ZXDG_SHELL_V6_DESTROY_SINCE_VERSION 1
399/**
400 * @ingroup iface_zxdg_shell_v6
401 */
402#define ZXDG_SHELL_V6_CREATE_POSITIONER_SINCE_VERSION 1
403/**
404 * @ingroup iface_zxdg_shell_v6
405 */
406#define ZXDG_SHELL_V6_GET_XDG_SURFACE_SINCE_VERSION 1
407/**
408 * @ingroup iface_zxdg_shell_v6
409 */
410#define ZXDG_SHELL_V6_PONG_SINCE_VERSION 1
411
412/** @ingroup iface_zxdg_shell_v6 */
413static inline void
414zxdg_shell_v6_set_user_data(struct zxdg_shell_v6 *zxdg_shell_v6, void *user_data)
415{
416 wl_proxy_set_user_data((struct wl_proxy *) zxdg_shell_v6, user_data);
417}
418
419/** @ingroup iface_zxdg_shell_v6 */
420static inline void *
421zxdg_shell_v6_get_user_data(struct zxdg_shell_v6 *zxdg_shell_v6)
422{
423 return wl_proxy_get_user_data((struct wl_proxy *) zxdg_shell_v6);
424}
425
426static inline uint32_t
427zxdg_shell_v6_get_version(struct zxdg_shell_v6 *zxdg_shell_v6)
428{
429 return wl_proxy_get_version((struct wl_proxy *) zxdg_shell_v6);
430}
431
432/**
433 * @ingroup iface_zxdg_shell_v6
434 *
435 * Destroy this xdg_shell object.
436 *
437 * Destroying a bound xdg_shell object while there are surfaces
438 * still alive created by this xdg_shell object instance is illegal
439 * and will result in a protocol error.
440 */
441static inline void
442zxdg_shell_v6_destroy(struct zxdg_shell_v6 *zxdg_shell_v6)
443{
444 wl_proxy_marshal_flags((struct wl_proxy *) zxdg_shell_v6,
445 ZXDG_SHELL_V6_DESTROY, NULL, wl_proxy_get_version((struct wl_proxy *) zxdg_shell_v6), WL_MARSHAL_FLAG_DESTROY);
446}
447
448/**
449 * @ingroup iface_zxdg_shell_v6
450 *
451 * Create a positioner object. A positioner object is used to position
452 * surfaces relative to some parent surface. See the interface description
453 * and xdg_surface.get_popup for details.
454 */
455static inline struct zxdg_positioner_v6 *
456zxdg_shell_v6_create_positioner(struct zxdg_shell_v6 *zxdg_shell_v6)
457{
458 struct wl_proxy *id;
459
460 id = wl_proxy_marshal_flags((struct wl_proxy *) zxdg_shell_v6,
461 ZXDG_SHELL_V6_CREATE_POSITIONER, &zxdg_positioner_v6_interface, wl_proxy_get_version((struct wl_proxy *) zxdg_shell_v6), 0, NULL);
462
463 return (struct zxdg_positioner_v6 *) id;
464}
465
466/**
467 * @ingroup iface_zxdg_shell_v6
468 *
469 * This creates an xdg_surface for the given surface. While xdg_surface
470 * itself is not a role, the corresponding surface may only be assigned
471 * a role extending xdg_surface, such as xdg_toplevel or xdg_popup.
472 *
473 * This creates an xdg_surface for the given surface. An xdg_surface is
474 * used as basis to define a role to a given surface, such as xdg_toplevel
475 * or xdg_popup. It also manages functionality shared between xdg_surface
476 * based surface roles.
477 *
478 * See the documentation of xdg_surface for more details about what an
479 * xdg_surface is and how it is used.
480 */
481static inline struct zxdg_surface_v6 *
482zxdg_shell_v6_get_xdg_surface(struct zxdg_shell_v6 *zxdg_shell_v6, struct wl_surface *surface)
483{
484 struct wl_proxy *id;
485
486 id = wl_proxy_marshal_flags((struct wl_proxy *) zxdg_shell_v6,
487 ZXDG_SHELL_V6_GET_XDG_SURFACE, &zxdg_surface_v6_interface, wl_proxy_get_version((struct wl_proxy *) zxdg_shell_v6), 0, NULL, surface);
488
489 return (struct zxdg_surface_v6 *) id;
490}
491
492/**
493 * @ingroup iface_zxdg_shell_v6
494 *
495 * A client must respond to a ping event with a pong request or
496 * the client may be deemed unresponsive. See xdg_shell.ping.
497 */
498static inline void
499zxdg_shell_v6_pong(struct zxdg_shell_v6 *zxdg_shell_v6, uint32_t serial)
500{
501 wl_proxy_marshal_flags((struct wl_proxy *) zxdg_shell_v6,
502 ZXDG_SHELL_V6_PONG, NULL, wl_proxy_get_version((struct wl_proxy *) zxdg_shell_v6), 0, serial);
503}
504
505#ifndef ZXDG_POSITIONER_V6_ERROR_ENUM
506#define ZXDG_POSITIONER_V6_ERROR_ENUM
508 /**
509 * invalid input provided
510 */
512};
513#endif /* ZXDG_POSITIONER_V6_ERROR_ENUM */
514
515#ifndef ZXDG_POSITIONER_V6_ANCHOR_ENUM
516#define ZXDG_POSITIONER_V6_ANCHOR_ENUM
518 /**
519 * the center of the anchor rectangle
520 */
522 /**
523 * the top edge of the anchor rectangle
524 */
526 /**
527 * the bottom edge of the anchor rectangle
528 */
530 /**
531 * the left edge of the anchor rectangle
532 */
534 /**
535 * the right edge of the anchor rectangle
536 */
538};
539#endif /* ZXDG_POSITIONER_V6_ANCHOR_ENUM */
540
541#ifndef ZXDG_POSITIONER_V6_GRAVITY_ENUM
542#define ZXDG_POSITIONER_V6_GRAVITY_ENUM
544 /**
545 * center over the anchor edge
546 */
548 /**
549 * position above the anchor edge
550 */
552 /**
553 * position below the anchor edge
554 */
556 /**
557 * position to the left of the anchor edge
558 */
560 /**
561 * position to the right of the anchor edge
562 */
564};
565#endif /* ZXDG_POSITIONER_V6_GRAVITY_ENUM */
566
567#ifndef ZXDG_POSITIONER_V6_CONSTRAINT_ADJUSTMENT_ENUM
568#define ZXDG_POSITIONER_V6_CONSTRAINT_ADJUSTMENT_ENUM
569/**
570 * @ingroup iface_zxdg_positioner_v6
571 * constraint adjustments
572 *
573 * The constraint adjustment value define ways the compositor will adjust
574 * the position of the surface, if the unadjusted position would result
575 * in the surface being partly constrained.
576 *
577 * Whether a surface is considered 'constrained' is left to the compositor
578 * to determine. For example, the surface may be partly outside the
579 * compositor's defined 'work area', thus necessitating the child surface's
580 * position be adjusted until it is entirely inside the work area.
581 *
582 * The adjustments can be combined, according to a defined precedence: 1)
583 * Flip, 2) Slide, 3) Resize.
584 */
586 /**
587 * don't move the child surface when constrained
588 *
589 * Don't alter the surface position even if it is constrained on
590 * some axis, for example partially outside the edge of a monitor.
591 */
593 /**
594 * move along the x axis until unconstrained
595 *
596 * Slide the surface along the x axis until it is no longer
597 * constrained.
598 *
599 * First try to slide towards the direction of the gravity on the x
600 * axis until either the edge in the opposite direction of the
601 * gravity is unconstrained or the edge in the direction of the
602 * gravity is constrained.
603 *
604 * Then try to slide towards the opposite direction of the gravity
605 * on the x axis until either the edge in the direction of the
606 * gravity is unconstrained or the edge in the opposite direction
607 * of the gravity is constrained.
608 */
610 /**
611 * move along the y axis until unconstrained
612 *
613 * Slide the surface along the y axis until it is no longer
614 * constrained.
615 *
616 * First try to slide towards the direction of the gravity on the y
617 * axis until either the edge in the opposite direction of the
618 * gravity is unconstrained or the edge in the direction of the
619 * gravity is constrained.
620 *
621 * Then try to slide towards the opposite direction of the gravity
622 * on the y axis until either the edge in the direction of the
623 * gravity is unconstrained or the edge in the opposite direction
624 * of the gravity is constrained.
625 */
627 /**
628 * invert the anchor and gravity on the x axis
629 *
630 * Invert the anchor and gravity on the x axis if the surface is
631 * constrained on the x axis. For example, if the left edge of the
632 * surface is constrained, the gravity is 'left' and the anchor is
633 * 'left', change the gravity to 'right' and the anchor to 'right'.
634 *
635 * If the adjusted position also ends up being constrained, the
636 * resulting position of the flip_x adjustment will be the one
637 * before the adjustment.
638 */
640 /**
641 * invert the anchor and gravity on the y axis
642 *
643 * Invert the anchor and gravity on the y axis if the surface is
644 * constrained on the y axis. For example, if the bottom edge of
645 * the surface is constrained, the gravity is 'bottom' and the
646 * anchor is 'bottom', change the gravity to 'top' and the anchor
647 * to 'top'.
648 *
649 * If the adjusted position also ends up being constrained, the
650 * resulting position of the flip_y adjustment will be the one
651 * before the adjustment.
652 */
654 /**
655 * horizontally resize the surface
656 *
657 * Resize the surface horizontally so that it is completely
658 * unconstrained.
659 */
661 /**
662 * vertically resize the surface
663 *
664 * Resize the surface vertically so that it is completely
665 * unconstrained.
666 */
668};
669#endif /* ZXDG_POSITIONER_V6_CONSTRAINT_ADJUSTMENT_ENUM */
670
671#define ZXDG_POSITIONER_V6_DESTROY 0
672#define ZXDG_POSITIONER_V6_SET_SIZE 1
673#define ZXDG_POSITIONER_V6_SET_ANCHOR_RECT 2
674#define ZXDG_POSITIONER_V6_SET_ANCHOR 3
675#define ZXDG_POSITIONER_V6_SET_GRAVITY 4
676#define ZXDG_POSITIONER_V6_SET_CONSTRAINT_ADJUSTMENT 5
677#define ZXDG_POSITIONER_V6_SET_OFFSET 6
678
679
680/**
681 * @ingroup iface_zxdg_positioner_v6
682 */
683#define ZXDG_POSITIONER_V6_DESTROY_SINCE_VERSION 1
684/**
685 * @ingroup iface_zxdg_positioner_v6
686 */
687#define ZXDG_POSITIONER_V6_SET_SIZE_SINCE_VERSION 1
688/**
689 * @ingroup iface_zxdg_positioner_v6
690 */
691#define ZXDG_POSITIONER_V6_SET_ANCHOR_RECT_SINCE_VERSION 1
692/**
693 * @ingroup iface_zxdg_positioner_v6
694 */
695#define ZXDG_POSITIONER_V6_SET_ANCHOR_SINCE_VERSION 1
696/**
697 * @ingroup iface_zxdg_positioner_v6
698 */
699#define ZXDG_POSITIONER_V6_SET_GRAVITY_SINCE_VERSION 1
700/**
701 * @ingroup iface_zxdg_positioner_v6
702 */
703#define ZXDG_POSITIONER_V6_SET_CONSTRAINT_ADJUSTMENT_SINCE_VERSION 1
704/**
705 * @ingroup iface_zxdg_positioner_v6
706 */
707#define ZXDG_POSITIONER_V6_SET_OFFSET_SINCE_VERSION 1
708
709/** @ingroup iface_zxdg_positioner_v6 */
710static inline void
711zxdg_positioner_v6_set_user_data(struct zxdg_positioner_v6 *zxdg_positioner_v6, void *user_data)
712{
713 wl_proxy_set_user_data((struct wl_proxy *) zxdg_positioner_v6, user_data);
714}
715
716/** @ingroup iface_zxdg_positioner_v6 */
717static inline void *
718zxdg_positioner_v6_get_user_data(struct zxdg_positioner_v6 *zxdg_positioner_v6)
719{
720 return wl_proxy_get_user_data((struct wl_proxy *) zxdg_positioner_v6);
721}
722
723static inline uint32_t
724zxdg_positioner_v6_get_version(struct zxdg_positioner_v6 *zxdg_positioner_v6)
725{
726 return wl_proxy_get_version((struct wl_proxy *) zxdg_positioner_v6);
727}
728
729/**
730 * @ingroup iface_zxdg_positioner_v6
731 *
732 * Notify the compositor that the xdg_positioner will no longer be used.
733 */
734static inline void
735zxdg_positioner_v6_destroy(struct zxdg_positioner_v6 *zxdg_positioner_v6)
736{
737 wl_proxy_marshal_flags((struct wl_proxy *) zxdg_positioner_v6,
738 ZXDG_POSITIONER_V6_DESTROY, NULL, wl_proxy_get_version((struct wl_proxy *) zxdg_positioner_v6), WL_MARSHAL_FLAG_DESTROY);
739}
740
741/**
742 * @ingroup iface_zxdg_positioner_v6
743 *
744 * Set the size of the surface that is to be positioned with the positioner
745 * object. The size is in surface-local coordinates and corresponds to the
746 * window geometry. See xdg_surface.set_window_geometry.
747 *
748 * If a zero or negative size is set the invalid_input error is raised.
749 */
750static inline void
751zxdg_positioner_v6_set_size(struct zxdg_positioner_v6 *zxdg_positioner_v6, int32_t width, int32_t height)
752{
753 wl_proxy_marshal_flags((struct wl_proxy *) zxdg_positioner_v6,
754 ZXDG_POSITIONER_V6_SET_SIZE, NULL, wl_proxy_get_version((struct wl_proxy *) zxdg_positioner_v6), 0, width, height);
755}
756
757/**
758 * @ingroup iface_zxdg_positioner_v6
759 *
760 * Specify the anchor rectangle within the parent surface that the child
761 * surface will be placed relative to. The rectangle is relative to the
762 * window geometry as defined by xdg_surface.set_window_geometry of the
763 * parent surface. The rectangle must be at least 1x1 large.
764 *
765 * When the xdg_positioner object is used to position a child surface, the
766 * anchor rectangle may not extend outside the window geometry of the
767 * positioned child's parent surface.
768 *
769 * If a zero or negative size is set the invalid_input error is raised.
770 */
771static inline void
772zxdg_positioner_v6_set_anchor_rect(struct zxdg_positioner_v6 *zxdg_positioner_v6, int32_t x, int32_t y, int32_t width, int32_t height)
773{
774 wl_proxy_marshal_flags((struct wl_proxy *) zxdg_positioner_v6,
775 ZXDG_POSITIONER_V6_SET_ANCHOR_RECT, NULL, wl_proxy_get_version((struct wl_proxy *) zxdg_positioner_v6), 0, x, y, width, height);
776}
777
778/**
779 * @ingroup iface_zxdg_positioner_v6
780 *
781 * Defines a set of edges for the anchor rectangle. These are used to
782 * derive an anchor point that the child surface will be positioned
783 * relative to. If two orthogonal edges are specified (e.g. 'top' and
784 * 'left'), then the anchor point will be the intersection of the edges
785 * (e.g. the top left position of the rectangle); otherwise, the derived
786 * anchor point will be centered on the specified edge, or in the center of
787 * the anchor rectangle if no edge is specified.
788 *
789 * If two parallel anchor edges are specified (e.g. 'left' and 'right'),
790 * the invalid_input error is raised.
791 */
792static inline void
793zxdg_positioner_v6_set_anchor(struct zxdg_positioner_v6 *zxdg_positioner_v6, uint32_t anchor)
794{
795 wl_proxy_marshal_flags((struct wl_proxy *) zxdg_positioner_v6,
796 ZXDG_POSITIONER_V6_SET_ANCHOR, NULL, wl_proxy_get_version((struct wl_proxy *) zxdg_positioner_v6), 0, anchor);
797}
798
799/**
800 * @ingroup iface_zxdg_positioner_v6
801 *
802 * Defines in what direction a surface should be positioned, relative to
803 * the anchor point of the parent surface. If two orthogonal gravities are
804 * specified (e.g. 'bottom' and 'right'), then the child surface will be
805 * placed in the specified direction; otherwise, the child surface will be
806 * centered over the anchor point on any axis that had no gravity
807 * specified.
808 *
809 * If two parallel gravities are specified (e.g. 'left' and 'right'), the
810 * invalid_input error is raised.
811 */
812static inline void
813zxdg_positioner_v6_set_gravity(struct zxdg_positioner_v6 *zxdg_positioner_v6, uint32_t gravity)
814{
815 wl_proxy_marshal_flags((struct wl_proxy *) zxdg_positioner_v6,
816 ZXDG_POSITIONER_V6_SET_GRAVITY, NULL, wl_proxy_get_version((struct wl_proxy *) zxdg_positioner_v6), 0, gravity);
817}
818
819/**
820 * @ingroup iface_zxdg_positioner_v6
821 *
822 * Specify how the window should be positioned if the originally intended
823 * position caused the surface to be constrained, meaning at least
824 * partially outside positioning boundaries set by the compositor. The
825 * adjustment is set by constructing a bitmask describing the adjustment to
826 * be made when the surface is constrained on that axis.
827 *
828 * If no bit for one axis is set, the compositor will assume that the child
829 * surface should not change its position on that axis when constrained.
830 *
831 * If more than one bit for one axis is set, the order of how adjustments
832 * are applied is specified in the corresponding adjustment descriptions.
833 *
834 * The default adjustment is none.
835 */
836static inline void
837zxdg_positioner_v6_set_constraint_adjustment(struct zxdg_positioner_v6 *zxdg_positioner_v6, uint32_t constraint_adjustment)
838{
839 wl_proxy_marshal_flags((struct wl_proxy *) zxdg_positioner_v6,
840 ZXDG_POSITIONER_V6_SET_CONSTRAINT_ADJUSTMENT, NULL, wl_proxy_get_version((struct wl_proxy *) zxdg_positioner_v6), 0, constraint_adjustment);
841}
842
843/**
844 * @ingroup iface_zxdg_positioner_v6
845 *
846 * Specify the surface position offset relative to the position of the
847 * anchor on the anchor rectangle and the anchor on the surface. For
848 * example if the anchor of the anchor rectangle is at (x, y), the surface
849 * has the gravity bottom|right, and the offset is (ox, oy), the calculated
850 * surface position will be (x + ox, y + oy). The offset position of the
851 * surface is the one used for constraint testing. See
852 * set_constraint_adjustment.
853 *
854 * An example use case is placing a popup menu on top of a user interface
855 * element, while aligning the user interface element of the parent surface
856 * with some user interface element placed somewhere in the popup surface.
857 */
858static inline void
859zxdg_positioner_v6_set_offset(struct zxdg_positioner_v6 *zxdg_positioner_v6, int32_t x, int32_t y)
860{
861 wl_proxy_marshal_flags((struct wl_proxy *) zxdg_positioner_v6,
862 ZXDG_POSITIONER_V6_SET_OFFSET, NULL, wl_proxy_get_version((struct wl_proxy *) zxdg_positioner_v6), 0, x, y);
863}
864
865#ifndef ZXDG_SURFACE_V6_ERROR_ENUM
866#define ZXDG_SURFACE_V6_ERROR_ENUM
871};
872#endif /* ZXDG_SURFACE_V6_ERROR_ENUM */
873
874/**
875 * @ingroup iface_zxdg_surface_v6
876 * @struct zxdg_surface_v6_listener
877 */
879 /**
880 * suggest a surface change
881 *
882 * The configure event marks the end of a configure sequence. A
883 * configure sequence is a set of one or more events configuring
884 * the state of the xdg_surface, including the final
885 * xdg_surface.configure event.
886 *
887 * Where applicable, xdg_surface surface roles will during a
888 * configure sequence extend this event as a latched state sent as
889 * events before the xdg_surface.configure event. Such events
890 * should be considered to make up a set of atomically applied
891 * configuration states, where the xdg_surface.configure commits
892 * the accumulated state.
893 *
894 * Clients should arrange their surface for the new states, and
895 * then send an ack_configure request with the serial sent in this
896 * configure event at some point before committing the new surface.
897 *
898 * If the client receives multiple configure events before it can
899 * respond to one, it is free to discard all but the last event it
900 * received.
901 * @param serial serial of the configure event
902 */
904 struct zxdg_surface_v6 *zxdg_surface_v6,
905 uint32_t serial);
906};
907
908/**
909 * @ingroup iface_zxdg_surface_v6
910 */
911static inline int
912zxdg_surface_v6_add_listener(struct zxdg_surface_v6 *zxdg_surface_v6,
913 const struct zxdg_surface_v6_listener *listener, void *data)
914{
915 return wl_proxy_add_listener((struct wl_proxy *) zxdg_surface_v6,
916 (void (**)(void)) listener, data);
917}
918
919#define ZXDG_SURFACE_V6_DESTROY 0
920#define ZXDG_SURFACE_V6_GET_TOPLEVEL 1
921#define ZXDG_SURFACE_V6_GET_POPUP 2
922#define ZXDG_SURFACE_V6_SET_WINDOW_GEOMETRY 3
923#define ZXDG_SURFACE_V6_ACK_CONFIGURE 4
924
925/**
926 * @ingroup iface_zxdg_surface_v6
927 */
928#define ZXDG_SURFACE_V6_CONFIGURE_SINCE_VERSION 1
929
930/**
931 * @ingroup iface_zxdg_surface_v6
932 */
933#define ZXDG_SURFACE_V6_DESTROY_SINCE_VERSION 1
934/**
935 * @ingroup iface_zxdg_surface_v6
936 */
937#define ZXDG_SURFACE_V6_GET_TOPLEVEL_SINCE_VERSION 1
938/**
939 * @ingroup iface_zxdg_surface_v6
940 */
941#define ZXDG_SURFACE_V6_GET_POPUP_SINCE_VERSION 1
942/**
943 * @ingroup iface_zxdg_surface_v6
944 */
945#define ZXDG_SURFACE_V6_SET_WINDOW_GEOMETRY_SINCE_VERSION 1
946/**
947 * @ingroup iface_zxdg_surface_v6
948 */
949#define ZXDG_SURFACE_V6_ACK_CONFIGURE_SINCE_VERSION 1
950
951/** @ingroup iface_zxdg_surface_v6 */
952static inline void
953zxdg_surface_v6_set_user_data(struct zxdg_surface_v6 *zxdg_surface_v6, void *user_data)
954{
955 wl_proxy_set_user_data((struct wl_proxy *) zxdg_surface_v6, user_data);
956}
957
958/** @ingroup iface_zxdg_surface_v6 */
959static inline void *
960zxdg_surface_v6_get_user_data(struct zxdg_surface_v6 *zxdg_surface_v6)
961{
962 return wl_proxy_get_user_data((struct wl_proxy *) zxdg_surface_v6);
963}
964
965static inline uint32_t
966zxdg_surface_v6_get_version(struct zxdg_surface_v6 *zxdg_surface_v6)
967{
968 return wl_proxy_get_version((struct wl_proxy *) zxdg_surface_v6);
969}
970
971/**
972 * @ingroup iface_zxdg_surface_v6
973 *
974 * Destroy the xdg_surface object. An xdg_surface must only be destroyed
975 * after its role object has been destroyed.
976 */
977static inline void
978zxdg_surface_v6_destroy(struct zxdg_surface_v6 *zxdg_surface_v6)
979{
980 wl_proxy_marshal_flags((struct wl_proxy *) zxdg_surface_v6,
981 ZXDG_SURFACE_V6_DESTROY, NULL, wl_proxy_get_version((struct wl_proxy *) zxdg_surface_v6), WL_MARSHAL_FLAG_DESTROY);
982}
983
984/**
985 * @ingroup iface_zxdg_surface_v6
986 *
987 * This creates an xdg_toplevel object for the given xdg_surface and gives
988 * the associated wl_surface the xdg_toplevel role.
989 *
990 * See the documentation of xdg_toplevel for more details about what an
991 * xdg_toplevel is and how it is used.
992 */
993static inline struct zxdg_toplevel_v6 *
994zxdg_surface_v6_get_toplevel(struct zxdg_surface_v6 *zxdg_surface_v6)
995{
996 struct wl_proxy *id;
997
998 id = wl_proxy_marshal_flags((struct wl_proxy *) zxdg_surface_v6,
999 ZXDG_SURFACE_V6_GET_TOPLEVEL, &zxdg_toplevel_v6_interface, wl_proxy_get_version((struct wl_proxy *) zxdg_surface_v6), 0, NULL);
1000
1001 return (struct zxdg_toplevel_v6 *) id;
1002}
1003
1004/**
1005 * @ingroup iface_zxdg_surface_v6
1006 *
1007 * This creates an xdg_popup object for the given xdg_surface and gives the
1008 * associated wl_surface the xdg_popup role.
1009 *
1010 * See the documentation of xdg_popup for more details about what an
1011 * xdg_popup is and how it is used.
1012 */
1013static inline struct zxdg_popup_v6 *
1014zxdg_surface_v6_get_popup(struct zxdg_surface_v6 *zxdg_surface_v6, struct zxdg_surface_v6 *parent, struct zxdg_positioner_v6 *positioner)
1015{
1016 struct wl_proxy *id;
1017
1018 id = wl_proxy_marshal_flags((struct wl_proxy *) zxdg_surface_v6,
1019 ZXDG_SURFACE_V6_GET_POPUP, &zxdg_popup_v6_interface, wl_proxy_get_version((struct wl_proxy *) zxdg_surface_v6), 0, NULL, parent, positioner);
1020
1021 return (struct zxdg_popup_v6 *) id;
1022}
1023
1024/**
1025 * @ingroup iface_zxdg_surface_v6
1026 *
1027 * The window geometry of a surface is its "visible bounds" from the
1028 * user's perspective. Client-side decorations often have invisible
1029 * portions like drop-shadows which should be ignored for the
1030 * purposes of aligning, placing and constraining windows.
1031 *
1032 * The window geometry is double buffered, and will be applied at the
1033 * time wl_surface.commit of the corresponding wl_surface is called.
1034 *
1035 * Once the window geometry of the surface is set, it is not possible to
1036 * unset it, and it will remain the same until set_window_geometry is
1037 * called again, even if a new subsurface or buffer is attached.
1038 *
1039 * If never set, the value is the full bounds of the surface,
1040 * including any subsurfaces. This updates dynamically on every
1041 * commit. This unset is meant for extremely simple clients.
1042 *
1043 * The arguments are given in the surface-local coordinate space of
1044 * the wl_surface associated with this xdg_surface.
1045 *
1046 * The width and height must be greater than zero. Setting an invalid size
1047 * will raise an error. When applied, the effective window geometry will be
1048 * the set window geometry clamped to the bounding rectangle of the
1049 * combined geometry of the surface of the xdg_surface and the associated
1050 * subsurfaces.
1051 */
1052static inline void
1054{
1055 wl_proxy_marshal_flags((struct wl_proxy *) zxdg_surface_v6,
1056 ZXDG_SURFACE_V6_SET_WINDOW_GEOMETRY, NULL, wl_proxy_get_version((struct wl_proxy *) zxdg_surface_v6), 0, x, y, width, height);
1057}
1058
1059/**
1060 * @ingroup iface_zxdg_surface_v6
1061 *
1062 * When a configure event is received, if a client commits the
1063 * surface in response to the configure event, then the client
1064 * must make an ack_configure request sometime before the commit
1065 * request, passing along the serial of the configure event.
1066 *
1067 * For instance, for toplevel surfaces the compositor might use this
1068 * information to move a surface to the top left only when the client has
1069 * drawn itself for the maximized or fullscreen state.
1070 *
1071 * If the client receives multiple configure events before it
1072 * can respond to one, it only has to ack the last configure event.
1073 *
1074 * A client is not required to commit immediately after sending
1075 * an ack_configure request - it may even ack_configure several times
1076 * before its next surface commit.
1077 *
1078 * A client may send multiple ack_configure requests before committing, but
1079 * only the last request sent before a commit indicates which configure
1080 * event the client really is responding to.
1081 */
1082static inline void
1083zxdg_surface_v6_ack_configure(struct zxdg_surface_v6 *zxdg_surface_v6, uint32_t serial)
1084{
1085 wl_proxy_marshal_flags((struct wl_proxy *) zxdg_surface_v6,
1086 ZXDG_SURFACE_V6_ACK_CONFIGURE, NULL, wl_proxy_get_version((struct wl_proxy *) zxdg_surface_v6), 0, serial);
1087}
1088
1089#ifndef ZXDG_TOPLEVEL_V6_RESIZE_EDGE_ENUM
1090#define ZXDG_TOPLEVEL_V6_RESIZE_EDGE_ENUM
1091/**
1092 * @ingroup iface_zxdg_toplevel_v6
1093 * edge values for resizing
1094 *
1095 * These values are used to indicate which edge of a surface
1096 * is being dragged in a resize operation.
1097 */
1108};
1109#endif /* ZXDG_TOPLEVEL_V6_RESIZE_EDGE_ENUM */
1110
1111#ifndef ZXDG_TOPLEVEL_V6_STATE_ENUM
1112#define ZXDG_TOPLEVEL_V6_STATE_ENUM
1113/**
1114 * @ingroup iface_zxdg_toplevel_v6
1115 * types of state on the surface
1116 *
1117 * The different state values used on the surface. This is designed for
1118 * state values like maximized, fullscreen. It is paired with the
1119 * configure event to ensure that both the client and the compositor
1120 * setting the state can be synchronized.
1121 *
1122 * States set in this way are double-buffered. They will get applied on
1123 * the next commit.
1124 */
1126 /**
1127 * the surface is maximized
1128 * the surface is maximized
1129 *
1130 * The surface is maximized. The window geometry specified in the
1131 * configure event must be obeyed by the client.
1132 */
1134 /**
1135 * the surface is fullscreen
1136 * the surface is fullscreen
1137 *
1138 * The surface is fullscreen. The window geometry specified in
1139 * the configure event must be obeyed by the client.
1140 */
1142 /**
1143 * the surface is being resized
1144 * the surface is being resized
1145 *
1146 * The surface is being resized. The window geometry specified in
1147 * the configure event is a maximum; the client cannot resize
1148 * beyond it. Clients that have aspect ratio or cell sizing
1149 * configuration can use a smaller size, however.
1150 */
1152 /**
1153 * the surface is now activated
1154 * the surface is now activated
1155 *
1156 * Client window decorations should be painted as if the window
1157 * is active. Do not assume this means that the window actually has
1158 * keyboard or pointer focus.
1159 */
1161};
1162#endif /* ZXDG_TOPLEVEL_V6_STATE_ENUM */
1163
1164/**
1165 * @ingroup iface_zxdg_toplevel_v6
1166 * @struct zxdg_toplevel_v6_listener
1167 */
1169 /**
1170 * suggest a surface change
1171 *
1172 * This configure event asks the client to resize its toplevel
1173 * surface or to change its state. The configured state should not
1174 * be applied immediately. See xdg_surface.configure for details.
1175 *
1176 * The width and height arguments specify a hint to the window
1177 * about how its surface should be resized in window geometry
1178 * coordinates. See set_window_geometry.
1179 *
1180 * If the width or height arguments are zero, it means the client
1181 * should decide its own window dimension. This may happen when the
1182 * compositor needs to configure the state of the surface but
1183 * doesn't have any information about any previous or expected
1184 * dimension.
1185 *
1186 * The states listed in the event specify how the width/height
1187 * arguments should be interpreted, and possibly how it should be
1188 * drawn.
1189 *
1190 * Clients must send an ack_configure in response to this event.
1191 * See xdg_surface.configure and xdg_surface.ack_configure for
1192 * details.
1193 */
1195 struct zxdg_toplevel_v6 *zxdg_toplevel_v6,
1196 int32_t width,
1198 struct wl_array *states);
1199 /**
1200 * surface wants to be closed
1201 *
1202 * The close event is sent by the compositor when the user wants
1203 * the surface to be closed. This should be equivalent to the user
1204 * clicking the close button in client-side decorations, if your
1205 * application has any.
1206 *
1207 * This is only a request that the user intends to close the
1208 * window. The client may choose to ignore this request, or show a
1209 * dialog to ask the user to save their data, etc.
1210 */
1211 void (*close)(void *data,
1212 struct zxdg_toplevel_v6 *zxdg_toplevel_v6);
1213};
1214
1215/**
1216 * @ingroup iface_zxdg_toplevel_v6
1217 */
1218static inline int
1219zxdg_toplevel_v6_add_listener(struct zxdg_toplevel_v6 *zxdg_toplevel_v6,
1220 const struct zxdg_toplevel_v6_listener *listener, void *data)
1221{
1222 return wl_proxy_add_listener((struct wl_proxy *) zxdg_toplevel_v6,
1223 (void (**)(void)) listener, data);
1224}
1225
1226#define ZXDG_TOPLEVEL_V6_DESTROY 0
1227#define ZXDG_TOPLEVEL_V6_SET_PARENT 1
1228#define ZXDG_TOPLEVEL_V6_SET_TITLE 2
1229#define ZXDG_TOPLEVEL_V6_SET_APP_ID 3
1230#define ZXDG_TOPLEVEL_V6_SHOW_WINDOW_MENU 4
1231#define ZXDG_TOPLEVEL_V6_MOVE 5
1232#define ZXDG_TOPLEVEL_V6_RESIZE 6
1233#define ZXDG_TOPLEVEL_V6_SET_MAX_SIZE 7
1234#define ZXDG_TOPLEVEL_V6_SET_MIN_SIZE 8
1235#define ZXDG_TOPLEVEL_V6_SET_MAXIMIZED 9
1236#define ZXDG_TOPLEVEL_V6_UNSET_MAXIMIZED 10
1237#define ZXDG_TOPLEVEL_V6_SET_FULLSCREEN 11
1238#define ZXDG_TOPLEVEL_V6_UNSET_FULLSCREEN 12
1239#define ZXDG_TOPLEVEL_V6_SET_MINIMIZED 13
1240
1241/**
1242 * @ingroup iface_zxdg_toplevel_v6
1243 */
1244#define ZXDG_TOPLEVEL_V6_CONFIGURE_SINCE_VERSION 1
1245/**
1246 * @ingroup iface_zxdg_toplevel_v6
1247 */
1248#define ZXDG_TOPLEVEL_V6_CLOSE_SINCE_VERSION 1
1249
1250/**
1251 * @ingroup iface_zxdg_toplevel_v6
1252 */
1253#define ZXDG_TOPLEVEL_V6_DESTROY_SINCE_VERSION 1
1254/**
1255 * @ingroup iface_zxdg_toplevel_v6
1256 */
1257#define ZXDG_TOPLEVEL_V6_SET_PARENT_SINCE_VERSION 1
1258/**
1259 * @ingroup iface_zxdg_toplevel_v6
1260 */
1261#define ZXDG_TOPLEVEL_V6_SET_TITLE_SINCE_VERSION 1
1262/**
1263 * @ingroup iface_zxdg_toplevel_v6
1264 */
1265#define ZXDG_TOPLEVEL_V6_SET_APP_ID_SINCE_VERSION 1
1266/**
1267 * @ingroup iface_zxdg_toplevel_v6
1268 */
1269#define ZXDG_TOPLEVEL_V6_SHOW_WINDOW_MENU_SINCE_VERSION 1
1270/**
1271 * @ingroup iface_zxdg_toplevel_v6
1272 */
1273#define ZXDG_TOPLEVEL_V6_MOVE_SINCE_VERSION 1
1274/**
1275 * @ingroup iface_zxdg_toplevel_v6
1276 */
1277#define ZXDG_TOPLEVEL_V6_RESIZE_SINCE_VERSION 1
1278/**
1279 * @ingroup iface_zxdg_toplevel_v6
1280 */
1281#define ZXDG_TOPLEVEL_V6_SET_MAX_SIZE_SINCE_VERSION 1
1282/**
1283 * @ingroup iface_zxdg_toplevel_v6
1284 */
1285#define ZXDG_TOPLEVEL_V6_SET_MIN_SIZE_SINCE_VERSION 1
1286/**
1287 * @ingroup iface_zxdg_toplevel_v6
1288 */
1289#define ZXDG_TOPLEVEL_V6_SET_MAXIMIZED_SINCE_VERSION 1
1290/**
1291 * @ingroup iface_zxdg_toplevel_v6
1292 */
1293#define ZXDG_TOPLEVEL_V6_UNSET_MAXIMIZED_SINCE_VERSION 1
1294/**
1295 * @ingroup iface_zxdg_toplevel_v6
1296 */
1297#define ZXDG_TOPLEVEL_V6_SET_FULLSCREEN_SINCE_VERSION 1
1298/**
1299 * @ingroup iface_zxdg_toplevel_v6
1300 */
1301#define ZXDG_TOPLEVEL_V6_UNSET_FULLSCREEN_SINCE_VERSION 1
1302/**
1303 * @ingroup iface_zxdg_toplevel_v6
1304 */
1305#define ZXDG_TOPLEVEL_V6_SET_MINIMIZED_SINCE_VERSION 1
1306
1307/** @ingroup iface_zxdg_toplevel_v6 */
1308static inline void
1309zxdg_toplevel_v6_set_user_data(struct zxdg_toplevel_v6 *zxdg_toplevel_v6, void *user_data)
1310{
1311 wl_proxy_set_user_data((struct wl_proxy *) zxdg_toplevel_v6, user_data);
1312}
1313
1314/** @ingroup iface_zxdg_toplevel_v6 */
1315static inline void *
1316zxdg_toplevel_v6_get_user_data(struct zxdg_toplevel_v6 *zxdg_toplevel_v6)
1317{
1318 return wl_proxy_get_user_data((struct wl_proxy *) zxdg_toplevel_v6);
1319}
1320
1321static inline uint32_t
1322zxdg_toplevel_v6_get_version(struct zxdg_toplevel_v6 *zxdg_toplevel_v6)
1323{
1324 return wl_proxy_get_version((struct wl_proxy *) zxdg_toplevel_v6);
1325}
1326
1327/**
1328 * @ingroup iface_zxdg_toplevel_v6
1329 *
1330 * Unmap and destroy the window. The window will be effectively
1331 * hidden from the user's point of view, and all state like
1332 * maximization, fullscreen, and so on, will be lost.
1333 */
1334static inline void
1335zxdg_toplevel_v6_destroy(struct zxdg_toplevel_v6 *zxdg_toplevel_v6)
1336{
1337 wl_proxy_marshal_flags((struct wl_proxy *) zxdg_toplevel_v6,
1338 ZXDG_TOPLEVEL_V6_DESTROY, NULL, wl_proxy_get_version((struct wl_proxy *) zxdg_toplevel_v6), WL_MARSHAL_FLAG_DESTROY);
1339}
1340
1341/**
1342 * @ingroup iface_zxdg_toplevel_v6
1343 *
1344 * Set the "parent" of this surface. This window should be stacked
1345 * above a parent. The parent surface must be mapped as long as this
1346 * surface is mapped.
1347 *
1348 * Parent windows should be set on dialogs, toolboxes, or other
1349 * "auxiliary" surfaces, so that the parent is raised when the dialog
1350 * is raised.
1351 */
1352static inline void
1353zxdg_toplevel_v6_set_parent(struct zxdg_toplevel_v6 *zxdg_toplevel_v6, struct zxdg_toplevel_v6 *parent)
1354{
1355 wl_proxy_marshal_flags((struct wl_proxy *) zxdg_toplevel_v6,
1356 ZXDG_TOPLEVEL_V6_SET_PARENT, NULL, wl_proxy_get_version((struct wl_proxy *) zxdg_toplevel_v6), 0, parent);
1357}
1358
1359/**
1360 * @ingroup iface_zxdg_toplevel_v6
1361 *
1362 * Set a short title for the surface.
1363 *
1364 * This string may be used to identify the surface in a task bar,
1365 * window list, or other user interface elements provided by the
1366 * compositor.
1367 *
1368 * The string must be encoded in UTF-8.
1369 */
1370static inline void
1371zxdg_toplevel_v6_set_title(struct zxdg_toplevel_v6 *zxdg_toplevel_v6, const char *title)
1372{
1373 wl_proxy_marshal_flags((struct wl_proxy *) zxdg_toplevel_v6,
1374 ZXDG_TOPLEVEL_V6_SET_TITLE, NULL, wl_proxy_get_version((struct wl_proxy *) zxdg_toplevel_v6), 0, title);
1375}
1376
1377/**
1378 * @ingroup iface_zxdg_toplevel_v6
1379 *
1380 * Set an application identifier for the surface.
1381 *
1382 * The app ID identifies the general class of applications to which
1383 * the surface belongs. The compositor can use this to group multiple
1384 * surfaces together, or to determine how to launch a new application.
1385 *
1386 * For D-Bus activatable applications, the app ID is used as the D-Bus
1387 * service name.
1388 *
1389 * The compositor shell will try to group application surfaces together
1390 * by their app ID. As a best practice, it is suggested to select app
1391 * ID's that match the basename of the application's .desktop file.
1392 * For example, "org.freedesktop.FooViewer" where the .desktop file is
1393 * "org.freedesktop.FooViewer.desktop".
1394 *
1395 * See the desktop-entry specification [0] for more details on
1396 * application identifiers and how they relate to well-known D-Bus
1397 * names and .desktop files.
1398 *
1399 * [0] http://standards.freedesktop.org/desktop-entry-spec/
1400 */
1401static inline void
1402zxdg_toplevel_v6_set_app_id(struct zxdg_toplevel_v6 *zxdg_toplevel_v6, const char *app_id)
1403{
1404 wl_proxy_marshal_flags((struct wl_proxy *) zxdg_toplevel_v6,
1405 ZXDG_TOPLEVEL_V6_SET_APP_ID, NULL, wl_proxy_get_version((struct wl_proxy *) zxdg_toplevel_v6), 0, app_id);
1406}
1407
1408/**
1409 * @ingroup iface_zxdg_toplevel_v6
1410 *
1411 * Clients implementing client-side decorations might want to show
1412 * a context menu when right-clicking on the decorations, giving the
1413 * user a menu that they can use to maximize or minimize the window.
1414 *
1415 * This request asks the compositor to pop up such a window menu at
1416 * the given position, relative to the local surface coordinates of
1417 * the parent surface. There are no guarantees as to what menu items
1418 * the window menu contains.
1419 *
1420 * This request must be used in response to some sort of user action
1421 * like a button press, key press, or touch down event.
1422 */
1423static inline void
1424zxdg_toplevel_v6_show_window_menu(struct zxdg_toplevel_v6 *zxdg_toplevel_v6, struct wl_seat *seat, uint32_t serial, int32_t x, int32_t y)
1425{
1426 wl_proxy_marshal_flags((struct wl_proxy *) zxdg_toplevel_v6,
1427 ZXDG_TOPLEVEL_V6_SHOW_WINDOW_MENU, NULL, wl_proxy_get_version((struct wl_proxy *) zxdg_toplevel_v6), 0, seat, serial, x, y);
1428}
1429
1430/**
1431 * @ingroup iface_zxdg_toplevel_v6
1432 *
1433 * Start an interactive, user-driven move of the surface.
1434 *
1435 * This request must be used in response to some sort of user action
1436 * like a button press, key press, or touch down event. The passed
1437 * serial is used to determine the type of interactive move (touch,
1438 * pointer, etc).
1439 *
1440 * The server may ignore move requests depending on the state of
1441 * the surface (e.g. fullscreen or maximized), or if the passed serial
1442 * is no longer valid.
1443 *
1444 * If triggered, the surface will lose the focus of the device
1445 * (wl_pointer, wl_touch, etc) used for the move. It is up to the
1446 * compositor to visually indicate that the move is taking place, such as
1447 * updating a pointer cursor, during the move. There is no guarantee
1448 * that the device focus will return when the move is completed.
1449 */
1450static inline void
1451zxdg_toplevel_v6_move(struct zxdg_toplevel_v6 *zxdg_toplevel_v6, struct wl_seat *seat, uint32_t serial)
1452{
1453 wl_proxy_marshal_flags((struct wl_proxy *) zxdg_toplevel_v6,
1454 ZXDG_TOPLEVEL_V6_MOVE, NULL, wl_proxy_get_version((struct wl_proxy *) zxdg_toplevel_v6), 0, seat, serial);
1455}
1456
1457/**
1458 * @ingroup iface_zxdg_toplevel_v6
1459 *
1460 * Start a user-driven, interactive resize of the surface.
1461 *
1462 * This request must be used in response to some sort of user action
1463 * like a button press, key press, or touch down event. The passed
1464 * serial is used to determine the type of interactive resize (touch,
1465 * pointer, etc).
1466 *
1467 * The server may ignore resize requests depending on the state of
1468 * the surface (e.g. fullscreen or maximized).
1469 *
1470 * If triggered, the client will receive configure events with the
1471 * "resize" state enum value and the expected sizes. See the "resize"
1472 * enum value for more details about what is required. The client
1473 * must also acknowledge configure events using "ack_configure". After
1474 * the resize is completed, the client will receive another "configure"
1475 * event without the resize state.
1476 *
1477 * If triggered, the surface also will lose the focus of the device
1478 * (wl_pointer, wl_touch, etc) used for the resize. It is up to the
1479 * compositor to visually indicate that the resize is taking place,
1480 * such as updating a pointer cursor, during the resize. There is no
1481 * guarantee that the device focus will return when the resize is
1482 * completed.
1483 *
1484 * The edges parameter specifies how the surface should be resized,
1485 * and is one of the values of the resize_edge enum. The compositor
1486 * may use this information to update the surface position for
1487 * example when dragging the top left corner. The compositor may also
1488 * use this information to adapt its behavior, e.g. choose an
1489 * appropriate cursor image.
1490 */
1491static inline void
1492zxdg_toplevel_v6_resize(struct zxdg_toplevel_v6 *zxdg_toplevel_v6, struct wl_seat *seat, uint32_t serial, uint32_t edges)
1493{
1494 wl_proxy_marshal_flags((struct wl_proxy *) zxdg_toplevel_v6,
1495 ZXDG_TOPLEVEL_V6_RESIZE, NULL, wl_proxy_get_version((struct wl_proxy *) zxdg_toplevel_v6), 0, seat, serial, edges);
1496}
1497
1498/**
1499 * @ingroup iface_zxdg_toplevel_v6
1500 *
1501 * Set a maximum size for the window.
1502 *
1503 * The client can specify a maximum size so that the compositor does
1504 * not try to configure the window beyond this size.
1505 *
1506 * The width and height arguments are in window geometry coordinates.
1507 * See xdg_surface.set_window_geometry.
1508 *
1509 * Values set in this way are double-buffered. They will get applied
1510 * on the next commit.
1511 *
1512 * The compositor can use this information to allow or disallow
1513 * different states like maximize or fullscreen and draw accurate
1514 * animations.
1515 *
1516 * Similarly, a tiling window manager may use this information to
1517 * place and resize client windows in a more effective way.
1518 *
1519 * The client should not rely on the compositor to obey the maximum
1520 * size. The compositor may decide to ignore the values set by the
1521 * client and request a larger size.
1522 *
1523 * If never set, or a value of zero in the request, means that the
1524 * client has no expected maximum size in the given dimension.
1525 * As a result, a client wishing to reset the maximum size
1526 * to an unspecified state can use zero for width and height in the
1527 * request.
1528 *
1529 * Requesting a maximum size to be smaller than the minimum size of
1530 * a surface is illegal and will result in a protocol error.
1531 *
1532 * The width and height must be greater than or equal to zero. Using
1533 * strictly negative values for width and height will result in a
1534 * protocol error.
1535 */
1536static inline void
1537zxdg_toplevel_v6_set_max_size(struct zxdg_toplevel_v6 *zxdg_toplevel_v6, int32_t width, int32_t height)
1538{
1539 wl_proxy_marshal_flags((struct wl_proxy *) zxdg_toplevel_v6,
1540 ZXDG_TOPLEVEL_V6_SET_MAX_SIZE, NULL, wl_proxy_get_version((struct wl_proxy *) zxdg_toplevel_v6), 0, width, height);
1541}
1542
1543/**
1544 * @ingroup iface_zxdg_toplevel_v6
1545 *
1546 * Set a minimum size for the window.
1547 *
1548 * The client can specify a minimum size so that the compositor does
1549 * not try to configure the window below this size.
1550 *
1551 * The width and height arguments are in window geometry coordinates.
1552 * See xdg_surface.set_window_geometry.
1553 *
1554 * Values set in this way are double-buffered. They will get applied
1555 * on the next commit.
1556 *
1557 * The compositor can use this information to allow or disallow
1558 * different states like maximize or fullscreen and draw accurate
1559 * animations.
1560 *
1561 * Similarly, a tiling window manager may use this information to
1562 * place and resize client windows in a more effective way.
1563 *
1564 * The client should not rely on the compositor to obey the minimum
1565 * size. The compositor may decide to ignore the values set by the
1566 * client and request a smaller size.
1567 *
1568 * If never set, or a value of zero in the request, means that the
1569 * client has no expected minimum size in the given dimension.
1570 * As a result, a client wishing to reset the minimum size
1571 * to an unspecified state can use zero for width and height in the
1572 * request.
1573 *
1574 * Requesting a minimum size to be larger than the maximum size of
1575 * a surface is illegal and will result in a protocol error.
1576 *
1577 * The width and height must be greater than or equal to zero. Using
1578 * strictly negative values for width and height will result in a
1579 * protocol error.
1580 */
1581static inline void
1582zxdg_toplevel_v6_set_min_size(struct zxdg_toplevel_v6 *zxdg_toplevel_v6, int32_t width, int32_t height)
1583{
1584 wl_proxy_marshal_flags((struct wl_proxy *) zxdg_toplevel_v6,
1585 ZXDG_TOPLEVEL_V6_SET_MIN_SIZE, NULL, wl_proxy_get_version((struct wl_proxy *) zxdg_toplevel_v6), 0, width, height);
1586}
1587
1588/**
1589 * @ingroup iface_zxdg_toplevel_v6
1590 *
1591 * Maximize the surface.
1592 *
1593 * After requesting that the surface should be maximized, the compositor
1594 * will respond by emitting a configure event with the "maximized" state
1595 * and the required window geometry. The client should then update its
1596 * content, drawing it in a maximized state, i.e. without shadow or other
1597 * decoration outside of the window geometry. The client must also
1598 * acknowledge the configure when committing the new content (see
1599 * ack_configure).
1600 *
1601 * It is up to the compositor to decide how and where to maximize the
1602 * surface, for example which output and what region of the screen should
1603 * be used.
1604 *
1605 * If the surface was already maximized, the compositor will still emit
1606 * a configure event with the "maximized" state.
1607 */
1608static inline void
1609zxdg_toplevel_v6_set_maximized(struct zxdg_toplevel_v6 *zxdg_toplevel_v6)
1610{
1611 wl_proxy_marshal_flags((struct wl_proxy *) zxdg_toplevel_v6,
1612 ZXDG_TOPLEVEL_V6_SET_MAXIMIZED, NULL, wl_proxy_get_version((struct wl_proxy *) zxdg_toplevel_v6), 0);
1613}
1614
1615/**
1616 * @ingroup iface_zxdg_toplevel_v6
1617 *
1618 * Unmaximize the surface.
1619 *
1620 * After requesting that the surface should be unmaximized, the compositor
1621 * will respond by emitting a configure event without the "maximized"
1622 * state. If available, the compositor will include the window geometry
1623 * dimensions the window had prior to being maximized in the configure
1624 * request. The client must then update its content, drawing it in a
1625 * regular state, i.e. potentially with shadow, etc. The client must also
1626 * acknowledge the configure when committing the new content (see
1627 * ack_configure).
1628 *
1629 * It is up to the compositor to position the surface after it was
1630 * unmaximized; usually the position the surface had before maximizing, if
1631 * applicable.
1632 *
1633 * If the surface was already not maximized, the compositor will still
1634 * emit a configure event without the "maximized" state.
1635 */
1636static inline void
1637zxdg_toplevel_v6_unset_maximized(struct zxdg_toplevel_v6 *zxdg_toplevel_v6)
1638{
1639 wl_proxy_marshal_flags((struct wl_proxy *) zxdg_toplevel_v6,
1640 ZXDG_TOPLEVEL_V6_UNSET_MAXIMIZED, NULL, wl_proxy_get_version((struct wl_proxy *) zxdg_toplevel_v6), 0);
1641}
1642
1643/**
1644 * @ingroup iface_zxdg_toplevel_v6
1645 *
1646 * Make the surface fullscreen.
1647 *
1648 * You can specify an output that you would prefer to be fullscreen.
1649 * If this value is NULL, it's up to the compositor to choose which
1650 * display will be used to map this surface.
1651 *
1652 * If the surface doesn't cover the whole output, the compositor will
1653 * position the surface in the center of the output and compensate with
1654 * black borders filling the rest of the output.
1655 */
1656static inline void
1657zxdg_toplevel_v6_set_fullscreen(struct zxdg_toplevel_v6 *zxdg_toplevel_v6, struct wl_output *output)
1658{
1659 wl_proxy_marshal_flags((struct wl_proxy *) zxdg_toplevel_v6,
1660 ZXDG_TOPLEVEL_V6_SET_FULLSCREEN, NULL, wl_proxy_get_version((struct wl_proxy *) zxdg_toplevel_v6), 0, output);
1661}
1662
1663/**
1664 * @ingroup iface_zxdg_toplevel_v6
1665 */
1666static inline void
1667zxdg_toplevel_v6_unset_fullscreen(struct zxdg_toplevel_v6 *zxdg_toplevel_v6)
1668{
1669 wl_proxy_marshal_flags((struct wl_proxy *) zxdg_toplevel_v6,
1670 ZXDG_TOPLEVEL_V6_UNSET_FULLSCREEN, NULL, wl_proxy_get_version((struct wl_proxy *) zxdg_toplevel_v6), 0);
1671}
1672
1673/**
1674 * @ingroup iface_zxdg_toplevel_v6
1675 *
1676 * Request that the compositor minimize your surface. There is no
1677 * way to know if the surface is currently minimized, nor is there
1678 * any way to unset minimization on this surface.
1679 *
1680 * If you are looking to throttle redrawing when minimized, please
1681 * instead use the wl_surface.frame event for this, as this will
1682 * also work with live previews on windows in Alt-Tab, Expose or
1683 * similar compositor features.
1684 */
1685static inline void
1686zxdg_toplevel_v6_set_minimized(struct zxdg_toplevel_v6 *zxdg_toplevel_v6)
1687{
1688 wl_proxy_marshal_flags((struct wl_proxy *) zxdg_toplevel_v6,
1689 ZXDG_TOPLEVEL_V6_SET_MINIMIZED, NULL, wl_proxy_get_version((struct wl_proxy *) zxdg_toplevel_v6), 0);
1690}
1691
1692#ifndef ZXDG_POPUP_V6_ERROR_ENUM
1693#define ZXDG_POPUP_V6_ERROR_ENUM
1695 /**
1696 * tried to grab after being mapped
1697 */
1699};
1700#endif /* ZXDG_POPUP_V6_ERROR_ENUM */
1701
1702/**
1703 * @ingroup iface_zxdg_popup_v6
1704 * @struct zxdg_popup_v6_listener
1705 */
1707 /**
1708 * configure the popup surface
1709 *
1710 * This event asks the popup surface to configure itself given
1711 * the configuration. The configured state should not be applied
1712 * immediately. See xdg_surface.configure for details.
1713 *
1714 * The x and y arguments represent the position the popup was
1715 * placed at given the xdg_positioner rule, relative to the upper
1716 * left corner of the window geometry of the parent surface.
1717 * @param x x position relative to parent surface window geometry
1718 * @param y y position relative to parent surface window geometry
1719 * @param width window geometry width
1720 * @param height window geometry height
1721 */
1723 struct zxdg_popup_v6 *zxdg_popup_v6,
1724 int32_t x,
1725 int32_t y,
1726 int32_t width,
1727 int32_t height);
1728 /**
1729 * popup interaction is done
1730 *
1731 * The popup_done event is sent out when a popup is dismissed by
1732 * the compositor. The client should destroy the xdg_popup object
1733 * at this point.
1734 */
1736 struct zxdg_popup_v6 *zxdg_popup_v6);
1737};
1738
1739/**
1740 * @ingroup iface_zxdg_popup_v6
1741 */
1742static inline int
1743zxdg_popup_v6_add_listener(struct zxdg_popup_v6 *zxdg_popup_v6,
1744 const struct zxdg_popup_v6_listener *listener, void *data)
1745{
1746 return wl_proxy_add_listener((struct wl_proxy *) zxdg_popup_v6,
1747 (void (**)(void)) listener, data);
1748}
1749
1750#define ZXDG_POPUP_V6_DESTROY 0
1751#define ZXDG_POPUP_V6_GRAB 1
1752
1753/**
1754 * @ingroup iface_zxdg_popup_v6
1755 */
1756#define ZXDG_POPUP_V6_CONFIGURE_SINCE_VERSION 1
1757/**
1758 * @ingroup iface_zxdg_popup_v6
1759 */
1760#define ZXDG_POPUP_V6_POPUP_DONE_SINCE_VERSION 1
1761
1762/**
1763 * @ingroup iface_zxdg_popup_v6
1764 */
1765#define ZXDG_POPUP_V6_DESTROY_SINCE_VERSION 1
1766/**
1767 * @ingroup iface_zxdg_popup_v6
1768 */
1769#define ZXDG_POPUP_V6_GRAB_SINCE_VERSION 1
1770
1771/** @ingroup iface_zxdg_popup_v6 */
1772static inline void
1773zxdg_popup_v6_set_user_data(struct zxdg_popup_v6 *zxdg_popup_v6, void *user_data)
1774{
1775 wl_proxy_set_user_data((struct wl_proxy *) zxdg_popup_v6, user_data);
1776}
1777
1778/** @ingroup iface_zxdg_popup_v6 */
1779static inline void *
1780zxdg_popup_v6_get_user_data(struct zxdg_popup_v6 *zxdg_popup_v6)
1781{
1782 return wl_proxy_get_user_data((struct wl_proxy *) zxdg_popup_v6);
1783}
1784
1785static inline uint32_t
1786zxdg_popup_v6_get_version(struct zxdg_popup_v6 *zxdg_popup_v6)
1787{
1788 return wl_proxy_get_version((struct wl_proxy *) zxdg_popup_v6);
1789}
1790
1791/**
1792 * @ingroup iface_zxdg_popup_v6
1793 *
1794 * This destroys the popup. Explicitly destroying the xdg_popup
1795 * object will also dismiss the popup, and unmap the surface.
1796 *
1797 * If this xdg_popup is not the "topmost" popup, a protocol error
1798 * will be sent.
1799 */
1800static inline void
1801zxdg_popup_v6_destroy(struct zxdg_popup_v6 *zxdg_popup_v6)
1802{
1803 wl_proxy_marshal_flags((struct wl_proxy *) zxdg_popup_v6,
1804 ZXDG_POPUP_V6_DESTROY, NULL, wl_proxy_get_version((struct wl_proxy *) zxdg_popup_v6), WL_MARSHAL_FLAG_DESTROY);
1805}
1806
1807/**
1808 * @ingroup iface_zxdg_popup_v6
1809 *
1810 * This request makes the created popup take an explicit grab. An explicit
1811 * grab will be dismissed when the user dismisses the popup, or when the
1812 * client destroys the xdg_popup. This can be done by the user clicking
1813 * outside the surface, using the keyboard, or even locking the screen
1814 * through closing the lid or a timeout.
1815 *
1816 * If the compositor denies the grab, the popup will be immediately
1817 * dismissed.
1818 *
1819 * This request must be used in response to some sort of user action like a
1820 * button press, key press, or touch down event. The serial number of the
1821 * event should be passed as 'serial'.
1822 *
1823 * The parent of a grabbing popup must either be an xdg_toplevel surface or
1824 * another xdg_popup with an explicit grab. If the parent is another
1825 * xdg_popup it means that the popups are nested, with this popup now being
1826 * the topmost popup.
1827 *
1828 * Nested popups must be destroyed in the reverse order they were created
1829 * in, e.g. the only popup you are allowed to destroy at all times is the
1830 * topmost one.
1831 *
1832 * When compositors choose to dismiss a popup, they may dismiss every
1833 * nested grabbing popup as well. When a compositor dismisses popups, it
1834 * will follow the same dismissing order as required from the client.
1835 *
1836 * The parent of a grabbing popup must either be another xdg_popup with an
1837 * active explicit grab, or an xdg_popup or xdg_toplevel, if there are no
1838 * explicit grabs already taken.
1839 *
1840 * If the topmost grabbing popup is destroyed, the grab will be returned to
1841 * the parent of the popup, if that parent previously had an explicit grab.
1842 *
1843 * If the parent is a grabbing popup which has already been dismissed, this
1844 * popup will be immediately dismissed. If the parent is a popup that did
1845 * not take an explicit grab, an error will be raised.
1846 *
1847 * During a popup grab, the client owning the grab will receive pointer
1848 * and touch events for all their surfaces as normal (similar to an
1849 * "owner-events" grab in X11 parlance), while the top most grabbing popup
1850 * will always have keyboard focus.
1851 */
1852static inline void
1853zxdg_popup_v6_grab(struct zxdg_popup_v6 *zxdg_popup_v6, struct wl_seat *seat, uint32_t serial)
1854{
1855 wl_proxy_marshal_flags((struct wl_proxy *) zxdg_popup_v6,
1856 ZXDG_POPUP_V6_GRAB, NULL, wl_proxy_get_version((struct wl_proxy *) zxdg_popup_v6), 0, seat, serial);
1857}
1858
1859#ifdef __cplusplus
1860}
1861#endif
1862
1863#endif
unsigned int uint32_t
signed int int32_t
SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char const char SDL_SCANF_FORMAT_STRING const char return SDL_ThreadFunction const char void return Uint32 return Uint32 void
GLint GLint GLint GLint GLint GLint y
Definition: SDL_opengl.h:1574
GLint GLenum GLsizei GLsizei GLsizei GLint GLsizei const GLvoid * data
Definition: SDL_opengl.h:1974
GLint GLint GLsizei width
Definition: SDL_opengl.h:1572
GLint GLint GLint GLint GLint x
Definition: SDL_opengl.h:1574
GLint GLint GLsizei GLsizei height
Definition: SDL_opengl.h:1572
GLuint id
#define NULL
Definition: begin_code.h:167
EGLSurface surface
Definition: eglext.h:248
static void zxdg_popup_v6_grab(struct zxdg_popup_v6 *zxdg_popup_v6, struct wl_seat *seat, uint32_t serial)
static int zxdg_popup_v6_add_listener(struct zxdg_popup_v6 *zxdg_popup_v6, const struct zxdg_popup_v6_listener *listener, void *data)
static void * zxdg_popup_v6_get_user_data(struct zxdg_popup_v6 *zxdg_popup_v6)
static void zxdg_popup_v6_set_user_data(struct zxdg_popup_v6 *zxdg_popup_v6, void *user_data)
static void zxdg_popup_v6_destroy(struct zxdg_popup_v6 *zxdg_popup_v6)
static void zxdg_positioner_v6_destroy(struct zxdg_positioner_v6 *zxdg_positioner_v6)
static void zxdg_positioner_v6_set_anchor_rect(struct zxdg_positioner_v6 *zxdg_positioner_v6, int32_t x, int32_t y, int32_t width, int32_t height)
static void zxdg_positioner_v6_set_size(struct zxdg_positioner_v6 *zxdg_positioner_v6, int32_t width, int32_t height)
static void zxdg_positioner_v6_set_constraint_adjustment(struct zxdg_positioner_v6 *zxdg_positioner_v6, uint32_t constraint_adjustment)
static void * zxdg_positioner_v6_get_user_data(struct zxdg_positioner_v6 *zxdg_positioner_v6)
static void zxdg_positioner_v6_set_anchor(struct zxdg_positioner_v6 *zxdg_positioner_v6, uint32_t anchor)
static void zxdg_positioner_v6_set_offset(struct zxdg_positioner_v6 *zxdg_positioner_v6, int32_t x, int32_t y)
static void zxdg_positioner_v6_set_gravity(struct zxdg_positioner_v6 *zxdg_positioner_v6, uint32_t gravity)
static void zxdg_positioner_v6_set_user_data(struct zxdg_positioner_v6 *zxdg_positioner_v6, void *user_data)
@ ZXDG_POSITIONER_V6_CONSTRAINT_ADJUSTMENT_SLIDE_Y
@ ZXDG_POSITIONER_V6_CONSTRAINT_ADJUSTMENT_NONE
@ ZXDG_POSITIONER_V6_CONSTRAINT_ADJUSTMENT_FLIP_X
@ ZXDG_POSITIONER_V6_CONSTRAINT_ADJUSTMENT_FLIP_Y
@ ZXDG_POSITIONER_V6_CONSTRAINT_ADJUSTMENT_SLIDE_X
@ ZXDG_POSITIONER_V6_CONSTRAINT_ADJUSTMENT_RESIZE_Y
@ ZXDG_POSITIONER_V6_CONSTRAINT_ADJUSTMENT_RESIZE_X
static void zxdg_shell_v6_destroy(struct zxdg_shell_v6 *zxdg_shell_v6)
static int zxdg_shell_v6_add_listener(struct zxdg_shell_v6 *zxdg_shell_v6, const struct zxdg_shell_v6_listener *listener, void *data)
static void * zxdg_shell_v6_get_user_data(struct zxdg_shell_v6 *zxdg_shell_v6)
static struct zxdg_positioner_v6 * zxdg_shell_v6_create_positioner(struct zxdg_shell_v6 *zxdg_shell_v6)
static void zxdg_shell_v6_pong(struct zxdg_shell_v6 *zxdg_shell_v6, uint32_t serial)
static void zxdg_shell_v6_set_user_data(struct zxdg_shell_v6 *zxdg_shell_v6, void *user_data)
static struct zxdg_surface_v6 * zxdg_shell_v6_get_xdg_surface(struct zxdg_shell_v6 *zxdg_shell_v6, struct wl_surface *surface)
static int zxdg_surface_v6_add_listener(struct zxdg_surface_v6 *zxdg_surface_v6, const struct zxdg_surface_v6_listener *listener, void *data)
static void zxdg_surface_v6_set_user_data(struct zxdg_surface_v6 *zxdg_surface_v6, void *user_data)
static void zxdg_surface_v6_destroy(struct zxdg_surface_v6 *zxdg_surface_v6)
static struct zxdg_toplevel_v6 * zxdg_surface_v6_get_toplevel(struct zxdg_surface_v6 *zxdg_surface_v6)
static struct zxdg_popup_v6 * zxdg_surface_v6_get_popup(struct zxdg_surface_v6 *zxdg_surface_v6, struct zxdg_surface_v6 *parent, struct zxdg_positioner_v6 *positioner)
static void zxdg_surface_v6_ack_configure(struct zxdg_surface_v6 *zxdg_surface_v6, uint32_t serial)
static void * zxdg_surface_v6_get_user_data(struct zxdg_surface_v6 *zxdg_surface_v6)
static void zxdg_surface_v6_set_window_geometry(struct zxdg_surface_v6 *zxdg_surface_v6, int32_t x, int32_t y, int32_t width, int32_t height)
static void * zxdg_toplevel_v6_get_user_data(struct zxdg_toplevel_v6 *zxdg_toplevel_v6)
static void zxdg_toplevel_v6_set_title(struct zxdg_toplevel_v6 *zxdg_toplevel_v6, const char *title)
static void zxdg_toplevel_v6_unset_maximized(struct zxdg_toplevel_v6 *zxdg_toplevel_v6)
static void zxdg_toplevel_v6_set_fullscreen(struct zxdg_toplevel_v6 *zxdg_toplevel_v6, struct wl_output *output)
static void zxdg_toplevel_v6_unset_fullscreen(struct zxdg_toplevel_v6 *zxdg_toplevel_v6)
static void zxdg_toplevel_v6_set_max_size(struct zxdg_toplevel_v6 *zxdg_toplevel_v6, int32_t width, int32_t height)
static void zxdg_toplevel_v6_set_maximized(struct zxdg_toplevel_v6 *zxdg_toplevel_v6)
static void zxdg_toplevel_v6_set_user_data(struct zxdg_toplevel_v6 *zxdg_toplevel_v6, void *user_data)
static void zxdg_toplevel_v6_set_parent(struct zxdg_toplevel_v6 *zxdg_toplevel_v6, struct zxdg_toplevel_v6 *parent)
static void zxdg_toplevel_v6_set_app_id(struct zxdg_toplevel_v6 *zxdg_toplevel_v6, const char *app_id)
static void zxdg_toplevel_v6_destroy(struct zxdg_toplevel_v6 *zxdg_toplevel_v6)
static void zxdg_toplevel_v6_show_window_menu(struct zxdg_toplevel_v6 *zxdg_toplevel_v6, struct wl_seat *seat, uint32_t serial, int32_t x, int32_t y)
static int zxdg_toplevel_v6_add_listener(struct zxdg_toplevel_v6 *zxdg_toplevel_v6, const struct zxdg_toplevel_v6_listener *listener, void *data)
static void zxdg_toplevel_v6_set_min_size(struct zxdg_toplevel_v6 *zxdg_toplevel_v6, int32_t width, int32_t height)
static void zxdg_toplevel_v6_set_minimized(struct zxdg_toplevel_v6 *zxdg_toplevel_v6)
static void zxdg_toplevel_v6_resize(struct zxdg_toplevel_v6 *zxdg_toplevel_v6, struct wl_seat *seat, uint32_t serial, uint32_t edges)
static void zxdg_toplevel_v6_move(struct zxdg_toplevel_v6 *zxdg_toplevel_v6, struct wl_seat *seat, uint32_t serial)
void(* popup_done)(void *data, struct zxdg_popup_v6 *zxdg_popup_v6)
void(* configure)(void *data, struct zxdg_popup_v6 *zxdg_popup_v6, int32_t x, int32_t y, int32_t width, int32_t height)
void(* ping)(void *data, struct zxdg_shell_v6 *zxdg_shell_v6, uint32_t serial)
void(* configure)(void *data, struct zxdg_surface_v6 *zxdg_surface_v6, uint32_t serial)
void(* configure)(void *data, struct zxdg_toplevel_v6 *zxdg_toplevel_v6, int32_t width, int32_t height, struct wl_array *states)
void(* close)(void *data, struct zxdg_toplevel_v6 *zxdg_toplevel_v6)
#define ZXDG_TOPLEVEL_V6_SET_MIN_SIZE
const struct wl_interface zxdg_shell_v6_interface
#define ZXDG_POSITIONER_V6_SET_SIZE
#define ZXDG_TOPLEVEL_V6_SET_MINIMIZED
#define ZXDG_SURFACE_V6_ACK_CONFIGURE
#define ZXDG_POSITIONER_V6_SET_ANCHOR_RECT
#define ZXDG_POSITIONER_V6_SET_ANCHOR
const struct wl_interface zxdg_surface_v6_interface
#define ZXDG_TOPLEVEL_V6_UNSET_FULLSCREEN
#define ZXDG_POSITIONER_V6_DESTROY
static uint32_t zxdg_positioner_v6_get_version(struct zxdg_positioner_v6 *zxdg_positioner_v6)
const struct wl_interface zxdg_popup_v6_interface
static uint32_t zxdg_surface_v6_get_version(struct zxdg_surface_v6 *zxdg_surface_v6)
#define ZXDG_SHELL_V6_GET_XDG_SURFACE
#define ZXDG_SHELL_V6_CREATE_POSITIONER
#define ZXDG_POSITIONER_V6_SET_CONSTRAINT_ADJUSTMENT
#define ZXDG_SURFACE_V6_SET_WINDOW_GEOMETRY
static uint32_t zxdg_shell_v6_get_version(struct zxdg_shell_v6 *zxdg_shell_v6)
#define ZXDG_TOPLEVEL_V6_SET_MAX_SIZE
#define ZXDG_POSITIONER_V6_SET_OFFSET
static uint32_t zxdg_popup_v6_get_version(struct zxdg_popup_v6 *zxdg_popup_v6)
const struct wl_interface zxdg_positioner_v6_interface
static uint32_t zxdg_toplevel_v6_get_version(struct zxdg_toplevel_v6 *zxdg_toplevel_v6)
#define ZXDG_TOPLEVEL_V6_SET_MAXIMIZED
#define ZXDG_TOPLEVEL_V6_SET_FULLSCREEN
#define ZXDG_SURFACE_V6_GET_TOPLEVEL
#define ZXDG_TOPLEVEL_V6_SHOW_WINDOW_MENU
#define ZXDG_POSITIONER_V6_SET_GRAVITY
#define ZXDG_TOPLEVEL_V6_UNSET_MAXIMIZED
const struct wl_interface zxdg_toplevel_v6_interface