home *** CD-ROM | disk | FTP | other *** search
/ PC Open 18 / pcopen18_giallo.iso / Msdos / Keybit6 / KL_API.ZIP / KL_API.TXT < prev   
Encoding:
Text File  |  1996-02-22  |  4.0 KB  |  99 lines
  1.  
  2.                   KEYBIT Lite
  3.              Application Program Interface
  4.  
  5.  
  6.  
  7.       *** What is KEYBIT Lite?
  8.  
  9.      It's  a  keyboard  driver for Italian    keyboards  only.   It  is
  10.       cardware and distributed with full source code.
  11.      KEYBIT  Lite  supplies some special features that have  made  it
  12.       well  known  and appreciated here in Italy.  Among  these  features
  13.       there is "e-mail support".
  14.  
  15.  
  16.       *** What is e-mail support?
  17.  
  18.      On italian keyboards, some keystrokes generate letters that  are
  19.       not allowed in e-mail messages.  Italian people were used to  avoid
  20.       these  keystrokes and to substitute the corresponding chars with    a
  21.       couple  of  allowed  chars.  KEYBIT Lite is able    to  perform  this
  22.       conversion  automatically: one keystroke gives two chars.  This  is
  23.       called e-mail support.
  24.      Note  that existing programs need NO change to allow the use  of
  25.       e-mail  support because these unusual couples of chars are  handled
  26.       by the driver just like all other chars: they go directly into  the
  27.       keyboard buffer so they can be read using standard BIOS calls.
  28.  
  29.  
  30.       *** Enabling e-mail support
  31.  
  32.      Many  users  keep e-mail support off unless they are  running    a
  33.       message  editor.     They  can enable e-mail  support  by  hotkey  or
  34.       calling a special program from a batch file.
  35.      Beginning from v.5 of KEYBIT Lite, message editors are given the
  36.       ability to active e-mail support by themselves (it seems to be  the
  37.       best solution).  This is possible thanks to a small API.    Here is a
  38.       full description of it.
  39.  
  40.  
  41.  
  42. --------K-2D--10-----------------------------
  43. INT 2D - KEYBIT Lite v5+ - GET POINTER TO STATUS BYTE
  44.     AL = 10h
  45.     AH = AMIS multiplex number for KEYBIT Lite
  46. Return: DX:BX -> status byte (see below)
  47. Program: KEYBIT Lite is an enhanced Italian keyboard driver by Pino Navato.
  48. SeeAlso: INT 2D"AMIS"
  49.  
  50. Bitfields for KEYBIT Lite status byte:
  51. Bit(s)    Description
  52.  7    KEYBIT Lite active
  53.  6    E-mail support active
  54.  5-0    reserved
  55. Notes:    E-mail support is one of the original features of KEYBIT Lite.    It is
  56.       the automatic conversion of the 8-bits ASCII chars produced by some
  57.       keys available on Italian keyboards to couples of 7-bits chars.
  58.     Message editors should always enable e-mail support, they should also
  59.       restore its original status before exiting.
  60.     The user can change both status bits by hotkeys.
  61.  
  62. --------t-2D---------------------------------
  63. INT 2D - ALTERNATE MULTIPLEX INTERRUPT SPECIFICATION (AMIS) [v3.5.1]
  64.     AH = multiplex number
  65.     AL = function
  66.         00h installation check
  67.         Return: AL = 00h if free
  68.             AL = FFh if multiplex number in use
  69.                 CX = binary version number (CH = major, CL = minor)
  70.                 DX:DI -> signature string (see #1357) identifying
  71.                     the program using the multiplex number
  72.         [* other functions omitted *]
  73.  
  74. Notes:    programs should not use fixed multiplex numbers; rather, a program
  75.       should scan all multiplex numbers from 00h to FFh, remembering the
  76.       first unused multiplex in case the program is not yet installed.
  77.       For multiplex numbers which are in use, the program should compare
  78.       the first 16 bytes of the signature string to determine whether it
  79.       is already installed on that multiplex number.  If not previously
  80.       installed, it should use the first free multiplex number.
  81.     functions other than 00h are not valid unless a program is installed
  82.       on the selected multiplex number
  83.  
  84. Format of AMIS signature string:
  85. Offset    Size    Description    (Table 1357)
  86.  00h  8 BYTEs    blank-padded manufacturer's name (possibly abbreviated)
  87.  08h  8 BYTEs    blank-padded product name
  88.  10h 64 BYTEs    ASCIZ product description (optional, may be a single 00h)
  89. Note:    it is not necessary to reserve a full 64 bytes for the description,
  90.       just enough to store the actual ASCIZ string    [* no description in
  91.       KEYBIT Lite *]
  92. SeeAlso: #1364
  93.  
  94. (Table 1364)
  95. Values of AMIS signatures known to be in use:
  96.  'Pino Nav' 'Keybit  '    Pino Navato's KEYBIT Lite Italian keyboard driver v4+
  97.  [* other signatures omitted *]
  98. SeeAlso: #1357
  99.