| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265 |
- /* SCANNER TEST */
- #ifndef SMALL_TEST_SERVER_PROTOCOL_H
- #define SMALL_TEST_SERVER_PROTOCOL_H
- #include <stdint.h>
- #include <stddef.h>
- #include "wayland-server-core.h"
- #ifdef __cplusplus
- extern "C" {
- #endif
- struct wl_client;
- struct wl_resource;
- /**
- * @page page_small_test The small_test protocol
- * @section page_ifaces_small_test Interfaces
- * - @subpage page_iface_intf_A - the thing A
- * @section page_copyright_small_test Copyright
- * <pre>
- *
- * Copyright © 2016 Collabora, Ltd.
- *
- * 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 another_intf;
- struct intf_A;
- struct intf_not_here;
- #ifndef INTF_A_INTERFACE
- #define INTF_A_INTERFACE
- /**
- * @page page_iface_intf_A intf_A
- * @section page_iface_intf_A_desc Description
- *
- * A useless example trying to tickle the scanner.
- * @section page_iface_intf_A_api API
- * See @ref iface_intf_A.
- */
- /**
- * @defgroup iface_intf_A The intf_A interface
- *
- * A useless example trying to tickle the scanner.
- */
- extern const struct wl_interface intf_A_interface;
- #endif
- #ifndef INTF_A_FOO_ENUM
- #define INTF_A_FOO_ENUM
- enum intf_A_foo {
- /**
- * this is the first
- */
- INTF_A_FOO_FIRST = 0,
- /**
- * this is the second
- */
- INTF_A_FOO_SECOND = 1,
- /**
- * this is the third
- * @since 2
- */
- INTF_A_FOO_THIRD = 2,
- /**
- * this is a negative value
- * @since 2
- */
- INTF_A_FOO_NEGATIVE = -1,
- /**
- * this is a deprecated value
- * @since 2
- * @deprecated Deprecated since version 3
- */
- INTF_A_FOO_DEPRECATED = 3,
- };
- /**
- * @ingroup iface_intf_A
- */
- #define INTF_A_FOO_THIRD_SINCE_VERSION 2
- /**
- * @ingroup iface_intf_A
- */
- #define INTF_A_FOO_NEGATIVE_SINCE_VERSION 2
- /**
- * @ingroup iface_intf_A
- */
- #define INTF_A_FOO_DEPRECATED_SINCE_VERSION 2
- #endif /* INTF_A_FOO_ENUM */
- #ifndef INTF_A_FOO_ENUM_IS_VALID
- #define INTF_A_FOO_ENUM_IS_VALID
- /**
- * @ingroup iface_intf_A
- * Validate a intf_A foo value.
- *
- * @return true on success, false on error.
- * @ref intf_A_foo
- */
- static inline bool
- intf_A_foo_is_valid(uint32_t value, uint32_t version) {
- switch (value) {
- case INTF_A_FOO_FIRST:
- return version >= 1;
- case INTF_A_FOO_SECOND:
- return version >= 1;
- case INTF_A_FOO_THIRD:
- return version >= 2;
- case (uint32_t)INTF_A_FOO_NEGATIVE:
- return version >= 2;
- case INTF_A_FOO_DEPRECATED:
- return version >= 2;
- default:
- return false;
- }
- }
- #endif /* INTF_A_FOO_ENUM_IS_VALID */
- #ifndef INTF_A_BAR_ENUM
- #define INTF_A_BAR_ENUM
- enum intf_A_bar {
- /**
- * this is the first
- */
- INTF_A_BAR_FIRST = 0x01,
- /**
- * this is the second
- */
- INTF_A_BAR_SECOND = 0x02,
- /**
- * this is the third
- * @since 2
- */
- INTF_A_BAR_THIRD = 0x04,
- };
- /**
- * @ingroup iface_intf_A
- */
- #define INTF_A_BAR_THIRD_SINCE_VERSION 2
- #endif /* INTF_A_BAR_ENUM */
- #ifndef INTF_A_BAR_ENUM_IS_VALID
- #define INTF_A_BAR_ENUM_IS_VALID
- /**
- * @ingroup iface_intf_A
- * Validate a intf_A bar value.
- *
- * @return true on success, false on error.
- * @ref intf_A_bar
- */
- static inline bool
- intf_A_bar_is_valid(uint32_t value, uint32_t version) {
- uint32_t valid = 0;
- if (version >= 1)
- valid |= INTF_A_BAR_FIRST;
- if (version >= 1)
- valid |= INTF_A_BAR_SECOND;
- if (version >= 2)
- valid |= INTF_A_BAR_THIRD;
- return (value & ~valid) == 0;
- }
- #endif /* INTF_A_BAR_ENUM_IS_VALID */
- /**
- * @ingroup iface_intf_A
- * @struct intf_A_interface
- */
- struct intf_A_interface {
- /**
- * @param interface name of the objects interface
- * @param version version of the objects interface
- */
- void (*rq1)(struct wl_client *client,
- struct wl_resource *resource,
- const char *interface, uint32_t version, uint32_t untyped_new);
- /**
- */
- void (*rq2)(struct wl_client *client,
- struct wl_resource *resource,
- uint32_t typed_new,
- const char *str,
- int32_t i,
- uint32_t u,
- wl_fixed_t f,
- int32_t fd,
- struct wl_resource *obj);
- /**
- */
- void (*destroy)(struct wl_client *client,
- struct wl_resource *resource);
- };
- #define INTF_A_HEY 0
- #define INTF_A_YO 1
- /**
- * @ingroup iface_intf_A
- */
- #define INTF_A_HEY_SINCE_VERSION 1
- /**
- * @ingroup iface_intf_A
- */
- #define INTF_A_YO_SINCE_VERSION 2
- /**
- * @ingroup iface_intf_A
- */
- #define INTF_A_RQ1_SINCE_VERSION 1
- /**
- * @ingroup iface_intf_A
- */
- #define INTF_A_RQ2_SINCE_VERSION 1
- /**
- * @ingroup iface_intf_A
- */
- #define INTF_A_DESTROY_SINCE_VERSION 1
- /**
- * @ingroup iface_intf_A
- * Sends an hey event to the client owning the resource.
- * @param resource_ The client's resource
- */
- static inline void
- intf_A_send_hey(struct wl_resource *resource_)
- {
- wl_resource_post_event(resource_, INTF_A_HEY);
- }
- /**
- * @ingroup iface_intf_A
- * Sends an yo event to the client owning the resource.
- * @param resource_ The client's resource
- */
- static inline void
- intf_A_send_yo(struct wl_resource *resource_)
- {
- wl_resource_post_event(resource_, INTF_A_YO);
- }
- #ifdef __cplusplus
- }
- #endif
- #endif
|