home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / y.lbr / VLIB.HZP / VLIB.HLP
Encoding:
Text File  |  1990-04-24  |  2.4 KB  |  71 lines
  1. ;
  2.          VLIB - Video Terminal Interface 
  3.  
  4.  
  5.      I  - Introduction to VLIB, Version 4.2D
  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.     LD    HL,(109H)    ; Get the Environment Address
  39.     CALL    Z3VINIT        ; Initialize ENVPTR and VIDPTR
  40.     CALL    GZ3INIT        ; If you would use Graphics
  41.  
  42.     CALL    TINIT        ; Initialize the Terminal
  43.  
  44.     ....            ; Whatever your program..
  45.  
  46.     CALL    DINIT        ; De-initialize the Terminal
  47.     ....            ; Housekeeping
  48.     RET            ; Quit
  49.  
  50. 1. Initialize Pointers and routines.  The two ptrs needed are:
  51.     - ENVPTR is the ZCPR3 Environment Descriptor Addr
  52.     - VIDPTR sets the Z3TCAP Entry Address
  53.     - If using Graphics or Pull-Down Menus, initialize
  54.         that sybsystem as well.  This routine returns
  55.         flags that tell what new capabilities exist
  56.  
  57. 2. Call Terminal Initialization Routine, TINIT.  If your terminal
  58.    uses DIM or reduced-intensity instead of Reverse video, TINIT
  59.    should set the default to the Dim level as default, and use
  60.    normal intensity for STNDOUT, with STNDEND returning to Dim.
  61.  
  62. 3. Call VLIB Routines within the program as desired.
  63.  
  64. 4. Call Terminal De-initialization Routine, DINIT.  If your
  65.    terminal uses DIM or reduced-intensity attibutes instead of
  66.    Reverse or Intensified video for Highlighting, DINIT should
  67.    restore the terminal to normal intensity at exit.
  68. :1:VLIB1.HLP
  69. :2:VLIB2.HLP
  70. :3:VLIB3.HLP
  71.