[PATCH wayland 2/2] protocol: add wl_surface errors enum for bad scale and transform values

Jonny Lamb jonny.lamb at collabora.co.uk
Thu Nov 21 08:42:29 PST 2013

 protocol/wayland.xml | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/protocol/wayland.xml b/protocol/wayland.xml
index a9c8e53..07cd2b1 100644
--- a/protocol/wayland.xml
+++ b/protocol/wayland.xml
@@ -979,6 +979,14 @@
       cursor images for pointers, drag icons, etc.
+    <enum name="error">
+      <description summary="wl_surface error values">
+        These errors can be emitted in response to wl_surface requests.
+      </description>
+      <entry name="invalid_scale" value="0" summary="buffer scale value is invalid"/>
+      <entry name="invalid_transform" value="1" summary="buffer transform value is invalid"/>
+    </enum>
     <request name="destroy" type="destructor">
       <description summary="delete surface">
 	Deletes the surface and invalidates its object ID.
@@ -1212,6 +1220,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.
       <arg name="transform" type="int"/>
@@ -1236,6 +1248,9 @@
 	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.
       <arg name="scale" type="int"/>

More information about the wayland-devel mailing list