home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / print2 / image.lzh / UTILS.DOC < prev   
Text File  |  1989-07-12  |  16KB  |  595 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                            "CONTROL"  and  "ENHANCE"
  14.  
  15.  
  16.                           for IBM Personal Computers
  17.  
  18.                                       and
  19.  
  20.                    IBM/Epson/Compatible Dot Matrix Printers
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.                    (C)Copyright IMAGE Computer Systems 1989
  49.  
  50.                               All Rights Reserved
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.       TABLE OF CONTENTS
  72.  
  73.         CONTROL
  74.  
  75.           What is CONTROL? .............................. 1
  76.  
  77.           Files included with CONTROL ................... 1
  78.  
  79.           Loading CONTROL ............................... 1
  80.  
  81.           Configuring CONTROL ........................... 2
  82.  
  83.           CONTROL Error Messages ........................ 4
  84.  
  85.         ENHANCE
  86.  
  87.           What is ENHANCE? .............................. 5
  88.  
  89.           Loading ENHANCE ............................... 6
  90.  
  91.           ENHANCE Error Messages ........................ 7
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.                                                 CONTROL and ENHANCE
  134.      --------------------------------------------------------------
  135.  
  136.  
  137.       WHAT IS CONTROL?
  138.  
  139.         CONTROL is a memory-resident program that allows you to easily 
  140.         access the features of your printer. Simple commands, embedded 
  141.         in your printed text, are converted into printer control 
  142.         codes. You can also define text substitutions that allow you 
  143.         to "boiler-plate" letters, forms, etc. 
  144.  
  145.         Configuration files allow you to specify what effect each 
  146.         embedded command has. 
  147.  
  148.         CONTROL can be removed from memory without rebooting your 
  149.         computer. 
  150.  
  151.  
  152.       FILES INCLUDED WITH CONTROL
  153.  
  154.         The files are:
  155.  
  156.           CONTROL.EXE     The main memory-resident program.
  157.  
  158.           REM-CTRL.EXE    Removes CONTROL from memory.
  159.  
  160.           CONTROL.DAT     Sample data file for Epson or IBM printers. 
  161.                           It contains substitution definitions that
  162.                           select bold, double width, etc.
  163.  
  164.           SAMPLE.DAT      Sample data file for text. It contains 
  165.                           example text substitutions.
  166.  
  167.         Both of the .DAT files are plain "ASCII" files. They contain 
  168.         comments to help you understand their contents. 
  169.  
  170.  
  171.       LOADING CONTROL
  172.  
  173.         The syntax for loading CONTROL is:
  174.  
  175.           CONTROL  [-Tx]  [configuration_file]  [printer]
  176.  
  177.         All bracketed items following CONTROL are optional.
  178.  
  179.         The "-Tx" option allows you to select an alternate trigger 
  180.         character for the embedded commands contained in the text that 
  181.         you are sending to your printer. The character following the 
  182.         "T" (here shown as an "x") becomes the new trigger character. 
  183.         The default trigger character is a backslash ("\"). A typical 
  184.         example of an embedded command would be: 
  185.  
  186.           \BThis would print as bold, \Cand this wouldn't.
  187.  
  188.  
  189.  
  190.                                                                   1
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.                                                 CONTROL and ENHANCE
  200.      --------------------------------------------------------------
  201.  
  202.  
  203.         In the above example, "\B" turns on the bold feature of your 
  204.         printer, and "\C" turns it off. (The "\B" and "\C" commands 
  205.         could mean something entirely different; they are used here 
  206.         only for the purpose of showing commands embedded within 
  207.         text.)
  208.  
  209.         The trigger character is always immediately followed by a 
  210.         character that identifies which substitution string is to 
  211.         replace the embedded command. Upper and lower case are 
  212.         equivalent for the second character. For example, "\b" and 
  213.         "\B" are the same. 
  214.  
  215.         The "configuration_file" option allows you to select an 
  216.         alternate configuration file. The default configuration file 
  217.         is CONTROL.DAT. To load SAMPLE.DAT instead, type:
  218.  
  219.           CONTROL SAMPLE.DAT
  220.         
  221.         The "printer" option allows you to use CONTROL with a printer 
  222.         connected to a printer port other than the default LPT1: 
  223.         (PRN:). "Printer" can be LPT1:, LPT2: or LPT3:. For example, 
  224.         to control the printer connected to LPT2:, type:
  225.            
  226.           CONTROL LPT2:
  227.  
  228.         To remove CONTROL from memory, run REM-CTRL from the DOS
  229.         prompt.
  230.  
  231.  
  232.       CONFIGURING CONTROL
  233.  
  234.         The CONTROL configuration file determines what strings are 
  235.         substituted for the embedded commands contained in your text. 
  236.         
  237.         The default CONTROL.DAT file contains the following 
  238.         substitution definitions for an Epson or IBM printer: 
  239.         
  240.           \B    :       turns on (B)old printing
  241.           \C    :       (C)ancels bold, underline, double width
  242.           \E    :       turns on (E)ight lines per inch printing
  243.           \N    :       turns off superscript and subscript
  244.           \S    :       turns on (S)ix lines per inch printing
  245.           \U    :       turns on (U)nderlining
  246.           \V    :       turns on subscript ("arrow" points down)
  247.           \W    :       turns on double (W)idth
  248.           \^    :       turns on superscript ("arrow" points up)
  249.           \<    :       turns on compressed mode
  250.           \>    :       turns on 10 characters per inch mode
  251.  
  252.         Configuration files must be in "ASCII" format. The file must 
  253.         contain only printable characters ("A...Z, 0...9"), with no 
  254.  
  255.  
  256.                                                                   2
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.                                                 CONTROL and ENHANCE
  266.      --------------------------------------------------------------
  267.  
  268.  
  269.         word processor or printer control codes. Most word processors 
  270.         have a facility for editing and saving ASCII files. 
  271.  
  272.         You may find the following explanation of the contents of a 
  273.         configuration file easier to understand if you first copy 
  274.         CONTROL.DAT to your printer with the following command:
  275.  
  276.           COPY CONTROL.DAT PRN:
  277.  
  278.         The substitution definitions contained in the configuration 
  279.         file consist of a header character, followed by a colon, 
  280.         followed by the substitution string. For example, to define 
  281.         the string that will be substituted for "\B": 
  282.  
  283.           B: {ESC} "E"
  284.  
  285.         In the above example, each occurence of "\B" in your text will 
  286.         be replaced by the ESCAPE character, immediately followed by 
  287.         an upper case E. This is the IBM or Epson command for bold 
  288.         printing.
  289.  
  290.         Comments in a definition file are enclosed by parentheses "(" 
  291.         and ")".
  292.  
  293.         Special control character representations recognized are:
  294.  
  295.           {ESC}   This is the escape character (decimal 27, hex 1B)
  296.           {LF}    This is a line feed character
  297.           {CR}    This is a carriage return
  298.           {NL}    This is a newline (line feed, plus carriage return)
  299.           {TAB}   This is a tab character
  300.           {FF}    This is a form feed character
  301.  
  302.         Not all string substitutions have to be printer control commands. 
  303.         You can define ordinary text substitutions. For example:
  304.  
  305.           A: "This is what will print if '\A' is sent to the printer"
  306.  
  307.         The parsing of the configuration file uses the following 
  308.         rules:
  309.  
  310.           comment ::= (anything enclosed in parentheses)
  311.           substitution definition ::= header & body
  312.           header ::= alpha & :
  313.           alpha ::= ASCII characters greater than 32 (hex 20)
  314.           body ::= (string | number | control character) & separator
  315.           string ::= "anything enclosed in double quotes"
  316.           number ::= integer <= 255
  317.           control character ::= {ESC} | {LF} | {CR} | {NL} | {TAB} | {FF}
  318.           separator ::= SPACE | COMMA | TAB | LF | CR | FORMFEED
  319.  
  320.  
  321.  
  322.                                                                   3
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.                                                 CONTROL and ENHANCE
  332.      --------------------------------------------------------------
  333.  
  334.  
  335.       CONTROL ERROR MESSAGES
  336.  
  337.         "ERROR - DOS version 2.0 or higher needed"
  338.  
  339.           CONTROL doesn't run under DOS versions earlier than 2.0.
  340.  
  341.         "ERROR - Printer specification bad"
  342.  
  343.           You have specified an invalid printer port. The default is
  344.           LPT1: (PRN:). You can specify LPT2: or LPT3:.
  345.  
  346.         "ERROR - Configuration file not found: ????????"
  347.  
  348.           CONTROL defaults to reading CONTROL.DAT. You can specify
  349.           another file on the command line when loading CONTROL. In any
  350.           case, CONTROL is unable to find the configuration file.
  351.  
  352.           The question marks represent the configuration file name you
  353.           tried to load.
  354.  
  355.         "DOS ERROR while reading configuration file: ????????"
  356.  
  357.           This error is being reported by DOS. Perhaps the file has
  358.           been corrupted.
  359.  
  360.         "ERROR in configuration file: ????????
  361.          Non-printable character on line xx"
  362.  
  363.           The configuration file must contain only ASCII text (A...Z,
  364.           0...9, etc.). A character with an ASCII value below 32 has
  365.           been found in the file.
  366.  
  367.         "ERROR - '{' must precede control code on line xx
  368.          For example: '{tab}' or '{esc}'"
  369.  
  370.           CONTROL recognizes several common printer control code
  371.           representations. {lf} represents line feed, {cr}  
  372.           represents carriage return, etc. You must use brackets
  373.           ("{}") around each control code.
  374.  
  375.         "ERROR - Colon must follow control character in configuration 
  376.         file"
  377.  
  378.           Each substitution definition in the configuration file must
  379.           start with a header character, followed by a colon (":").
  380.  
  381.         "ERROR on line xx of configuration file: ????????. Number out 
  382.         of range"
  383.  
  384.           Numbers, which represent ASCII values, cannot exceed 255,
  385.           the upper limit of ASCII characters.
  386.  
  387.  
  388.                                                                   4
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.                                                 CONTROL and ENHANCE
  398.      --------------------------------------------------------------
  399.  
  400.  
  401.         "ERROR - Unbalanced comment bracketing in configuration file"
  402.  
  403.           A configuration file can contain comments, which are 
  404.           enclosed with parentheses "()". Each start of a comment
  405.           must be matched by an end. For example:
  406.  
  407.             (this is a properly bracketed comment)   (and so is this)
  408.  
  409.             ((this isn't; there are 2 left parens and only 1 right)
  410.  
  411.         "ERROR - Too many definitions in configuration file"
  412.  
  413.           You are limited to 70 definitions in a configuration file.
  414.  
  415.         "ERROR - Configuration buffer overflow"
  416.  
  417.           Your definitions have exceeded the allowable number of total
  418.           characters. The maximum for all definitions combined is 
  419.           approximately 2000 characters. 
  420.  
  421.         "ERROR - Memory-resident program not found"
  422.  
  423.           This is an error message from REM-CTRL. Either CONTROL isn't 
  424.           in memory, or you have loaded another memory-resident program
  425.           on top of CONTROL A third possibility is that an ill-behaved 
  426.           program is resident in memory. 
  427.  
  428.  
  429.       WHAT IS ENHANCE?
  430.  
  431.         ENHANCE is a memory-resident program that improves the 
  432.         graphics output of standard Epson or IBM dot matrix printers. 
  433.         This improvement comes from printing each graphics pass twice, 
  434.         possibly shifting the second graphics pass to the right one 
  435.         dot position.
  436.  
  437.         ENHANCE can also map high density graphics to lower density 
  438.         graphics supported by earlier printers. 
  439.  
  440.         ENHANCE can't make a poorly scaled or crudely drawn graphic 
  441.         attractive. By the time ENHANCE receives the graphics output, 
  442.         the shape of the picture has already been determined. ENHANCE 
  443.         receives the graphics picture in thin horizontal strips of dot 
  444.         patterns, and there is no way to know how or what would 
  445.         improve a particular picture. 
  446.  
  447.         ENHANCE is compatible with IBM or Epson printers that support 
  448.         the following graphics commands: 
  449.  
  450.  
  451.  
  452.  
  453.  
  454.                                                                   5
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.                                                 CONTROL and ENHANCE
  464.      --------------------------------------------------------------
  465.  
  466.  
  467.           ESC "K"   single density graphics    
  468.           ESC "L"   low-speed double density graphics
  469.           ESC "Y"   high-speed double density graphics
  470.           ESC "Z"   quadruple-density graphics
  471.  
  472.         Almost all PC printers sold since 1986 are compatible.
  473.  
  474.  
  475.       LOADING ENHANCE
  476.  
  477.         The syntax for loading ENHANCE is:
  478.  
  479.           ENHANCE  [dash options]  [printer]
  480.  
  481.         All bracketed items following ENHANCE are optional.
  482.  
  483.         The dash options are:
  484.  
  485.           -R    Remove ENHANCE from memory. 
  486.  
  487.           -T    Print graphics twice. Each sweep of the print head
  488.                 will be doubled for darker, clearer graphics. This is
  489.                 the default if no dash options are used.
  490.  
  491.           -TS   Print graphics twice, shifting the second
  492.                 pass one dot position to the right. This results
  493.                 in graphics that are darker and slightly bolder.
  494.  
  495.           -L    Convert ESC "Z" quadruple density graphics to
  496.                 ESC "L" double density graphics. This option
  497.                 allows graphics to print on >some< early
  498.                 printers that only recognize double density graphics.
  499.  
  500.         Examples:
  501.  
  502.           ENHANCE -T LPT2:      {print graphics twice on printer
  503.                                  attached to the 2nd printer port}
  504.  
  505.           ENHANCE -R            {remove ENHANCE from memory}
  506.  
  507.         ENHANCE should be loaded into memory before any other memory-
  508.         resident software that generates graphics output. For example, 
  509.         if you intend to do graphics screen dumps, you should first 
  510.         load ENHANCE, and then load the DOS GRAPHICS program.
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.                                                                   6
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.                                                 CONTROL and ENHANCE
  530.      --------------------------------------------------------------
  531.  
  532.  
  533.       ENHANCE ERROR MESSAGES
  534.  
  535.         "ERROR - Printer must be in range 1...3"
  536.  
  537.           You have specified an invalid printer port. The default is
  538.           LPT1: (PRN:). You can specify LPT2: or LPT3:.
  539.  
  540.         "ERROR - DOS version 2.0 or higher needed"
  541.  
  542.           ENHANCE doesn't run under DOS versions earlier than 2.0.
  543.  
  544.         "ERROR - '-R' is invalid;
  545.          ENHANCE not resident (or not found)"
  546.  
  547.           The "-R" command line option removes ENHANCE from memory. 
  548.           ENHANCE isn't already in memory, or another memory-resident
  549.           printer-controlling program has been loaded after ENHANCE. A
  550.           third possibility is that an ill-behaved memory-resident
  551.           program has broken the "link" to ENHANCE.
  552.  
  553.         "ERROR - '-x' not a valid command; ignored"
  554.  
  555.           The 'x' represents a dash option that ENHANCE doesn't
  556.           recognize.
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.                                                                   7
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.