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