/* Generated by wayland-scanner 1.23.0 */ #ifndef TEXT_INPUT_UNSTABLE_V1_CLIENT_PROTOCOL_H #define TEXT_INPUT_UNSTABLE_V1_CLIENT_PROTOCOL_H #include <stdint.h> #include <stddef.h> #include "wayland-client.h" #ifdef __cplusplus extern "C" { #endif /** * @page page_text_input_unstable_v1 The text_input_unstable_v1 protocol * @section page_ifaces_text_input_unstable_v1 Interfaces * - @subpage page_iface_zwp_text_input_v1 - text input * - @subpage page_iface_zwp_text_input_manager_v1 - text input manager * @section page_copyright_text_input_unstable_v1 Copyright * <pre> * * Copyright © 2012, 2013 Intel Corporation * * 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_seat; struct wl_surface; struct zwp_text_input_manager_v1; struct zwp_text_input_v1; #ifndef ZWP_TEXT_INPUT_V1_INTERFACE #define ZWP_TEXT_INPUT_V1_INTERFACE /** * @page page_iface_zwp_text_input_v1 zwp_text_input_v1 * @section page_iface_zwp_text_input_v1_desc Description * * An object used for text input. Adds support for text input and input * methods to applications. A text_input object is created from a * wl_text_input_manager and corresponds typically to a text entry in an * application. * * Requests are used to activate/deactivate the text_input object and set * state information like surrounding and selected text or the content type. * The information about entered text is sent to the text_input object via * the pre-edit and commit events. Using this interface removes the need * for applications to directly process hardware key events and compose text * out of them. * * Text is generally UTF-8 encoded, indices and lengths are in bytes. * * Serials are used to synchronize the state between the text input and * an input method. New serials are sent by the text input in the * commit_state request and are used by the input method to indicate * the known text input state in events like preedit_string, commit_string, * and keysym. The text input can then ignore events from the input method * which are based on an outdated state (for example after a reset). * * Warning! The protocol described in this file is experimental and * backward incompatible changes may be made. Backward compatible changes * may be added together with the corresponding interface version bump. * Backward incompatible changes are done by bumping the version number in * the protocol and interface names and resetting the interface version. * Once the protocol is to be declared stable, the 'z' prefix and the * version number in the protocol and interface names are removed and the * interface version number is reset. * @section page_iface_zwp_text_input_v1_api API * See @ref iface_zwp_text_input_v1. */ /** * @defgroup iface_zwp_text_input_v1 The zwp_text_input_v1 interface * * An object used for text input. Adds support for text input and input * methods to applications. A text_input object is created from a * wl_text_input_manager and corresponds typically to a text entry in an * application. * * Requests are used to activate/deactivate the text_input object and set * state information like surrounding and selected text or the content type. * The information about entered text is sent to the text_input object via * the pre-edit and commit events. Using this interface removes the need * for applications to directly process hardware key events and compose text * out of them. * * Text is generally UTF-8 encoded, indices and lengths are in bytes. * * Serials are used to synchronize the state between the text input and * an input method. New serials are sent by the text input in the * commit_state request and are used by the input method to indicate * the known text input state in events like preedit_string, commit_string, * and keysym. The text input can then ignore events from the input method * which are based on an outdated state (for example after a reset). * * Warning! The protocol described in this file is experimental and * backward incompatible changes may be made. Backward compatible changes * may be added together with the corresponding interface version bump. * Backward incompatible changes are done by bumping the version number in * the protocol and interface names and resetting the interface version. * Once the protocol is to be declared stable, the 'z' prefix and the * version number in the protocol and interface names are removed and the * interface version number is reset. */ extern const struct wl_interface zwp_text_input_v1_interface; #endif #ifndef ZWP_TEXT_INPUT_MANAGER_V1_INTERFACE #define ZWP_TEXT_INPUT_MANAGER_V1_INTERFACE /** * @page page_iface_zwp_text_input_manager_v1 zwp_text_input_manager_v1 * @section page_iface_zwp_text_input_manager_v1_desc Description * * A factory for text_input objects. This object is a global singleton. * @section page_iface_zwp_text_input_manager_v1_api API * See @ref iface_zwp_text_input_manager_v1. */ /** * @defgroup iface_zwp_text_input_manager_v1 The zwp_text_input_manager_v1 interface * * A factory for text_input objects. This object is a global singleton. */ extern const struct wl_interface zwp_text_input_manager_v1_interface; #endif #ifndef ZWP_TEXT_INPUT_V1_CONTENT_HINT_ENUM #define ZWP_TEXT_INPUT_V1_CONTENT_HINT_ENUM /** * @ingroup iface_zwp_text_input_v1 * content hint * * Content hint is a bitmask to allow to modify the behavior of the text * input. */ enum zwp_text_input_v1_content_hint { … }; #endif /* ZWP_TEXT_INPUT_V1_CONTENT_HINT_ENUM */ #ifndef ZWP_TEXT_INPUT_V1_CONTENT_PURPOSE_ENUM #define ZWP_TEXT_INPUT_V1_CONTENT_PURPOSE_ENUM /** * @ingroup iface_zwp_text_input_v1 * content purpose * * The content purpose allows to specify the primary purpose of a text * input. * * This allows an input method to show special purpose input panels with * extra characters or to disallow some characters. */ enum zwp_text_input_v1_content_purpose { … }; #endif /* ZWP_TEXT_INPUT_V1_CONTENT_PURPOSE_ENUM */ #ifndef ZWP_TEXT_INPUT_V1_PREEDIT_STYLE_ENUM #define ZWP_TEXT_INPUT_V1_PREEDIT_STYLE_ENUM enum zwp_text_input_v1_preedit_style { … }; #endif /* ZWP_TEXT_INPUT_V1_PREEDIT_STYLE_ENUM */ #ifndef ZWP_TEXT_INPUT_V1_TEXT_DIRECTION_ENUM #define ZWP_TEXT_INPUT_V1_TEXT_DIRECTION_ENUM enum zwp_text_input_v1_text_direction { … }; #endif /* ZWP_TEXT_INPUT_V1_TEXT_DIRECTION_ENUM */ /** * @ingroup iface_zwp_text_input_v1 * @struct zwp_text_input_v1_listener */ struct zwp_text_input_v1_listener { … }; /** * @ingroup iface_zwp_text_input_v1 */ static inline int zwp_text_input_v1_add_listener(struct zwp_text_input_v1 *zwp_text_input_v1, const struct zwp_text_input_v1_listener *listener, void *data) { … } #define ZWP_TEXT_INPUT_V1_ACTIVATE … #define ZWP_TEXT_INPUT_V1_DEACTIVATE … #define ZWP_TEXT_INPUT_V1_SHOW_INPUT_PANEL … #define ZWP_TEXT_INPUT_V1_HIDE_INPUT_PANEL … #define ZWP_TEXT_INPUT_V1_RESET … #define ZWP_TEXT_INPUT_V1_SET_SURROUNDING_TEXT … #define ZWP_TEXT_INPUT_V1_SET_CONTENT_TYPE … #define ZWP_TEXT_INPUT_V1_SET_CURSOR_RECTANGLE … #define ZWP_TEXT_INPUT_V1_SET_PREFERRED_LANGUAGE … #define ZWP_TEXT_INPUT_V1_COMMIT_STATE … #define ZWP_TEXT_INPUT_V1_INVOKE_ACTION … /** * @ingroup iface_zwp_text_input_v1 */ #define ZWP_TEXT_INPUT_V1_ENTER_SINCE_VERSION … /** * @ingroup iface_zwp_text_input_v1 */ #define ZWP_TEXT_INPUT_V1_LEAVE_SINCE_VERSION … /** * @ingroup iface_zwp_text_input_v1 */ #define ZWP_TEXT_INPUT_V1_MODIFIERS_MAP_SINCE_VERSION … /** * @ingroup iface_zwp_text_input_v1 */ #define ZWP_TEXT_INPUT_V1_INPUT_PANEL_STATE_SINCE_VERSION … /** * @ingroup iface_zwp_text_input_v1 */ #define ZWP_TEXT_INPUT_V1_PREEDIT_STRING_SINCE_VERSION … /** * @ingroup iface_zwp_text_input_v1 */ #define ZWP_TEXT_INPUT_V1_PREEDIT_STYLING_SINCE_VERSION … /** * @ingroup iface_zwp_text_input_v1 */ #define ZWP_TEXT_INPUT_V1_PREEDIT_CURSOR_SINCE_VERSION … /** * @ingroup iface_zwp_text_input_v1 */ #define ZWP_TEXT_INPUT_V1_COMMIT_STRING_SINCE_VERSION … /** * @ingroup iface_zwp_text_input_v1 */ #define ZWP_TEXT_INPUT_V1_CURSOR_POSITION_SINCE_VERSION … /** * @ingroup iface_zwp_text_input_v1 */ #define ZWP_TEXT_INPUT_V1_DELETE_SURROUNDING_TEXT_SINCE_VERSION … /** * @ingroup iface_zwp_text_input_v1 */ #define ZWP_TEXT_INPUT_V1_KEYSYM_SINCE_VERSION … /** * @ingroup iface_zwp_text_input_v1 */ #define ZWP_TEXT_INPUT_V1_LANGUAGE_SINCE_VERSION … /** * @ingroup iface_zwp_text_input_v1 */ #define ZWP_TEXT_INPUT_V1_TEXT_DIRECTION_SINCE_VERSION … /** * @ingroup iface_zwp_text_input_v1 */ #define ZWP_TEXT_INPUT_V1_ACTIVATE_SINCE_VERSION … /** * @ingroup iface_zwp_text_input_v1 */ #define ZWP_TEXT_INPUT_V1_DEACTIVATE_SINCE_VERSION … /** * @ingroup iface_zwp_text_input_v1 */ #define ZWP_TEXT_INPUT_V1_SHOW_INPUT_PANEL_SINCE_VERSION … /** * @ingroup iface_zwp_text_input_v1 */ #define ZWP_TEXT_INPUT_V1_HIDE_INPUT_PANEL_SINCE_VERSION … /** * @ingroup iface_zwp_text_input_v1 */ #define ZWP_TEXT_INPUT_V1_RESET_SINCE_VERSION … /** * @ingroup iface_zwp_text_input_v1 */ #define ZWP_TEXT_INPUT_V1_SET_SURROUNDING_TEXT_SINCE_VERSION … /** * @ingroup iface_zwp_text_input_v1 */ #define ZWP_TEXT_INPUT_V1_SET_CONTENT_TYPE_SINCE_VERSION … /** * @ingroup iface_zwp_text_input_v1 */ #define ZWP_TEXT_INPUT_V1_SET_CURSOR_RECTANGLE_SINCE_VERSION … /** * @ingroup iface_zwp_text_input_v1 */ #define ZWP_TEXT_INPUT_V1_SET_PREFERRED_LANGUAGE_SINCE_VERSION … /** * @ingroup iface_zwp_text_input_v1 */ #define ZWP_TEXT_INPUT_V1_COMMIT_STATE_SINCE_VERSION … /** * @ingroup iface_zwp_text_input_v1 */ #define ZWP_TEXT_INPUT_V1_INVOKE_ACTION_SINCE_VERSION … /** @ingroup iface_zwp_text_input_v1 */ static inline void zwp_text_input_v1_set_user_data(struct zwp_text_input_v1 *zwp_text_input_v1, void *user_data) { … } /** @ingroup iface_zwp_text_input_v1 */ static inline void * zwp_text_input_v1_get_user_data(struct zwp_text_input_v1 *zwp_text_input_v1) { … } static inline uint32_t zwp_text_input_v1_get_version(struct zwp_text_input_v1 *zwp_text_input_v1) { … } /** @ingroup iface_zwp_text_input_v1 */ static inline void zwp_text_input_v1_destroy(struct zwp_text_input_v1 *zwp_text_input_v1) { … } /** * @ingroup iface_zwp_text_input_v1 * * Requests the text_input object to be activated (typically when the * text entry gets focus). * * The seat argument is a wl_seat which maintains the focus for this * activation. The surface argument is a wl_surface assigned to the * text_input object and tracked for focus lost. The enter event * is emitted on successful activation. */ static inline void zwp_text_input_v1_activate(struct zwp_text_input_v1 *zwp_text_input_v1, struct wl_seat *seat, struct wl_surface *surface) { … } /** * @ingroup iface_zwp_text_input_v1 * * Requests the text_input object to be deactivated (typically when the * text entry lost focus). The seat argument is a wl_seat which was used * for activation. */ static inline void zwp_text_input_v1_deactivate(struct zwp_text_input_v1 *zwp_text_input_v1, struct wl_seat *seat) { … } /** * @ingroup iface_zwp_text_input_v1 * * Requests input panels (virtual keyboard) to show. */ static inline void zwp_text_input_v1_show_input_panel(struct zwp_text_input_v1 *zwp_text_input_v1) { … } /** * @ingroup iface_zwp_text_input_v1 * * Requests input panels (virtual keyboard) to hide. */ static inline void zwp_text_input_v1_hide_input_panel(struct zwp_text_input_v1 *zwp_text_input_v1) { … } /** * @ingroup iface_zwp_text_input_v1 * * Should be called by an editor widget when the input state should be * reset, for example after the text was changed outside of the normal * input method flow. */ static inline void zwp_text_input_v1_reset(struct zwp_text_input_v1 *zwp_text_input_v1) { … } /** * @ingroup iface_zwp_text_input_v1 * * Sets the plain surrounding text around the input position. Text is * UTF-8 encoded. Cursor is the byte offset within the * surrounding text. Anchor is the byte offset of the * selection anchor within the surrounding text. If there is no selected * text anchor, then it is the same as cursor. */ static inline void zwp_text_input_v1_set_surrounding_text(struct zwp_text_input_v1 *zwp_text_input_v1, const char *text, uint32_t cursor, uint32_t anchor) { … } /** * @ingroup iface_zwp_text_input_v1 * * Sets the content purpose and content hint. While the purpose is the * basic purpose of an input field, the hint flags allow to modify some * of the behavior. * * When no content type is explicitly set, a normal content purpose with * default hints (auto completion, auto correction, auto capitalization) * should be assumed. */ static inline void zwp_text_input_v1_set_content_type(struct zwp_text_input_v1 *zwp_text_input_v1, uint32_t hint, uint32_t purpose) { … } /** * @ingroup iface_zwp_text_input_v1 */ static inline void zwp_text_input_v1_set_cursor_rectangle(struct zwp_text_input_v1 *zwp_text_input_v1, int32_t x, int32_t y, int32_t width, int32_t height) { … } /** * @ingroup iface_zwp_text_input_v1 * * Sets a specific language. This allows for example a virtual keyboard to * show a language specific layout. The "language" argument is an RFC-3066 * format language tag. * * It could be used for example in a word processor to indicate the * language of the currently edited document or in an instant message * application which tracks languages of contacts. */ static inline void zwp_text_input_v1_set_preferred_language(struct zwp_text_input_v1 *zwp_text_input_v1, const char *language) { … } /** * @ingroup iface_zwp_text_input_v1 */ static inline void zwp_text_input_v1_commit_state(struct zwp_text_input_v1 *zwp_text_input_v1, uint32_t serial) { … } /** * @ingroup iface_zwp_text_input_v1 */ static inline void zwp_text_input_v1_invoke_action(struct zwp_text_input_v1 *zwp_text_input_v1, uint32_t button, uint32_t index) { … } #define ZWP_TEXT_INPUT_MANAGER_V1_CREATE_TEXT_INPUT … /** * @ingroup iface_zwp_text_input_manager_v1 */ #define ZWP_TEXT_INPUT_MANAGER_V1_CREATE_TEXT_INPUT_SINCE_VERSION … /** @ingroup iface_zwp_text_input_manager_v1 */ static inline void zwp_text_input_manager_v1_set_user_data(struct zwp_text_input_manager_v1 *zwp_text_input_manager_v1, void *user_data) { … } /** @ingroup iface_zwp_text_input_manager_v1 */ static inline void * zwp_text_input_manager_v1_get_user_data(struct zwp_text_input_manager_v1 *zwp_text_input_manager_v1) { … } static inline uint32_t zwp_text_input_manager_v1_get_version(struct zwp_text_input_manager_v1 *zwp_text_input_manager_v1) { … } /** @ingroup iface_zwp_text_input_manager_v1 */ static inline void zwp_text_input_manager_v1_destroy(struct zwp_text_input_manager_v1 *zwp_text_input_manager_v1) { … } /** * @ingroup iface_zwp_text_input_manager_v1 * * Creates a new text_input object. */ static inline struct zwp_text_input_v1 * zwp_text_input_manager_v1_create_text_input(struct zwp_text_input_manager_v1 *zwp_text_input_manager_v1) { … } #ifdef __cplusplus } #endif #endif