home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / pmvnc100.zip / vncview_e.txt < prev    next >
Text File  |  1999-09-10  |  13KB  |  323 lines
  1.  
  2.                     VNC Viewer for OS/2 PM, Version 1.00
  3.             
  4.                         akira@sra.co.jp
  5.  
  6. _What is VNC ?
  7.  
  8.     VNC stands for Virtual Network Computing, developed by ORL.
  9.  
  10.         Jan. 1999, ORL has been acquired by AT&T to form AT&T
  11.         Laboratories Cambridge.
  12.  
  13.     See  VNC site <http://www.uk.research.att.com/vnc/> for details.
  14.  
  15. _VNC Viewer for OS/2 PM
  16.  
  17.     There are two VNC viewer's for OS/2, XFree86/2 version and Java
  18.     Version. X version requires X server, and Java version requires a
  19.     lot of memory (resource monitor says it eat up  over 10MB of memory).
  20.  
  21.     VNC viewer is orginally, thin client.  X/Java version is FAT
  22.     client for my environment. So I start porting VNC viewer for native
  23.     PM. It requires no additional programs (but  requires TCP /IP, of
  24.     course), and eat up less memory (so  start up faster).
  25.  
  26. _Setting up VNC Server
  27.  
  28.     You need to start VNC server before using VNC viewer.  There are VNC
  29.     servers for Unix, Win95/NT, Mac in VNC site.  See,
  30.     
  31.         <http://www.uk.research.att.com/vnc/>
  32.  
  33.     for setting servers (especially, see FAQ page if you have trouble).
  34.  
  35. _Start VNC Viewer
  36.  
  37.     Setting up VNC server is bit difficult, but viewer side is quite
  38.     easy.  You only to put executable 'vncview.exe' into a directory
  39.     in a PATH, and simply type command, or create program object and
  40.     double click it.
  41.  
  42.         This program was written for EMX/GCC.  You need EMX runtime 
  43.     (0.9c or later) to run this program.
  44.  
  45.     From command line, start VNC viewer with
  46.  
  47.         vncview [ <host:display> ] [ <option> ... ]
  48.  
  49.     Connecting server is specified with 'host:display' format, as
  50.  
  51.         snoopy:2
  52.  
  53.     'host:display' may be changed with 'session dialog' after program
  54.     startup.
  55.  
  56.         If you connecting to UNIX server, server report host and display
  57.         number on it startup.
  58.     If you connecting to Windows Server, display number is usually 0.
  59.  
  60.     There are following options.  Options are also changed with 'option
  61.     dialog' after program startup.
  62.  
  63.     Pixel Format
  64.     
  65.         -true       Request '32 bits True Color' to server.  Viewer hold
  66.                 display image with 24 bits true color.
  67.  
  68.     -bgr233     Request 'bgr233' 8 bits pixel format to server. 
  69.                     Viewer hold disoplay image with 8 bits bitmap.
  70.  
  71.     -tiny       Request 'bgr233' 8 bits pixel format to server.
  72.                     Viewer convert it to default 16 colors.
  73.  
  74.     -gray       Request 'bgr233' 8 bits pixel format to server.
  75.                     Viewer convert it to 4 level gray scales.
  76.  
  77.         Default is '-true' color. PM converts any bitmap to real display
  78.     depth.  So, you can use any pixel format without your local
  79.         display.  But each format have onw problems.
  80.     
  81.           o Server convert colors if you request 'BGR233' format.  If
  82.             you using graphic apllications requring exact colors, then
  83.         use True Color format.
  84.  
  85.           o True Color uses lot of (three times) network traffic than
  86.             BGR233.  If you using slow network, or slow server, then
  87.         try BGR233 format.
  88.  
  89.           o If you using PM with 256, or 16 colors, color conversion in
  90.             local PM side eat up lot of processor power.  In those case,
  91.         try '-tiny' option.  It convert BGR233 colors to default 16
  92.         colors.
  93.  
  94.           o '-tiny' reduces colors, but it sometimes cause trouble on
  95.         visual effects.  On those case, try 'gray' scaling.
  96.  
  97.     Encoding    
  98.     
  99.         -hextile    prefer Hextile encoding
  100.     -corre      prefer CoRRE encoding
  101.     -rre        prefer RRE encoding
  102.     -raw        prefer RAW encoding
  103.  
  104.         Default prefers 'Hextile' encoding.  But for current version,
  105.         rectangle fill (used by Hextile/RRE/CoRRE) is bit slow.  If you
  106.     think it slow, and using fast network, then try 'Raw' encoding.
  107.     
  108.     Off course, 'Raw' encoding performs no compression, so, it causes
  109.     tourble on slow network. 
  110.  
  111.             I noticed Java Version running on OS/2 also speed up on 'Raw'
  112.         encoding.
  113.  
  114.         'CopyRect' encoding is always effective in this version.
  115.  
  116.     Misc. options
  117.  
  118.     -shared     share disktop with another viewer
  119.  
  120.         -viewonly   disable mouse/key inputs
  121.             
  122.         -deiconify  request to restore on 'BELL' if iconified.
  123.  
  124.         -dialogAtCenter
  125.     -dialogAtMouse
  126.                 specify position of dialogs. With '-dialogAtCenter',
  127.             all dialogs are shown at center of screen. With 
  128.             '-dialogAtMouse', all dialogs are shown at near
  129.                     mouse pointer.  Default is near mouse position.
  130.  
  131.         -passwd passwd-file
  132.                 If you can access to server's passwd file, this
  133.                     option supress password dialog.  It is useful when
  134.                     using with Xvnc for OS/2.
  135.  
  136.         -keymap keymapfile
  137.                 With 'keymapfile', you can specify mappings between
  138.             PM's scan key code and VNC's key definition.  With
  139.                     this, you can distinguish right/left Shift/Control
  140.             keys usually not distinguished, or send NLS keys to
  141.             VNC server.
  142.             
  143.                 See 'Keymap File' section for more details.
  144.  
  145. _Session / Option Dialog
  146.  
  147.     VNC viewer shows 'session dialog' on its startup.
  148.     
  149.         +---+-----------------------------------------------------+
  150.         |   | PM VNC Viewer - connect to                          |
  151.         +---+-----------------------------------------------------+
  152.     | +-----+               +---------------+---+ +---------+ |
  153.         | | VNC |  VNC Server : |               | V | | Connect | |
  154.         | |     |               +---------------+---+ +---------+ |
  155.         | +-----+                                     +---------+ | 
  156.         |                         Use host:display    | Cancel  | |
  157.         |                                             +---------+ |
  158.         |                         e.g. snoopy:2       +---------+ |
  159.         |                                             |Options..| |
  160.         |                                             +---------+ |
  161.     +---------------------------------------------------------+
  162.  
  163.     Server name field shows server name (host:display) given in command
  164.     line.  If no server specified, then it shows last server name.
  165.     Server name field is pull down list, it holds servers previously
  166.     used.  You can select those servers from it.
  167.  
  168.     For confirm options, push 'Options' button, and invoke 'option
  169.     dialog'.
  170.  
  171.         +---------------------------------------------+
  172.     | Session Options for <snoopy:1>              |
  173.         +---------------------------------------------+
  174.         |                   +-------------------+---+ |
  175.         | Pixel Format      | True Color        | V | |
  176.         |                   +-------------------+---+ |
  177.         |                   +-------------------+---+ |
  178.         | Preferred Encoding| Hextile           | V | |
  179.         |                   +-------------------+---+ |
  180.         |                                 +---------+ |
  181.         |    o Request shared session     | Connect | |
  182.         |                                 +---------+ |
  183.         |    o View only                  +---------+ |
  184.         |                                 | Back    | |
  185.         |    o Deiconify on Bell          +---------+ |
  186.         +---------------------------------------------+
  187.     
  188.     If you specify some options on command line, those options are shown
  189.     in this dialog.  If you specified nothing, then, last setting for
  190.     selected server are shown.  Otherwise, default settings are used.
  191.  
  192.     Select server to connect, confirm options, and then push 'Connect'
  193.     button to start connection to VNC server.
  194.  
  195. _Authentication
  196.  
  197.     If specified VNC server exist and working, then server request user
  198.     authentication.
  199.  
  200.         +---+-----------------------------------------------------+
  201.         |   | PM VNC Viewer - authentication                      |
  202.         +---+-----------------------------------------------------+
  203.         |                                             +---------+ |
  204.         | +------+                  +---------------+ |    OK   | |
  205.         | | VNC  | Session password:|               | +---------+ |
  206.         | |      |                  +---------------+ +---------+ |
  207.         | +------+                                    | Cancel  | |
  208.         |                                             +---------+ |
  209.         +---------------------------------------------------------;
  210.  
  211.     Password is one you set in server side.  It is 'vncpasswd' for Xvnc,
  212.     or 'Property' for WinVNC.
  213.  
  214.     If you use '-passwd' option, this dialog is not appear.
  215.  
  216. _Remote Desktop
  217.  
  218.     If password was correct, then VNC session begin and viewer displays
  219.     remote desktop image.  
  220.     
  221.     If you once connected to given server, previous window's position
  222.     and size are used.  Connecting to new server, and remote  desktop 
  223.     is smaller than PM screen, then entire desktop will shown.  
  224.     Otherwise, part of remote desktop will shown.
  225.  
  226.     You can change local window size with dragging size border, but you
  227.     cannot enlarge local window larger than remote desktop.  If local
  228.     window is smaller than remote desktop, then scrool bar appears.
  229.     
  230.     When minimized, viewer not send request (FramebufferUpdateRequest)
  231.     to server.  You can reduce network traffic, server load by
  232.     minimizing viewer.
  233.  
  234. _Key and Mouse
  235.  
  236.     If local mouse is in local window, then mouse movements, button
  237.     clicks are send to remote desktop.  If local window get focus, then
  238.     also key events are send to remote desktop.
  239.  
  240.     But, this viewer does not change PM's standard hooks, and they are
  241.     all process in PM side.  For example,
  242.     
  243.         CTRL-ALT-DEL        Reboot OS/2
  244.         CTRL-ESC            Shows task list
  245.     ALT-TAB             Chnages local side focus
  246.     
  247.     If you want to use those hooked key combinations to remote machine,
  248.     use menu or keyboard accelerators.  All ALT key combinations are
  249.     processed locally, and never send to remote machine.
  250.     
  251. _Menu and Accelerator
  252.  
  253.     Menu Items                      Accelerator
  254.     -----------------------------+--------------
  255.     Connection options...           Alt-O
  256.     Connection info                 Alt-I
  257.     Request screen refresh          Alt-R
  258.     Copy                            Alt-Y       remote to local clipboard
  259.     Paste                           Alt-P       paste to remote desktop
  260.     Send Control Key
  261.             Ctrl Key Toggle         Alt-C
  262.         Ctrl Key Down
  263.         Ctrl Key Up
  264.     Send Alt Key
  265.             Alt Key Toggle          Alt-A
  266.             Alt Key Down
  267.         Alt Key Up
  268.     Send Function Key
  269.             F1 ... F12
  270.     Send C-A-D                      Alt-D
  271.     Send Ctrl-Esc                   Alt-E
  272.     Send Alt-Tab                    Alt-T
  273.     About VNC Viewer                Alt-B
  274.  
  275.     Ctl/Alt key status is shown in 'CTL' 'ALT' window in titlebar.  You
  276.     can toggle their state with clicking those windows, and also you can
  277.     use popup menu on those windows.
  278.  
  279. _Keymap File
  280.  
  281.     Keymap file defines mappings between PM's scan key code and VNC key
  282.     events send to VNC server.
  283.     
  284.     This viewer usually does not check scan key code (in WM_CHAR message).
  285.     Because, scan key code depend on your keyboard, and no generic way to
  286.     handle scan key codes.
  287.  
  288.     But for this, viewer does not distinguish left/right shift/control
  289.     keys (both send as left side one), and cannot distinguish keypad
  290.     keys.  
  291.     
  292.     This causes some remote applications does not work correctly. So fix
  293.     this problem, I introduced scan key mapping to VNC key events.
  294.  
  295.         With this function, you can distinguish left/right control/shift
  296.     keys or enable NLS keys.
  297.  
  298.     Keymap file is a text file, each line defines mapping between PM's
  299.     scan key code to VNC's key event code.  Lines beginning with '#' are
  300.     treated as comment line.  For example, following definition
  301.     distinguishes right Shift/Control keys on my keyboard.
  302.  
  303.     # Right Shift Key   -> XK_Shift_R
  304.     36 FFE2
  305.     # Right Control Key -> XK_Control_R
  306.     5B FFE4
  307.  
  308.     First digits defines PM's scan key code (in hex-decimal).  This is
  309.     keyboard dependent, so adjust to your environment.  I use good old
  310.     'keylook' sample in Petzold's book to confirm these values.
  311.     
  312.     Next digits defines key event code send to VNC server. It is really
  313.     X keysym definition.  Take a look at 'keysymdef.h' in the archive to
  314.     describe value of key event.
  315.  
  316.     Archive contains two sample keymap files, works on my environment.
  317.     
  318.         right.map   Distinguish right Shift/Control keys
  319.     keypad.map  Distinguish keypad keys.
  320.  
  321.     Of course, they works only my local environment.  If you want to use
  322.     those mapping, adjust scan key code to your environment.
  323.