aboutsummaryrefslogtreecommitdiffstats
path: root/doc/rfbtight.tex
diff options
context:
space:
mode:
authorConstantin Kaplinsky <const@tightvnc.com>2007-05-05 01:57:04 +0000
committerConstantin Kaplinsky <const@tightvnc.com>2007-05-05 01:57:04 +0000
commitaa8904cfa4d4720878006abe413d2bbf7588d752 (patch)
tree1f6a054bcb9064bcdbdcf4cdd888b9ba0c16c7b8 /doc/rfbtight.tex
parentbfd8ecddec2f0263140e07ae173a3857f7db0e02 (diff)
downloadtigervnc-aa8904cfa4d4720878006abe413d2bbf7588d752.tar.gz
tigervnc-aa8904cfa4d4720878006abe413d2bbf7588d752.zip
LastRect pseudo-encoding documented.
git-svn-id: svn://svn.code.sf.net/p/tigervnc/code/trunk@2297 3789f03b-4d11-0410-bbf8-ca57d06f2519
Diffstat (limited to 'doc/rfbtight.tex')
-rw-r--r--doc/rfbtight.tex26
1 files changed, 26 insertions, 0 deletions
diff --git a/doc/rfbtight.tex b/doc/rfbtight.tex
index 8db1a0cc..ae8a9563 100644
--- a/doc/rfbtight.tex
+++ b/doc/rfbtight.tex
@@ -317,7 +317,33 @@ FIXME: Allow zero-size framebuffer?
\subsection{PointerPos}
\subsection{CompressLevel}
\subsection{QualityLevel}
+
\subsection{LastRect}
+\begin{verbatim}
+Encoding type: 0xFFFFFF20
+Name signature: "LASTRECT"
+Vendor signature: "TGHT"
+\end{verbatim}
+
+\typestr{LastRect} enables \typestr{FramebufferUpdate} messages that
+include less rectangles than was specified in the message header. For
+example, VNC server can send a big conter like 0xFFFF as
+\typestr{number-of-rectangles}, then arbitrary number of rectangles and
+pseudo-rectangles (less than 0xFFFF). Finally, it sends
+\typestr{LastRect} pseudo-rectangle which marks the end of current
+\typestr{FramebufferUpdate} message.
+
+\typestr{LastRect} pseudo-encoding is special -- it does not include
+\typestr{x-position}, \typestr{y-position}, \typestr{width} and
+\typestr{height} fields, and is not followed by any other data as
+well. Only 4 bytes is sent in \typestr{LastRect}, while other
+encodings and pseudo-encodings normally send 12 bytes as a rectangle
+header.
+
+To enable this pseudo-encoding, the client specifies
+\typestr{LastRect} in the \typestr{SetEncodings} message. From that
+moment, the server may use \typestr{LastRect} pseudo-encoding in some
+of the framebuffer updates it will send.
% For each message, describe its place in the message sequence.