home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / MISC / HANDICAP / ABRL10B.ZIP / ABRL.DOC < prev    next >
Encoding:
Text File  |  1991-04-28  |  13.5 KB  |  277 lines
  1.  
  2.  
  3.  
  4.                                    AutoBraille
  5.         
  6.                                   Version 1.0B
  7.         
  8.                             Another Sound Alternative
  9.         
  10.                                Copyright (c) 1991
  11.                                        by
  12.                                   KANSYS, Inc.
  13.                                     1016 Ohio
  14.                                Lawrence, KS 66044
  15.         
  16.                      Telephone: 913-843-0351 or 800-279-4880
  17.         
  18.                                  April 30, 1991
  19.         
  20.                                    User Guide
  21.         
  22.              The AutoBraille program is an "EMS aware" memory resident 
  23.         program that converts text into grade two braille. It operates 
  24.         automatically in the background. It enables any application 
  25.         package capable of putting text on the screen or generating 
  26.         ordinary print output to produce grade 2 braille without user 
  27.         assistance or intervention.
  28.         
  29.              AutoBraille accepts its input from parallel port LPT1, LPT2, 
  30.         or LPT3, or from a user defined "text window" on the screen. It 
  31.         translates and formats its input into grade two braille, and 
  32.         delivers it to port LPT1, LPT2, LPT3, COM1 or COM2, or to a user 
  33.         defined "braille window" on the screen. It can be used in a "port 
  34.         to port mode," in a "screen to screen mode," or in a "screen to 
  35.         port mode."
  36.         
  37.              Requirements. AutoBraille uses 48K of conventional memory, 
  38.         or 2K of conventional and 48K of expanded memory, using the 
  39.         Lotus-Intel-Microsoft 3.2 or 4.0 standard. It requires MS-DOS or 
  40.         PC-DOS 3.0 or later version. It produces braille output in the 
  41.         standard ASCII character set supported by most popular braille 
  42.         embossers currently available.
  43.         
  44.              Files. AutoBraille consists of two files: ABRL.COM, the TSR 
  45.         translator program; and ABC.EXE, the AutoBraille Commander user 
  46.         interface. The same set of translation rules used by Turbo 
  47.         Braille is built into AutoBraille.
  48.         
  49.              Installation. AutoBraille assumes that it should use 
  50.         expanded memory if available, and conventional DOS memory if 
  51.         sufficient EMS memory is not available. If this assumption is 
  52.         incorrect, it may be changed by including the switch "/C" on the 
  53.         command line when ABRL.COM is executed. The command line would 
  54.         look like one of the following:
  55.         
  56.                                       ABRL
  57.         
  58.                                      ABRL /C
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.         
  66.              If ABRL.COM is not in the current device and directory, nor 
  67.         in one that is on the DOS path, the correct device and path 
  68.         should also be included with the name of the program, as follows:
  69.         
  70.                                      A:ABRL
  71.         
  72.                                    \main\abrl
  73.         
  74.                                  d:\SUBDIR\abrl
  75.         
  76.              The Auto Braille Commander. Once AutoBraille has been 
  77.         properly installed, the user communicates with it by means of 
  78.         ABC.EXE, the Auto Braille Commander. There is also a "hot key" to 
  79.         process a text window on the screen, which may be set to nearly 
  80.         any desired key  by the ABC program. This program should 
  81.         therefore be copied to a directory that is always available on 
  82.         the DOS path. Typing "ABC" at any DOS prompt provides a command 
  83.         summary for the program.
  84.         
  85.              Any number of AutoBraille commands may be included on the 
  86.         ABC command line, and will be executed in the order in which they 
  87.         appear there. Capitalization is disregarded by the Auto Braille 
  88.         Commander. Except for the "STATUS" command and the "WINDOWS" 
  89.         command, no messages result from successful execution of a 
  90.         command.  Error conditions will always be reported. "STATUS" 
  91.         displays all the current settings of the Auto Braille program. 
  92.         "WINDOWS" invokes a menu and prompts for definitions of the text 
  93.         window, the braille window, and the hot key.
  94.         
  95.              The Auto Braille Commander is used to select the computer 
  96.         output port or ports to be used for input and output by 
  97.         AutoBraille, to set braille page margins, page numbering and 
  98.         running header information, and other AutoBraille features. When 
  99.         AutoBraille has been successfully configured, the Auto Braille 
  100.         Commander "SAVE" command may be used to preserve all current 
  101.         selections. They may be restored later with the "ABC RESTORE" 
  102.         command. Thus, AutoBraille may be loaded and initialized in a 
  103.         batch file, e.g. AUTOEXEC.BAT, with the two lines:
  104.         
  105.                                       ABRL
  106.                                    ABC RESTORE
  107.         
  108.              Any changes made to AutoBraille may thus be made "permanent" 
  109.         by following the information on the ABC command line with the 
  110.         "SAVE" command. Without adding "SAVE" to the command line, the 
  111.         change will remain in effect only until the computer is 
  112.         restarted. All AutoBraille default values may be recovered with 
  113.         the "ABC RESET" command.
  114.         
  115.              Some ABC commands are familiar to Turbo Braille users, since 
  116.         they follow the dot commands employed in that program. Note 
  117.         however that if an ABC dot command is to include an imbedded 
  118.         blank, the dot command and all its associated information must be 
  119.         surrounded by quotation marks (" "). That will often be the case 
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.         with the ".RH" Running Header command, as in:
  127.         
  128.                          ABC ".RH Multiple Word Header"
  129.         
  130.              To use the Auto Braille Commander from within your word 
  131.         processor or other application, check the application program's 
  132.         manual to learn how to run a DOS command (or "shell to DOS") 
  133.         without leaving the program. To produce braille output from your 
  134.         application, simply use its standard print commands. If you have 
  135.         installed AutoBraille successfully, it will intercept the output 
  136.         produced by your application, translate and format it, and 
  137.         deliver it to the specified output port.
  138.         
  139.              The Simulated Printer. The interface between DOS (or your 
  140.         application) and AutoBraille resembles a simple draft printer. 
  141.         Your application may:
  142.              (1) send standard ASCII characters, having decimal values 
  143.         between 32 and 127;
  144.              (2) send a CR code (ASCII 13) to return to the left margin 
  145.         without advancing to a new line, then overprint all or part of 
  146.         the line to achieve line-by-line boldfacing or underlining;
  147.              (3) send a BSP code (ASCII 8) to back over one or more 
  148.         characters on a line, then overprint them to achieve 
  149.         character-by-character boldfacing or underlining;
  150.              (4) terminate a line normally by sending a CR/LF 
  151.         combination, or by sending just an LF code (ASCII 10);
  152.              (5) send up to 140 consecutive characters before sending a 
  153.         CR or an LF code to terminate the line.
  154.         
  155.              Auto Braille Commander Synonyms. There are many ways to say 
  156.         the same thing in the Auto Braille Commander language. Here is a 
  157.         list of synonyms:
  158.              (1) LPT, LPT:, LPT1, LPT1:, PRN, and PRN:
  159.              (2) NUL, NULL, and NONE
  160.              (3) SCREEN, VIDEO, CRT, and CRT:
  161.              (4) IN=LPT, IN=LPT:, IN=LPT1, IN=LPT1:, IN=PRN, and IN=PRN:
  162.              (5) IN=LPT2 and IN=LPT2:
  163.              (6) IN=LPT3 and IN=LPT3:
  164.              (7) IN=SCREEN, IN=VIDEO, IN=CRT, and IN=CRT:
  165.              (8) IN=NUL, IN=NULL, and IN=NONE
  166.              (9) AUX, AUX:, COM, COM:, COM1, COM1:, OUT=AUX, OUT=AUX:, 
  167.         OUT=COM, OUT=COM:, OUT=COM1, and OUT=COM1:
  168.              (10) COM2, COM2:, OUT=COM2, OUT=COM2:
  169.              (11) OUT=LPT, OUT=LPT:, OUT=LPT1, OUT=LPT1:, OUT=PRN, and 
  170.         OUT=PRN:
  171.              (12) OUT=LPT2 and OUT=LPT2:
  172.              (13) OUT=LPT3 and OUT=LPT3:
  173.              (14) OUT=NUL, OUT=NULL, OUT=NONE, and OUT=SINK
  174.         
  175.              Dot Commands. Several Turbo Braille dot commands are 
  176.         available to Auto Braille. However, they are not placed within 
  177.         the file to be translated. Instead, they are placed on an Auto 
  178.         Braille Commander command line. The dot commands affect only the 
  179.         background conditions of the requested translation, and do not 
  180.         permit intervention in the translation process. The dot commands 
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.         available on the Auto Braille Commander command line are:
  188.              (1) .BL -- the bottom line;
  189.              (2) .TL -- the top line;
  190.              (3) .DV -- page divider lines;
  191.              (4) .PL -- page length;
  192.              (5) .PO -- page offset;
  193.              (6) .RM -- right margin;
  194.              (7) .RH -- running header.
  195.         
  196.              YES or NO Commands. The Auto Braille Commander recognizes 
  197.         four commands that may set features on or off. The commands are:
  198.              (1) FORMFEED=YES, FORMFEED=NO -- issue a standard FF code 
  199.         (ASCII 12) after the last line of each page;
  200.              (2) FILLING=YES, FILLING=NO -- Form braille paragraphs by 
  201.         treating CR/LF codes as "soft returns" except for obvious 
  202.         exceptions;
  203.              (3) CLEARFIELD=YES, CLEARFIELD=NO -- If a braille window is 
  204.         defined in an area less than the full screen, the area outside 
  205.         the window can be cleared to blanks, or can be allowed to retain 
  206.         its original contents;
  207.              (4) WATCHDOG=YES, WATCHDOG=NO -- An audible indicator 
  208.         informs the user when Auto Braille is busy working on something.
  209.         
  210.              Hot Key. To process text shown on the screen, a hot key must 
  211.         be pressed. If the braille output is directed to a parallel or 
  212.         serial port, the screen remains unchanged.  However, if the 
  213.         braille translation is displayed on the screen, then the same hot 
  214.         key must be pressed a second time to restore the screen before 
  215.         any further processing can be performed. With braille displayed 
  216.         on the screen, the keyboard cannot be used for normal DOS or 
  217.         application functions. Your screen review software will remain 
  218.         available, but no other keystrokes will be acknowledged until you 
  219.         press the hot key a second time to restore the screen and release 
  220.         the computer for other processing.
  221.         
  222.              Limitations. Some of AutoBraille's limitations are matters 
  223.         of design, while others are matters of incomplete implementation. 
  224.         The former type may or may not change; the latter type will be 
  225.         corrected with revisions and future releases.
  226.         
  227.              (1) You may not direct output to the screen unless input 
  228.         also comes from the screen. Auto Braille therefore works "port to 
  229.         port," "screen to screen," and "screen to port," but it does not 
  230.         permit "port to screen" processing.
  231.         
  232.              (2) Auto Braille accepts input from a screen window, or from 
  233.         a parallel port, but not from a serial port. It delivers output 
  234.         to a screen window (see the above discussion), to a parallel 
  235.         port, or to a serial port. Serial ports therefore may only be 
  236.         used for AutoBraille output, and not for input to the program.
  237.         
  238.              (3) Version 1.0B of Auto Braille leaves several important 
  239.         functions incompletely implemented. These include: automatic 
  240.         centering, page numbering, and running headers. In addition, the 
  241.         implementation of serial port output needs further work to 
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.         achieve reliability.
  249.         
  250.              Compatibility. Auto Braille accepts printer output from 
  251.         WordStar, WordPerfect, the DOS PrintScreen command, the external 
  252.         DOS PRINT command, and many other sources. It is compatible with 
  253.         a broad range of other TSR and EMS programs, including the 
  254.         HumanWare ALVA software, the Reader Project software, and print 
  255.         spoolers. To use Auto Braille with a print spooler, be sure to 
  256.         load the print spooler first, then load Auto Braille. Auto 
  257.         Braille can be configured to take its input from LPT1 (the 
  258.         standard DOS printer port) and send its output there as well; the 
  259.         print spooler, if loaded first, can then accept its input from 
  260.         the Auto Braille output. That way, your print spooler can 
  261.         compensate for the shaky Auto Braille serial port support until 
  262.         that feature is repaired.
  263.         
  264.              Specific Tips. Version 1.0A did not run on older computers 
  265.         that used INTEL 8088/8086 processors; it required NEC V20/V30 
  266.         processors, or INTEL 80186/286/386/486 processors. Version 1.0B 
  267.         corrects this limitation. Good news for Toshiba 1000 and 1200 
  268.         users, Leading Edge Model D, and Zenith 158 owners. Note that the 
  269.         INDEX braille embosser includes a hardware grade I translator 
  270.         that inserts composition signs and converts digits to standard 
  271.         braille numbers. That translator must be defeated if software 
  272.         translation is used, e.g. with AutoBraille or Turbo Braille.
  273.         
  274.  
  275.  
  276.  
  277.