fdo-mirrors/wayland-protocols
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/wayland/wayland-protocols.git synced 2026-05-09 04:48:02 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

text-input: Reword and clarify cursor syncing

Browse source 
This change makes it clear that there's an extra buffer for the value.
This explains the purpose of the complicated design.

Signed-off-by: Dorota Czaplejewicz
This commit is contained in:
dcz 2025-06-20 11:34:28 +00:00 • committed by Carlos Garnacho
parent ba4ea256d1
commit 0dd05d436f
1 changed files with 10 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

17
unstable/text-input/text-input-unstable-v3.xml
View file

@ -283,15 +283,18 @@
empty values get applied, subsequent attempts to change them may have
no effect.
As of version 2, the values sent with this request are not used
immediately after they are applied to the text-input state.
As of version 2, the zwp_text_input_v3.commit request does not apply
values sent with this request. Instead, it stores them in a separate
"committed" area. The committed values, if still valid, get applied on
the next wl_surface.commit request on the surface with text-input focus.
Both committed and applied values get invalidated on:
After the pending state is applied with the zwp_text_input_v3.commit
request, the following wl_surface.commit request on the surface with
text-input focus will cause the values to become active.
- the next committed enable or disable request, or
- a change of the focused surface of the text-input (leave or enter events).
If the surface with text-input focus changes before a wl_surface.commit
request is sent, the values are discarded.
This double stage application allows the compositor to position
the input method popup in the same frame as the contents
of the text on the surface are updated.
</description>
<arg name="x" type="int"/>
<arg name="y" type="int"/>