summaryrefslogtreecommitdiff
path: root/protocol
AgeCommit message (Collapse)AuthorFilesLines
2013-08-30protocol: Add release requests for wl_pointer, wl_keyboard, and wl_touchKristian Høgsberg1-4/+16
We missed destroy requests in the 1.0 protocol and since the scanner generates local-only *_destroy requests in that case we can't add destroy requests without breaking protocol. A client needs to verify that the server provides a version 3 seat to use the protocol destructor so the name needs to be something else than wl_*_destroy. v2 (Rob Bradford): Rebased, bumped the protocol versions and added since attributes to the requests.
2013-08-12protocol: Improve a bit of grammar for wl_surface::attach descriptionBryce W. Harrington1-2/+2
Signed-off-by: Bryce Harrington <b.harrington@samsung.com>
2013-08-08protocol: Fix pluralization of user in popup_done descriptionBryce W. Harrington1-1/+1
Signed-off-by: Bryce Harrington <b.harrington@samsung.com>
2013-08-08protocol: Improve grammar for set class descriptionBryce W. Harrington1-3/+3
Signed-off-by: Bryce Harrington <b.harrington@samsung.com>
2013-08-08protocol: Add missing d to 'x an y'Bryce W. Harrington1-2/+2
Signed-off-by: Bryce Harrington <b.harrington@samsung.com>
2013-08-08protocol: Fix typo by removing a redundant 'a'Bryce W. Harrington1-1/+1
Signed-off-by: Bryce Harrington <b.harrington@samsung.com>
2013-07-29protocol: Copy missing pixel formats from wl_drm to wl_shmTomeu Vizoso1-1/+64
2013-06-28protocol: add no_keymap format to keymap formatsRob Bradford1-0/+2
This format is used to specify that the key button events received are not in relation to any key map and that the codes should be interpreted directly. v2: Use zero for the no keymap enum value and enhance the documentation for the enum entry.
2013-06-14protocol: Add missing since attribute for name event on wl_seatRob Bradford1-1/+1
This event was added in version 2 of the protocol.
2013-06-05protocol: Move new name event below existing requests and events and version itKristian Høgsberg1-9/+12
Missed v2 of Robs patch that already did this based on feedback from Ander and Daniel.
2013-06-05protocol: Add a name event to give seat nameRob Bradford1-1/+10
This provides the ability for a client to differentiate events from different seats in a multiple seat environment.
2013-05-28protocol: Modes are specified in HW pixelsAlexander Larsson1-9/+21
Modes are mainly meant to be used in coordination with fullscreen in DRIVER mode, by e.g. games. For such games what they generally want is to match some hardware mode and resize their window for that. We don't really need to complicate this with the scaling. So, we keep the resolutions in HW pixels, and drop the SCALED flag (as it is now useless). This lets you just create e.g an 800x600 buffer of scale 1 and fullscreen that, ignoring the output scaling factor (although you can of course also respect it and create a 400x300 surface at scale 2). Conceptually the mode change is treated like a scaling which overrides the normal output scale. The only complexity is the FILL mode where it can happen that the user specifies a buffer of the same size as the screen, but the output has scale 2 and the buffer scale 1. Just scanning out this buffer will work, but effectively this is a downscaling operation, as the "real" size of the surface in pels is twice the size of the output. We solve this by allowing FILL to downscale (but still not upscale).
2013-05-28protocol: Use signed int for scale valuesAlexander Larsson1-2/+2
We usually use signed ints for things like this, to avoid issues C sign coersion.
2013-05-22protocol: Support scaled outputs and surfacesAlexander Larsson1-14/+93
This adds the wl_surface.set_buffer_scale request, and a wl_output.scale event. These together lets us support automatic upscaling of "old" clients on very high resolution monitors, while allowing "new" clients to take advantage of this to render at the higher resolution when the surface is displayed on the scaled output. It is similar to set_buffer_transform in that the buffer is stored in a transformed pixels (in this case scaled). This means that if an output is scaled we can directly use the pre-scaled buffer with additional data, rather than having to scale it. Additionally this adds a "scaled" flag to the wl_output.mode flags so that clients know which resolutions are native and which are scaled. Also, in places where the documentation was previously not clear as to what coordinate system was used this was fleshed out. It also adds a scaling_factor event to wl_output that specifies the scaling of an output. This is meant to be used for outputs with a very high DPI to tell the client that this particular output has subpixel precision. Coordinates in other parts of the protocol, like input events, relative window positioning and output positioning are still in the compositor space rather than the scaled space. However, input has subpixel precision so you can still get input at full resolution. This setup means global properties like mouse acceleration/speed, pointer size, monitor geometry, etc can be specified in a "mostly similar" resolution even on a multimonitor setup where some monitors are low dpi and some are e.g. retina-class outputs.
2013-05-22protocol: Allow output changes to be treated atomicallyAlexander Larsson1-1/+11
This add a wl_output.done event which is send after every group of events caused by some property change. This allows clients to treat changes touching multiple events in an atomic fashion.
2013-04-18protocol: revert hotspot_x/y in set_cursor back to int1.1Peter Hutterer1-2/+2
copy/paste error introduced in 9c0357af6ee42c318ce37b458ae7bdb7d51316cb Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2013-04-18protocol: Make it clear that returned "one-shot" objects are destroyedRob Bradford1-0/+8
The objects returned by the frame and sync request are destroyed by the compositor after the "done" event on the wl_callback interface is fired.
2013-04-04protocol: input documentation fixesPeter Hutterer1-4/+4
Fix summary for wl_touch::motion, extend summary for wl_touch::down to match up/motion a bit better. Fix a typo in wl_touch, and claim that it's zero or more update events, not one or more. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2013-04-03protocol: fix two protocol description 'typos'Peter Hutterer1-4/+4
Remove "mice, for example", it's described in the wl_pointer interface in detail. And remove space before the full stop. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2013-04-03protocol: document wl_pointer, wl_keyboard, wl_touchPeter Hutterer1-21/+27
Most of this should be clear, but let's spell a few things out. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2013-04-03protocol: use "summary", not "description" for xkb_v1 formatPeter Hutterer1-1/+1
Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2013-04-01docs: Document granularity of timestampsMatthias Clasen1-8/+12
This information is necessary to make any use of these fields.
2013-04-01docs: Remove mention of touch focusfd-lockKristian Høgsberg1-2/+1
There is no focused surface for a touch screen.
2013-04-01docs: Improve wl_region protocol docsMatthias Clasen1-4/+7
Just cosmetic changes, a few missing periods, and ID was not capitalized.
2013-04-01docs: Improve the wl_output protocol docsMatthias Clasen1-6/+18
Some descriptions were missing.
2013-04-01docs: Improve wl_touch protocol docsMatthias Clasen1-9/+27
Some descriptions were missing here.
2013-04-01docs: Improve wl_keyboard protocol docsMatthias Clasen1-6/+19
Some descriptions were missing here.
2013-04-01docs: Improve wl_pointer protocol docsMatthias Clasen1-10/+33
Some descriptions were missing here.
2013-04-01docs: Improve the wl_seat protocol docsMatthias Clasen1-13/+22
Expand the main description and tell if requests don't have an effect.
2013-04-01docs: Improve wl_surface protocol docsMatthias Clasen1-54/+69
Use NULL consistently. And add some more information in a few places.
2013-04-01docs: Improve wl_shell/wl_shell_surface docsMatthias Clasen1-84/+149
Add missing summaries, expand descriptions.
2013-04-01docs: Improve the wl_data_* procol docsMatthias Clasen1-30/+65
Add a few missing summaries and descriptions, spell out file descriptor, use hyphens in drag-and-drop, don't use hyphens in 'mime type', and reword a few things.
2013-04-01docs: Improve wl_shm and wl_shm_pool protocol docsMatthias Clasen1-24/+49
Reword some paragraphs, and spell out 'file descriptor'.
2013-04-01docs: Improve wl_callback protocol docsMatthias Clasen1-1/+8
Add some information about wl_callback and its done event.
2013-04-01docs: Improve the wl_registry protocol docsMatthias Clasen1-18/+26
Reword a few things, and add some details.
2013-04-01docs: Improve wl_display protocol docsMatthias Clasen1-8/+9
This adds a bit of information about in-order event delivery, removes extraneous formatting, and adds a missing period.
2013-03-19protocol: remove implicit attach semanticsPekka Paalanen1-11/+8
To match the Weston commit e7144fd175d1d68b91aa0cec7ab63381b79385a9: Author: Kristian Høgsberg <krh@bitplanet.net> Date: Mon Mar 4 12:11:41 2013 -0500 compositor: Only send release event in response to wl_surface.attach Remove the implicit attach semantics from wl_surface.commit and .attach. Before, if you did this on a wl_surface: attach, commit, commit, you would receive wl_buffer.release for both commits. After this change, you will only receive wl_buffer.release for the first commit. To get a second release, the same buffer must be attached again. There is no need for the implicit attach on the second commit. If the compositor needs the wl_buffer for repainting, it will not release it to begin with. If the compositor does not need to keep the wl_buffer around for repainting, it will not need it for a new commit either. Signed-off-by: Pekka Paalanen <ppaalanen@gmail.com>
2012-11-27protocol: Add a wl_surface request for setting buffer transformationAnder Conselvan de Oliveira1-3/+31
This request allows a client to render its contents according to the output transform, enabling the compositor to use optimizations such as overlays, hardware cursors, scan out of a client buffer for fullscreen surface, etc, even if the output is rotated.
2012-11-23doc: Fix typosTiago Vignatti1-1/+1
Signed-off-by: Tiago Vignatti <tiago.vignatti@intel.com>
2012-11-19Fix distcheck by adding back protocol/Makefile.amKristian Høgsberg1-0/+1
5909dddc78573774bd3a93c280831a7d18d82994 removed protocol/Makefile.am which meant protocol/wayland.xml no longer got included in the tarball. Add back protocol/Makefile.am and configure.ac bits and add protocol to subdirs in Makefile.am to fix this.
2012-11-19protocol: Fix copy and paste summaryKristian Høgsberg1-1/+1
2012-11-19protocol: Add summary description for wl_data_device_managerKristian Høgsberg1-0/+8
2012-11-12doc: Remove unused css and xslt for the protocolTiago Vignatti3-254/+0
This was added previously (commit 015c42e1) when we didn't have docbook formatted documentation. Now it became quite useless. Signed-off-by: Tiago Vignatti <tiago.vignatti@intel.com>
2012-10-21wayland: Add protocol documentation for various interfacesKristian Høgsberg1-13/+94
2012-10-16protocol: try to clarify wl_buffer docPekka Paalanen1-15/+13
Fix few typos in wl_buffer description. Mention backing storage in wl_buffer.destroy. Try to clarify the wl_buffer.release semantics by not explaining what *might* happen. It is important to not suggest, that if release does not come before frame callback, it will not come before attaching a new buffer to the surface. We want to allow the following scenario: The compositor is able to texture from wl_buffers directly, but it also keeps a copy of the surface contents. The copy is updated when the compositor is idle, to avoid the performance hit on wl_surface.attach/commit. When the copy completes some time later, the server sends the release event. If the client has not yet allocated a second buffer (e.g. it updates rarely), it can reuse the old buffer. Reported-by: John Kåre Alsaker <john.kare.alsaker@gmail.com> Signed-off-by: Pekka Paalanen <ppaalanen@gmail.com>
2012-10-16protocol: say update instead of repaintPekka Paalanen1-2/+2
wl_surface.commit itself does not force any repainting unless there is damage, so change the wording to not imply repainting. Reported-by: John Kåre Alsaker <john.kare.alsaker@gmail.com> Signed-off-by: Pekka Paalanen <ppaalanen@gmail.com>
2012-10-16protocol: Clarify pointer axis eventJonas Ådahl1-4/+16
Pointer axis events are in the same coordinate space as motion events. Signed-off-by: Jonas Ådahl <jadahl@gmail.com>
2012-10-15protocol: Clarify pointer axis eventJonas Ådahl1-1/+4
Pointer axis events are in the same coordinate space as motion events. Signed-off-by: Jonas Ådahl <jadahl@gmail.com>
2012-10-11protocol: clarify multiple wl_surface.attachPekka Paalanen1-1/+3
Explicitly say what happens with the wl_buffer.release event, if you attach several wl_buffers without a commit in between. Reported-by: David Herrmann <dh.herrmann@googlemail.com> Signed-off-by: Pekka Paalanen <ppaalanen@gmail.com>
2012-10-11protocol: fix clarification of input region on drags and pointersPekka Paalanen1-7/+11
The previous clarification did not follow the current implementation in Weston, where when a surface stops being a cursor or an icon, it becomes a plain unmapped surface again. Rewrite the related paragraphs, and fix some typos while at it. For start drag, make it explicit of which surface argument we are talking about. v2: Make the input region undefined when the use ends. Most likely no-one will re-use these surfaces for anything else than the same use case, so leave some slack for the implementations to avoid useless work on resetting the regions. Reported-by: Ander Conselvan de Oliveira <conselvan2@gmail.com> Signed-off-by: Pekka Paalanen <ppaalanen@gmail.com>