home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / znode3 / z3lib / libhl45a.lbr / VLIB.LBR / VLIB.HZP / VLIB.HLP
Encoding:
Text File  |  1993-06-07  |  2.3 KB  |  62 lines
  1. ;                            17 Oct 92
  2.          VLIB - Video Terminal Interface 
  3.  
  4.  
  5.      I  - Introduction to VLIB, Version 4.x
  6.  
  7.      1  - Z3 Termcap (TCAP) description
  8.  
  9.      2  - Basic VLIB routines
  10.  
  11.      3  - Graphics and Pull-Down Menus
  12.  
  13.      4  - Specialized Functions (Non-portable)        |
  14.  
  15. :I
  16.          Introduction to VLIB 
  17.  
  18. VLIB is a library of routines originally designed by Richard
  19. Conn to support ZCPR3.  Many changes have been incorporated in
  20. this version, including optimized code for the Z80 processor
  21. family, conversion to a table-driven mode for increased speed,
  22. and the addition of several new routines compatible with some
  23. of the GRWLIB and GRXLIB routines which were never widely
  24. adopted.
  25.  
  26. Programs using routines from this library are able to enhance
  27. video displays with direct cursor addressing, video attributes
  28. and new modes of operation such as Pull-Down Menus in a
  29. portable manner among other Z-Systems without re-installation.
  30.  
  31. Portability is achieved by accessing terminal descriptions
  32. contained in the ZCPR3 TCAP, or compatible record.  In most
  33. systems, the TCAP is stored in the second half of the ZCPR3
  34. Environment Descriptor.
  35.  
  36.                       Using VLIB 
  37.  
  38. When writing programs to use VLIB, follow these steps:
  39.  
  40. 1. Initialize Pointers and routines.  The two ptrs needed are:
  41.     - ENVPTR is the ZCPR3 Environment Descriptor Addr
  42.     - VIDPTR sets the Z3TCAP Entry Address
  43.     - If using Graphics or Pull-Down Menus, initialize
  44.         that sybsystem as well.  This routine returns
  45.         flags that tell what new capabilities exist
  46.  
  47. 2. Call Terminal Initialization Routine, TINIT.  If your terminal
  48.    uses DIM or reduced-intensity instead of Reverse video, TINIT
  49.    should set the default to the Dim level as default, and use
  50.    normal intensity for STNDOUT, with STNDEND returning to Dim.
  51.  
  52. 3. Call VLIB Routines within the program as Desired
  53.  
  54. 4. Call Terminal Deinitialization Routine, DINIT.  If your
  55.    terminal uses DIM or reduced-intensity attibutes instead of
  56.    Reverse or Intensified video for Highlighting, DINIT should
  57.    restore the terminal to normal intensity at exit.
  58. :1:VLIB1.HLP
  59. :2:VLIB2.HLP
  60. :3:VLIB3.HLP
  61. :4:VLIB4.HLP                            |
  62.