CVS: rdesktop/doc seamlessrdp-channel.txt,1.3,1.4

Pierre Ossman <[email protected]> Mon, 18 Jun 2007 05:00:38 -0700
Newsgroups gmane.network.rdesktop.cvs
Message-ID <[email protected]>
Update of /cvsroot/rdesktop/rdesktop/doc
In directory sc8-pr-cvs9.sourceforge.net:/tmp/cvs-serv29820/doc

Modified Files:
	seamlessrdp-channel.txt 
Log Message:
Implement support for icons in SeamlessRDP.


Index: seamlessrdp-channel.txt
===================================================================
RCS file: /cvsroot/rdesktop/rdesktop/doc/seamlessrdp-channel.txt,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -d -r1.3 -r1.4
*** seamlessrdp-channel.txt	28 Apr 2006 07:55:36 -0000	1.3
--- seamlessrdp-channel.txt	18 Jun 2007 12:00:34 -0000	1.4
***************
*** 6,11 ****
  * Commands for changing z order and focus.
  
- * Command for transferring icon.
- 
  * Think about protocol version management
  
--- 6,9 ----
***************
*** 238,241 ****
--- 236,282 ----
  it can send a SYNC to re-enumerate them.
  
+ SETICON
+ -------
+ 
+ Sets an icon for a window.
+ 
+ Syntax:
+ 	SETICON,<SERIAL>,<ID>,<CHUNK>,<FORMAT>,<WIDTH>,<HEIGHT>,<DATA>
+ 
+ This message is sent when a window is initially created and at any time when
+ the application modifies its icon.
+ 
+ A window can have multiple icons, but only one of a given format and size. A
+ SETICON received for an already existing format and size is expected to over-
+ write that icon.
+ 
+ Since icons can potentially be very large, it can easily overflow the line
+ limitation in the protocol. To handle this, multiple SETICON will be issued
+ with an ever increasing chunk number.
+ 
+ The initial chunk is 0 (zero) and all chunks must be sent in order. Multiple
+ SETICON sets for the same window may not interleave. SETICON sets for
+ different windows may interleave though.
+ 
+ Formats:
+   RGBA : Four bytes of data per pixel, representing red, green, blue and
+          alpha, in that order.
+ 
+ Data is the raw icon data written in hex (e.g. 3fab32...). Chunks must be
+ divided on a whole byte boundary. Case is not specified.
+ 
+ DELICON
+ -------
+ 
+ Removes an icon for a window.
+ 
+ Syntax:
+ 	DELICON,<SERIAL>,<ID>,<FORMAT>,<WIDTH>,<HEIGHT>
+ 
+ Removes the icon of a window matching the given format and size, previously
+ set with SETICON.
+ 
+ This command may not be interleaved with a SETICON set.
+ 
  Client to Server Operations
  ===========================


-------------------------------------------------------------------------
This SF.net email is sponsored by DB2 Express
Download DB2 Express C - the FREE version of DB2 express and take
control of your XML. No limits. Just data. Click to get it now.
http://sourceforge.net/powerbar/db2/