| <?xml version="1.0" encoding="UTF-8"?> |
| <protocol name="input_method"> |
| <copyright> |
| Copyright © 2012 Intel Corporation |
| |
| Permission to use, copy, modify, distribute, and sell this |
| software and its documentation for any purpose is hereby granted |
| without fee, provided that the above copyright notice appear in |
| all copies and that both that copyright notice and this permission |
| notice appear in supporting documentation, and that the name of |
| the copyright holders not be used in advertising or publicity |
| pertaining to distribution of the software without specific, |
| written prior permission. The copyright holders make no |
| representations about the suitability of this software for any |
| purpose. It is provided "as is" without express or implied |
| warranty. |
| |
| THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS |
| SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND |
| FITNESS, IN NO EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY |
| SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES |
| WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN |
| AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, |
| ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF |
| THIS SOFTWARE. |
| </copyright> |
| |
| |
| <interface name="input_method_context" version="1"> |
| <description summary="input method context"> |
| Corresponds to a text model on input method side. An input method context |
| is created on text mode activation on the input method side. It allows to |
| receive information about the text model from the application via events. |
| Input method contexts do not keep state after deactivation and should be |
| destroyed after deactivation is handled. |
| </description> |
| <request name="destroy" type="destructor"/> |
| <request name="commit_string"> |
| <description summary="commit string"> |
| Send the commit string text to the applications text model. |
| </description> |
| <arg name="serial" type="uint"/> |
| <arg name="text" type="string"/> |
| </request> |
| <request name="preedit_string"> |
| <description summary="pre-edit string"> |
| Send the pre-edit string text to the applications text model. |
| </description> |
| <arg name="serial" type="uint"/> |
| <arg name="text" type="string"/> |
| <arg name="commit" type="string"/> |
| </request> |
| <request name="preedit_styling"> |
| <arg name="serial" type="uint"/> |
| <arg name="index" type="uint"/> |
| <arg name="length" type="uint"/> |
| <arg name="style" type="uint"/> |
| </request> |
| <request name="preedit_cursor"> |
| <description summary="pre-edit cursor"> |
| Sets the cursor position inside the composing text (as byte index) |
| relative to the start of the composing text. |
| </description> |
| <arg name="serial" type="uint"/> |
| <arg name="index" type="int"/> |
| </request> |
| <request name="delete_surrounding_text"> |
| <arg name="serial" type="uint"/> |
| <arg name="index" type="int"/> |
| <arg name="length" type="uint"/> |
| </request> |
| <request name="cursor_position"> |
| <arg name="serial" type="uint"/> |
| <arg name="index" type="int"/> |
| <arg name="anchor" type="int"/> |
| </request> |
| <request name="modifiers_map"> |
| <arg name="map" type="array"/> |
| </request> |
| <request name="keysym"> |
| <description summary="keysym"> |
| Notify when a key event was sent. Key events should not be used |
| for normal text input operations, which should be done with |
| commit_string, delete_surrounfing_text, etc. The key event follows |
| the wl_keyboard key event convention. State is a XKB keysym, state a |
| wl_keyboard key_state. |
| </description> |
| <arg name="serial" type="uint"/> |
| <arg name="time" type="uint"/> |
| <arg name="sym" type="uint"/> |
| <arg name="state" type="uint"/> |
| <arg name="modifiers" type="uint"/> |
| </request> |
| <request name="grab_keyboard"> |
| <description summary="grab hardware keyboard"> |
| Allows an input method to receive hardware keyboard input and process |
| key events to generate text events (with pre-edit) over the. This allows |
| input methods which compose multiple key events for inputting text |
| like it is done for CJK languages. |
| </description> |
| <arg name="keyboard" type="new_id" interface="wl_keyboard"/> |
| </request> |
| <request name="key"> |
| <arg name="serial" type="uint"/> |
| <arg name="time" type="uint"/> |
| <arg name="key" type="uint"/> |
| <arg name="state" type="uint"/> |
| </request> |
| <request name="modifiers"> |
| <arg name="serial" type="uint"/> |
| <arg name="mods_depressed" type="uint"/> |
| <arg name="mods_latched" type="uint"/> |
| <arg name="mods_locked" type="uint"/> |
| <arg name="group" type="uint"/> |
| </request> |
| <event name="surrounding_text"> |
| <description summary="surrounding text event"> |
| The plain surrounding text around the input position. Cursor is the |
| position within the surrounding text. Anchor is the position of the |
| selection anchor within the surrounding text. If there is no selected |
| text anchor is the same as cursor. |
| </description> |
| <arg name="text" type="string"/> |
| <arg name="cursor" type="uint"/> |
| <arg name="anchor" type="uint"/> |
| </event> |
| <event name="reset"> |
| <arg name="serial" type="uint"/> |
| </event> |
| <event name="content_type"> |
| <arg name="hint" type="uint"/> |
| <arg name="purpose" type="uint"/> |
| </event> |
| <event name="enter_key_type"> |
| <arg name="enter_key_type" type="uint"/> |
| </event> |
| <event name="invoke_action"> |
| <arg name="button" type="uint"/> |
| <arg name="index" type="uint"/> |
| </event> |
| <event name="commit"/> |
| <event name="max_text_length"> |
| <arg name="length" type="uint"/> |
| </event> |
| <event name="platform_data"> |
| <arg name="text" type="string"/> |
| </event> |
| </interface> |
| |
| <interface name="input_method" version="1"> |
| <description summary="input method"> |
| An input method object is responsible to compose text in response to |
| input from hardware or virtual keyboards. There is one input method |
| object per seat. On activate there is a new input method context object |
| created which allows the input method to communicate with the text model. |
| </description> |
| <event name="activate"> |
| <description summary="activate event"> |
| A text model was activated. Creates an input method context object |
| which allows communication with the text model. |
| </description> |
| <arg name="id" type="new_id" interface="input_method_context"/> |
| <arg name="serial" type="uint"/> |
| </event> |
| <event name="deactivate"> |
| <description summary="activate event"> |
| The text model corresponding to the context argument was deactivated. |
| The input method context should be destroyed after deactivation is |
| handled. |
| </description> |
| <arg name="context" type="object" interface="input_method_context"/> |
| </event> |
| </interface> |
| |
| <interface name="input_panel" version="1"> |
| <description summary="interface for implementing keyboards"> |
| Only one client can bind this interface at a time. |
| </description> |
| |
| <request name="get_input_panel_surface"> |
| <arg name="id" type="new_id" interface="input_panel_surface"/> |
| <arg name="surface" type="object" interface="wl_surface"/> |
| </request> |
| </interface> |
| |
| <interface name="input_panel_surface" version="1"> |
| <enum name="position"> |
| <entry name="center_bottom" value="0"/> |
| </enum> |
| |
| <request name="set_toplevel"> |
| <description summary="set the surface type as a keyboard"> |
| A keybaord surface is only shown, when a text model is active |
| </description> |
| <arg name="position" type="uint"/> |
| </request> |
| </interface> |
| </protocol> |