AmiVNC 1.0.0

Short:        Experimental VNC server for Amiga w/C source (RTG or not !)
Author:       stephane.guillard@steria.com (Stephane Guillard)
Uploader:     stephane guillard steria com (Stephane Guillard)
Type:         comm/tcp
Version:      1.0.0
Architecture: m68k-amigaos

About VNC
---------
VNC is a truly thin client protocol which enables the use of one computer
(the server) from another (the client), by :
- Enabling remote view of the server screen in a window on the client screen
- Enabling the use of the keyboard of the client in place of the keyboard of the server
- Enabling the use of the mouse of the client in place of the mouse of the server
More can be found in the provided HTML doc file.

About AmiVNC
------------
AmiVNC is an experimental VNC server for the Amiga.

This is the 8th public release of AmiVNC, bringing support for 256 color RTG screens.
Read the doc !

Requirements
------------
To run AmiVNC you need :
- any native planar Amiga screenmode (PAL, NTSC, AGA etc.)
  or 15, 16, 24 or 32 bit RTG mode (CGFX or Picasso96)
- a TCP-IP stack (AmiTCP or Miami(dx) or any bsdsocket.library compliant stack),
- enough free ram to hold a copy of the Workbench screen,
- a fast processor (a 060/50 will be perfect), otherwise the client screen update will be slow,
- a computer with a VNC Client (Mac, Unix or Linux box, PC, Amiga)

To build AmiVNC you need :
- StormC4/GCC

History / News
--------------
1.0.0
- Solved this looongstanding mouse scale bug which showed on wome configs.
  Thanks Denis Spach !
- Mouse support is now more system friendly thus compatible w/ MagicMenu etc.
- Code is 1/2 its previous size, faster and more stable (thanks StormC4)
- Added 68020 versions to the distribution

0.1.0
- Ported to and compiled w/ StormC4/GCC (smaller, faster).
- Added IntuitionBase locking (more stable).
- Reworked mouse event insertion (should remove mouse coord. errors).
- First PPC version (not distributed yet) : faster.
- Added DELAY parameter, to lower CPU needs.

0.0.15
- Added VVA support : BGR233 pixel encoding (enable this with VVA tooltype
  or -a on the command line). Reduces all screen modes to 256 colors, speeding things a bit.
- Palette refreshing bug fixes for palette screenmodes (planar and chunky).

0.0.14
- Bug fix : password setting with S: in an AFS or PFS filesystem did not work.
  Reason : AmiTCP net.lib (with which I link) strangely alters creat() behavior. Now using Open().
- Bug fix : when stopping AmiVNC with CTRL-C signal, memory was freed twice.
  Reason : I had not understood what CXBRK() is.

0.0.13
- Added support for 256 color RTG screen modes (at last !). Indeed, when
  I saw working 256 color planar modes I thought it would not be that hard
  to have 256 color chunky modes too ! Now, there should not be that many
  screen modes not supported.

0.0.12c
- Added a planar only version for users who don't have Picasso96 nor Cybergraphics
  at all. See in the "planar only" directory, and read the html doc !

0.0.12
- Added support for Amiga planar modes (YES, AT LAST !).
- Removed the StopAmiVNC tool. To properly stop AmiVNC,
  feed it with a BREAK C (only when it is waiting for incoming sessions).
  If you use Executive, you can use the nice MUI Commander for this purpose.
- Added icon Tooltypes to set parameters.
- Added user commands to be executed when client logs in or logs out.
- Added log to file, thus silent mode.
- A few bug fixes.
- Documentation update.

0.0.11
- Added the StopAmiVNC tool, to properly stop AmiVNC (only when it is waiting for
  incoming sessions).
- Enhanced keyboard support (supporting arrow keys, CONTROL, SHIFT, Lamiga = Lalt, Ramiga
  = Ralt etc.). Better, but still not perfect.
- Enhanced mouse support (handles ieQualifier). Better, but still not perfect : in YAM,
  you can drag your messages but when they come onto a drop area, they are unselected.
- Allows screen change IF new screen is the same RGB mode. I did not think it would be
  very useful, but indeed I use it ! Aborts connection when screen changes if new screen
  mode is different (as said somewhere above, the VNC clients abort when they receive a
  mServerInitMsg message in the middle of a session, and this message is necessary to
  change the resolution).
- More command line options :
    -e to force Big Endian flag
    -(r|g|b)<value> to force red | green | blue bit shift on color encoding, useful if you
     have color trouble. Legal values are 0, 8, 16, 24. Default is -r8 -g16 -b24.
    -l<size> to limit network packet size when sending initial screen update. Useful if you
     have too many network collisions. Default is no limit.
- Speed restored under Picasso96 with screen depth = 16 bit pixels. Still slower under
  CGFX or with screen depth > 2, because still using ReadPixelArray for compatibility,
  and sending 4 byte pixels. Will try to fix that.
- A few bug fixes.

0.0.10ra
- Deals with active screen, not necessarily Workbench (this does not mean you can open
  a screen in a session !).
- No longer a one shot daemon. You can re-connect. Stop with CTRL-C when the server is
  waiting for connections (if you break it at another state, you may loose memory).
- Corrected acquisition of raster pointer, which worked under Pic96 but not under CGFx.
  Thanks to Steffen Haeuser.
- Changed all color encoders to ARGB (32 bit on the wire), and ReadPixelArray(). This
  is slower, but works with all CGFx and Picasso96 screen modes with depth > 8. As 
  a side effect, AmiVNC is even smaller than before !
- This version is successfully running on my setup, with both AmiTCP, Genesis or
  Miami as a TCP stack, and Picasso96 or CFGx 4 as RTG system.

0.0.9 :
-  Fixed ObtainSocket() call, works now with Miami
-  Added 24 bit pixel support
-  Added Cybergraphics support
-  Added setting of listening port (5900 may also be used by other softwre)
-  Fixed documentation
-  Still much to be done

0.0.8mt :
-  Initial release on Aminet