There are some corner cases in the framebuffer update system that need
to be explicitly mentioned.

Signed-off-by: Pierre Ossman <oss...@cendio.se>
---

Index: rfbproto.rst
===================================================================
--- rfbproto.rst        (revision 3809)
+++ rfbproto.rst        (working copy)
@@ -637,6 +637,12 @@
 2               ``U16``                         *height*
 =============== ==================== ========== =======================
 
+A request for an area that partly falls outside the current framebuffer
+must be cropped so that it fits within the framebuffer dimensions.
+
+Note that an empty area can still solicit a *FramebufferUpdate* even
+though that update will only contain pseudo-encodings.
+
 KeyEvent
 --------
 
@@ -1108,6 +1114,16 @@
 for the format of the data for each encoding and `Pseudo-encodings`_
 for the meaning of pseudo-encodings.
 
+Note that a framebuffer update marks a transition from one valid
+framebuffer state to another. That means that a single update handles
+all received *FramebufferUpdateRequest* up to the point where the
+update is sent out.
+
+However, because there is no strong connection between a
+*FramebufferUpdateRequest* and a subsequent *FramebufferUpdate*, a
+client that has more than one *FramebufferUpdateRequest* pending at any
+given time cannot be sure that it has received all framebuffer updates.
+
 SetColourMapEntries
 -------------------
 


-- 
Pierre Ossman            OpenSource-based Thin Client Technology
System Developer         Telephone: +46-13-21 46 00
Cendio AB                Web: http://www.cendio.com

Attachment: signature.asc
Description: PGP signature

------------------------------------------------------------------------------
The NEW KODAK i700 Series Scanners deliver under ANY circumstances! Your
production scanning environment may not be a perfect world - but thanks to
Kodak, there's a perfect scanner to get the job done! With the NEW KODAK i700
Series Scanner you'll get full speed at 300 dpi even with all image 
processing features enabled. http://p.sf.net/sfu/kodak-com
_______________________________________________
tigervnc-rfbproto mailing list
tigervnc-rfbproto@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/tigervnc-rfbproto

Reply via email to