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