From 35792cab1a4a6c414127867f86f4b19cfec20385 Mon Sep 17 00:00:00 2001 From: Pier Luigi Fiorini Date: Sun, 11 Jan 2015 11:14:58 +0100 Subject: Update wayland.xml to 1.6 Change-Id: I89b1dd4f6b6f03f54a9126dd5f67b0cdc9a006ad Reviewed-by: Johan Helsing Reviewed-by: Giulio Camuffo --- src/3rdparty/protocol/wayland.xml | 124 +++++++++++++++++++++++++++++--------- 1 file changed, 96 insertions(+), 28 deletions(-) diff --git a/src/3rdparty/protocol/wayland.xml b/src/3rdparty/protocol/wayland.xml index bf6acd1d0..bb457bcf7 100644 --- a/src/3rdparty/protocol/wayland.xml +++ b/src/3rdparty/protocol/wayland.xml @@ -246,7 +246,8 @@ This request will cause the server to remap the backing memory for the pool from the file descriptor passed when the pool was - created, but using the new size. + created, but using the new size. This request can only be + used to make the pool bigger. @@ -549,8 +550,8 @@ The current and pending input regions of the icon wl_surface are cleared, and wl_surface.set_input_region is ignored until the wl_surface is no longer used as the icon surface. When the use - as an icon ends, the the current and pending input regions - become undefined, and the wl_surface is unmapped. + as an icon ends, the current and pending input regions become + undefined, and the wl_surface is unmapped. @@ -976,6 +977,14 @@ cursor images for pointers, drag icons, etc. + + + These errors can be emitted in response to wl_surface requests. + + + + + Deletes the surface and invalidates its object ID. @@ -1059,28 +1068,39 @@ - - Request notification when the next frame is displayed. Useful - for throttling redrawing operations, and driving animations. + + Request a notification when it is a good time start drawing a new + frame, by creating a frame callback. This is useful for throttling + redrawing operations, and driving animations. + + When a client is animating on a wl_surface, it can use the 'frame' + request to get notified when it is a good time to draw and commit the + next frame of animation. If the client commits an update earlier than + that, it is likely that some updates will not make it to the display, + and the client is wasting resources by drawing too often. + The frame request will take effect on the next wl_surface.commit. The notification will only be posted for one frame unless - requested again. + requested again. For a wl_surface, the notifications are posted in + the order the frame requests were committed. + + The server must send the notifications so that a client + will not send excessive updates, while still allowing + the highest possible update rate for clients that wait for the reply + before drawing again. The server should give some time for the client + to draw and commit after sending the frame callback events to let them + hit the next output refresh. A server should avoid signalling the frame callbacks if the surface is not visible in any way, e.g. the surface is off-screen, or completely obscured by other opaque surfaces. - A client can request a frame callback even without an attach, - damage, or any other state changes. wl_surface.commit triggers a - display update, so the callback event will arrive after the next - output refresh where the surface is visible. - The object returned by this request will be destroyed by the compositor after the callback is fired and as such the client must not attempt to use it after that point. The callback_data passed in the callback is the current time, in - milliseconds. + milliseconds, with an undefined base. @@ -1201,6 +1221,11 @@ A newly created surface has its buffer transformation set to normal. + wl_surface.set_buffer_transform changes the pending buffer + transformation. wl_surface.commit copies the pending buffer + transformation to the current one. Otherwise, the pending and current + values are never changed. + The purpose of this request is to allow clients to render content according to the output transform, thus permiting the compositor to use certain optimizations even if the display is rotated. Using @@ -1212,6 +1237,10 @@ Note that if the transform value includes 90 or 270 degree rotation, the width of the buffer will become the surface height and the height of the buffer will become the surface width. + + If transform is not one of the values from the + wl_output.transform enum the invalid_transform protocol error + is raised. @@ -1227,6 +1256,10 @@ A newly created surface has its buffer scale set to 1. + wl_surface.set_buffer_scale changes the pending buffer scale. + wl_surface.commit copies the pending buffer scale to the current one. + Otherwise, the pending and current values are never changed. + The purpose of this request is to allow clients to supply higher resolution buffer data for use on high resolution outputs. Its intended that you pick the same buffer scale as the scale of the @@ -1236,12 +1269,15 @@ Note that if the scale is larger than 1, then you have to attach a buffer that is larger (by a factor of scale in each dimension) than the desired surface size. + + If scale is not positive the invalid_scale protocol error is + raised. - + A seat is a group of keyboards, pointer and touch devices. This object is published as a global during start up, or when such a @@ -1363,10 +1399,6 @@ - - - - Notification that this seat's pointer is focused on a certain @@ -1464,18 +1496,21 @@ + + + + + + + - + The wl_keyboard interface represents one or more keyboards associated with a seat. - - - - This specifies the format of the keymap provided to the @@ -1483,7 +1518,8 @@ - + @@ -1551,6 +1587,36 @@ + + + + + + + + + + + + Informs the client about the keyboard's repeat rate and delay. + + This event is sent as soon as the wl_keyboard object has been created, + and is guaranteed to be received by the client before any key press + event. + + Negative values for either rate or delay are illegal. A rate of zero + will disable any repeating (regardless of the value of delay). + + This event can be sent later on as well with a new value if necessary, + so clients should continue listening for the event past the creation + of wl_keyboard. + + + + + @@ -1565,10 +1631,6 @@ contact point can be identified by the ID of the sequence. - - - - A new touch point has appeared on the surface. This touch point is @@ -1621,6 +1683,12 @@ this surface may re-use the touch point ID. + + + + + + -- cgit v1.2.3