home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / l.lbr / LCS.HZP / LCS.HLP
Encoding:
Text File  |  1991-11-18  |  5.5 KB  |  128 lines
  1. ;
  2.                                     LCS.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.               11k (86)   3941  1.0        Gene Pizzetta 10/91      Z3COM11
  6.  
  7.   1- Syntax  2- Fonts  3- Notes                                               
  8.  
  9.  
  10.    LCS is a ZCPR3 utility that loads character sets to  Wyse 60 and  Televideo
  11. 965 terminals.   Included are a  Roman  font that is  similar to that used  on
  12. MS-DOS machines and a  Courier  font that is  somewhat easier to read than the
  13. native font.   Provision has been made  for a user-defined font  for those who
  14. want to design their own.
  15. :1
  16.  Syntax   LCS {{/}font}
  17.  
  18.    Before use LCS must be configured for either  Wyse or  Televideo terminals.
  19. For Televideo terminals, which lack a hash block for extended TCAP's,  LCS can
  20. also be configured to  automatically load  hashed  block to replace the weird-
  21. looking graphic cross character.   The hashed block can be accessed as charac-
  22. ter 92h in 8-bit mode,  or as  7-bit  graphics  character  "R".   Two types of
  23. hashed blocks are available; try them both to see which you prefer.
  24.  
  25.    Configuration is  accomplished using  ZCNFG and the  accompanying LCSnn.CFG
  26. file.
  27. :2
  28.  Available Fonts - 1/2 
  29.  
  30.   A leading slash is permissible, but not required.
  31.  
  32.      C    Courier. This font is similar to the native font, but 
  33.           some of the characters are more open and easier to 
  34.           read.  Zeroes are slashed.
  35.  
  36.      R    Roman.  This font is similar to fonts commonly used on 
  37.           MS-DOS machines.  If you regularly move between MS-DOS 
  38.           and ZCPR3, this font might ease the transition.
  39.  
  40.      M    Roman (same as R).  This option is provided in case you 
  41.           think "MS-DOS".
  42.  
  43.      I    Roman (same as R).  This option is provided in case you 
  44.           think "IBM".
  45.  
  46.      U    User defined.  This selection allows users to design 
  47.           their own custom font (see below).  As distributed, it 
  48.           merely loads a slight variation on the Courier font.
  49.  Available Fonts - 2/2 
  50.  
  51.      N    Native.  Returns the terminal to its native font.
  52.  
  53.    Although LCS is a Z-System utility,  it should run fine without ZCPR3.  The
  54. only difference will be that  the  program's  disk  name  will not  be used on
  55. syntax line of the usage screen.
  56.  
  57.    This program may work on other terminals that  emulate  Wyse or  Televideo,
  58. but I haven't tested that so there are no  guarantees.   The  only  difference
  59. between the  Wyse and  Televideo  configurations of LCS is the lead-in string.
  60. For Wyse terminals the lead-in is  ESC,  "cA0".   For Televideo the lead-in is
  61. ESC, "xA0".
  62.  Custom Fonts - 1/3 
  63.  
  64.    Designing a font is a tedious process,  but if you've  got  the  fortitude,
  65. here's how you can implement a user-defined character set.
  66.  
  67.    Each line of a  font  definition in the  source  code is  concerned  with a
  68. single character.  As an example, we will use the upper-case "A".   The source
  69. code line is as follows:
  70.  
  71.      db   '41003844828282FE828282828200000000',CtrlY,0   ; A
  72.  
  73.    The lead-in string is sent automatically  by LCS,  so we won't concern our-
  74. selves with that.  Each pair of numbers in the quoted string represents a byte
  75. in hexadecimal.  Here's how the source code line breaks down:
  76.  
  77.      41   The first pair of digits is the ASCII value of the 
  78.           character in hexadecimal.  In this case the upper-case 
  79.           "A" is ASCII 041h.
  80.  
  81.      00   Sixteen pairs of digits representing the 16 scan lines
  82.      38   used by each character.  Each pair is the hexadecimal
  83.      44   value for a one-byte bit map, with 1 bits representing
  84.  Custom Fonts - 2/3 
  85.      
  86.      82   lit pixels and 0 bits representing dark pixels.
  87.      82
  88.      82   = 1 0 0 0 0 0 1 0
  89.      FE   = 1 1 1 1 1 1 1 0
  90.      82
  91.      82   Bit 0 (on the far right) should never be 1 because it
  92.      82   is reserved for graphic characters.  Setting bit 0 to
  93.      82   a 1 will cause the two character separator pixels (not
  94.      82   part of the bit map) to also be lit, which is not what
  95.      00   one would ordinarily want.  For the same reason, scan
  96.      00   lines 1 and 16 should ordinarily be "00".  Your charac-
  97.      00   ters should be restricted to 7 by 14 pixels.
  98.      00
  99.  
  100.    CtrlY  A ^Y tells the terminal that we have reached the end of 
  101.           the character definition.
  102.    
  103.      0    A final null terminates a line of characters that will 
  104.           be sent to the terminal after each lead-in string is 
  105.           sent.
  106.  Custom Fonts - 3/3 
  107.  
  108.    At the end of the table, a line that contains only a null:
  109.      db   0
  110. tells LCS that it has reached the end of a font definition.
  111.  
  112.    Note that the example above is based on Joe Wright's original  Courier font
  113. (the default user-defined font), which has the top of upper-case characters at
  114. scan line 2 and decenders beginning at scan line 13:
  115.      db   '41003844828282FE828282828200000000',CtrlY,0   ; A (user)
  116. The remaining fonts  (including the  native font)  top out at scan line 3 with
  117. decenders beginning at scan line 14:
  118.      db   '4100003844828282FE8282828282000000',CtrlY,0   ; A (Courier)
  119.      db   '410000386CC6C6C6FEC6C6C6C6C6000000',CtrlY,0   ; A (Roman)
  120. A very few Roman characters extend beyond these limits.
  121. :3
  122.  Notes 
  123.  
  124.    a. Vs 1.0 (10/03/91, Gene Pizzetta):
  125.       - Initial release. 
  126.       - Courier font is modified from one  "borrowed"  from Joe Wright.   User
  127.         font is basically a duplicate of Courier.
  128.