home *** CD-ROM | disk | FTP | other *** search
/ World of Shareware - Software Farm 2 / wosw_2.zip / wosw_2 / PRINTING / PCP.ZIP / PCP.DOC < prev    next >
Text File  |  1990-02-08  |  22KB  |  517 lines

  1.  
  2.  
  3.                         PRINT CONTROL PROGRAM 2.0 (PCP)
  4.  
  5.                      (C) Copyright 1988 Blanchard Software
  6.                               All rights reserved.
  7.  
  8.                This is a shareware program. You may make copies
  9.                and share them with your friends provided that you
  10.                distribute only complete, unaltered copies of the
  11.                program and files.
  12.  
  13.  
  14.                                   INTRODUCTION
  15.  
  16.              Print Control Program combines the capabilities of several
  17.           printer utilities.
  18.              1.  Improved Print Screen capability for text screens.
  19.              2.  Send commands to the printer from within other programs.
  20.              3.  Type on screen before printing.
  21.               PCP comes with a printer code file for an IBM compatible
  22.           printer. Instructions are provided for preparing a printer code
  23.           file for other printers.
  24.              DOS print screen makes an unacceptable copy of screens that
  25.           use anything more than plain ASCII text. It doesn't print the
  26.           extended ASCII characters. It doesn't show underlining, reverse
  27.           video or high intensity text. Everything prints the same.
  28.              PCP produces a printed screen image that captures the most
  29.           important features of the video display. It shows normal print
  30.           and underlining. It represents high intensity display and reverse
  31.           video. It prints blanks for non-display mode characters
  32.           (passwords). It prints the extended ASCII characters.
  33.              PCP lets you control a printer from within other programs.
  34.           Just press the hot key and PCP pops up. You can send control
  35.           codes to the printer and then resume operation of the other
  36.           program without interruption.
  37.              PCP lets you type on the screen before printing. You can use
  38.           this for making notes on displays before printing. You can use it
  39.           for typing short notes. You can use PCP together with the (DOS)
  40.           MORE command to fill in forms.
  41.              The following list summarizes features offered by PCP.
  42.  
  43.                1.  PCP is memory resident. You can pop it up while
  44.                    running almost any other program.
  45.                2.  You can print any rectangular subset of the screen
  46.                    from a single character to the whole screen.
  47.                3.  You can set print margins to place the print
  48.                    properly on the page.
  49.                4.  You can send control codes (escape sequences) to
  50.                    the printer to select print modes.
  51.                5.  You can make the printer double strike each line
  52.                    for darker and more uniform print.
  53.                6.  The printed image shows underlining as it appears
  54.                    on the (monochrome) screen. It shows high intensity
  55.                    display as bold characters. It represents reverse
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.                    video display by printing a gray background with
  68.                    the text characters.
  69.                7.  The PCP pop-up menu also allows you to select the
  70.                    original DOS print screen function.
  71.                8.  (new) You can type anywhere on the screen before
  72.                    printing.
  73.                9.  (new) You can choose from two different hot keys
  74.                    when you install PCP.
  75.                10. (new) You can remove PCP from memory without
  76.                    rebooting the computer.
  77.                11. (new) You can select the printer that PCP will use
  78.                    when you install PCP.
  79.                12. PCP uses less than 12k of memory.
  80.  
  81.  
  82.                              USING THE PRINT CONTROL PROGRAM
  83.  
  84.              In the discussion below the symbol <shift><PrtSc> means to
  85.           press the print screen key while holding down a shift key. <Esc>
  86.           refers to the escape key. <R_shift> refers to the right shift
  87.           key. <Enter> refers to the carriage return or Enter key.
  88.              PCP normally stays in memory as an inactive program until you
  89.           activate it by pressing the hot key. Then the program presents a
  90.           pop-up menu. You make menu selections by pressing the number key
  91.           (or first letter) of your selection.
  92.              There are eight menu options. Each is described below.
  93.  
  94.              MENU OPTION 1  sends control codes (escape sequences) to the
  95.           printer. A second menu will pop-up when you choose this option.
  96.           Just type the letter corresponding to the set of codes you want.
  97.           You may send several sets of codes. When you have sent all the
  98.           required codes, press <Esc> to return to the main menu.
  99.  
  100.              MENU OPTION 2 is for selecting the screen area you want
  101.           printed. When you choose this option, PCP removes its menu and
  102.           highlights the currently defined area. You adjust the boundaries
  103.           to define the area you want printed. You can undo the area
  104.           selection and reset for the entire screen by pressing <u> or <U>.
  105.           PCP prints only the highlighted area.
  106.              First move the top left corner of the highlighted area using
  107.           the arrow keys. When the corner is where you want it, press the
  108.           <Enter> key.  You can also press <f> or <F> to FIX the corner.
  109.              After you have fixed the top left corner, use the arrow keys
  110.           to set the lower right corner. Press <Enter> or <f> or <F> when
  111.           the corner is where you want it. The main menu will pop up again,
  112.           and it will show that the area has been set.
  113.  
  114.              MENU OPTION 3  sets print margins. A second pop-up menu asks
  115.           you for the number of top margin lines and the number of left
  116.           margin spaces. The menu shows the current settings.
  117.              Type the margin values you want in the highlighted areas and
  118.           press <Enter>. The main menu will appear again, and it will show
  119.           the margin settings. PCP will use these margins in all subsequent
  120.           printing.
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.              MENU OPTION 4 tells the computer to begin printing. It prints
  134.           the defined screen area using the margins you selected. If you
  135.           have not defined an area, PCP prints the whole screen. If you
  136.           have not set margins, PCP uses zero margin values.
  137.              PCP remembers area definition and margin values from screen to
  138.           screen. The printer also retains its control code settings.
  139.              NOTE: PCP sends codes for underline or bold to the printer as
  140.           required by the screen text. If you have preset your printer for
  141.           a mode that is incompatible with underline or bold, you may not
  142.           get the desired print effects.
  143.  
  144.              MENU OPTION 5 is the same as option 4 except that PCP double
  145.           strikes each line. This makes darker, more uniform print.
  146.  
  147.              MENU OPTION 6 is the original print screen function. The
  148.           program transfers control to the actual BIOS print screen code.
  149.           Thus, normal DOS print screen is still available even if PCP has
  150.           taken over the <shift><PrtSc> key combination.
  151.              Original print screen always sends output to printer number
  152.           one.
  153.  
  154.              MENU OPTION 7  lets you type on the screen. If you choose this
  155.           option, PCP clears its menu from the screen so you can type
  156.           anywhere. Move the cursor with the arrow keys. Switch between
  157.           insert and replace with the <Ins> key. The cursor size changes to
  158.           show the change. Press <Enter> when you have finished typing.
  159.              The typed text will stay on the screen for printing, area
  160.           selection etc. The original screen is restored when you exit from
  161.           PCP.
  162.  
  163.              MENU OPTION 8  (or the <Esc> key) ends the PCP session and
  164.           removes the menus from the screen. It restores the original
  165.           screen that was present when you called PCP. The program remains
  166.           memory resident. You can call it again by pressing the hot key.
  167.           PCP retains area definition and margin values.
  168.  
  169.  
  170.                                PROGRAM SETUP AND CHECKOUT
  171.  
  172.              PCP controls printer operation by inserting special hex
  173.           control codes into the stream of characters it sends to the
  174.           printer. The printer uses the codes to reset the internal printer
  175.           mechanism for bold printing, underlining, compressed characters
  176.           etc.
  177.              For example, consider what happens when PCP does a screen
  178.           print that includes some underlined text. PCP reads the screen,
  179.           character by character. When it gets to the first underlined
  180.           character, it inserts the Underline Start code in the character
  181.           stream. Your printer notices the code and resets for underlining
  182.           before it prints the character. Your printer will stay in the
  183.           underline mode until another code tells it to reset.
  184.              PCP continues reading underlined characters and sending them
  185.           to the printer. When PCP get to a character that is not
  186.           underlined, it inserts the Underline Off hex code into the
  187.           character stream. Your printer detects the code and turns off
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.           underlining before printing the character.
  200.              PCP uses a file called PRINTER.COD to define printer control
  201.           codes. The file supplied with the program has codes for an IBM
  202.           compatible printer. You can change the codes in the file using a
  203.           word processor that produces ASCII output.
  204.              File entries are arranged in pairs. Each pair consists of the
  205.           name of a printer function, such as "Start Underline," and the
  206.           hex codes for that function. PCP displays the names on the
  207.           printer command pop-up menu.
  208.              The name of the printer function can be up to 15 characters
  209.           long. The hex codes must be two characters each (Use leading zero
  210.           if necessary) with a space between them. There is room for five
  211.           control codes with each named function. You can find printer
  212.           codes (escape sequences) in your printer manual.
  213.              The printer codes for bold and underline must always be the
  214.           first through fourth pairs of entries in the file. PCP uses these
  215.           printer commands and expects to find them there. After the first
  216.           four pairs, you can put whatever printer control codes you find
  217.           useful in the file.
  218.              The printer code file supplied with PCP is listed below to
  219.           show the proper format for the file. Note that codes and names go
  220.           on separate lines and are arranged in pairs. Each line should be
  221.           ended with a carriage return. The file can contain up to 16 sets
  222.           of printer function codes.
  223.  
  224.  
  225.              Bold Start
  226.              1B 47
  227.              Bold Stop
  228.              1B 48
  229.              Underline Start
  230.              1B 2D 01
  231.              Underline Stop
  232.              1B 2D 00
  233.              17 CPI Start
  234.              0F
  235.              17 CPI Stop
  236.              12
  237.              1/8" space
  238.              1B 30
  239.              7/72" space
  240.              1B 31
  241.              Full space
  242.              1B 33 2C
  243.              6 LPI
  244.              1B 33 24
  245.              Emph. Start
  246.              1B 45
  247.              Emph. Stop
  248.              1B 46
  249.  
  250.  
  251.              Some printers offer several variations of bold print. These
  252.           may be called enhanced print, emphasized print or similar names.
  253.           I recommend that you use whichever variant of bold print is
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.           compatible with condensed print for the first pair of entries.
  266.              I have found condensed print and line spacing controls to be
  267.           useful for adjusting the relative proportions of the printed
  268.           image. It lets me make condensed screen printouts that have the
  269.           same proportions as the screen. You may also find page eject
  270.           followed by a carriage return to be useful for ejecting pages
  271.           from the printer.
  272.              Load a copy of PRINTER.COD into your word processor. Change
  273.           the hex codes using digits from 0 to 9 and letters A to F. Change
  274.           the names of the functions if you want. Then write the file to
  275.           disk without any margins, extra spaces or formatting.
  276.              You will want to test the printer codes with your printer. A
  277.           test file called PRTXT.EXE comes with PCP. This program generates
  278.           lines of normal, high intensity, reverse video, underlined and
  279.           non-display text. It leaves enough room at the bottom of the
  280.           screen for you to execute PCP in nonresident mode. This should
  281.           simplify testing.
  282.              Type   PRTXT<Enter>   to display the test character strings.
  283.           Then type   PCP<Enter>   to load PCP in its nonresident mode. Use
  284.           PCP menu option 1 to send codes, and then print the screen with
  285.           option 4. Try all of the printer codes.
  286.              It is important that the codes be correct. PCP will not be
  287.           able to detect errors in the printer code file.
  288.              Once the printer codes are correct, you can load PCP in its
  289.           memory resident mode. The program should be loaded before any
  290.           transient programs are loaded.
  291.              There are two options to consider for resident operation:
  292.                 (1) Which printer do you want PCP to use?
  293.                 (2) Which hot key do you want to trigger the program?
  294.              There are nine possible command lines to load PCP. You can
  295.           type any one of them from the DOS command line. They are show in
  296.           the table below.
  297.  
  298.              COMMAND LINE          MODE           HOT KEY        PRINTER
  299.  
  300.              PCP<Enter>         nonresident        none             #1
  301.              PCP 2<Enter>       nonresident        none             #2
  302.              PCP 3<Enter>       nonresident        none             #3
  303.              PCP R<Enter>        resident     <Shift><PrtSc>        #1
  304.              PCP R 2<Enter>      resident     <Shift><PrtSc>        #2
  305.              PCP R 3<Enter>      resident     <Shift><PrtSc>        #3
  306.              PCP K<Enter>        resident     <Alt><R_shift>        #1
  307.              PCP K 2<Enter>      resident     <Alt><R_shift>        #2
  308.              PCP K 3<Enter>      resident     <Alt><R_shift>        #3
  309.  
  310.               Normally, you would load PCP  as part of your power up
  311.           sequence. Add any one of the last six command lines to your
  312.           AUTOEXEC.BAT file. This will set up PCP with the printer and hot
  313.           key you want.
  314.               PCP checks the printer number during installation. It will
  315.           warn you if you select a nonexistent printer.
  316.              PCP.COM and PRINTER.COD must be in the default directory.
  317.           Usually, this will be the root directory.
  318.              PCP works for DOS text mode only. If you are working in the
  319.           DOS graphics mode, PCP will not respond to the hot key.
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.              PCP is a well behaved TSR program. It follows Microsoft's
  332.           recommendations for TSR programs. But that does not guarantee it
  333.           will work with all other programs. Many older programs will not
  334.           work properly with a memory resident programs. You should try out
  335.           the programs you use to see if there are problems.
  336.              If you find problems with other memory resident programs, try
  337.           loading them one at a time to determine which ones cause the
  338.           problem. Sometimes changing the order in which TSRs are loaded
  339.           can eliminate problems.
  340.              PCP allows you to choose from two hot keys, and this may help
  341.           you resolve problems. Usually the better choice will be the
  342.           <shift><PrtSc> hot key. Few other programs use that combination.
  343.              If you sometimes do DOS print screens in the graphics mode,
  344.           then you should use the <ALT><R_shift> hot key for PCP. This will
  345.           leave the <Shift><PrtSc> key assigned to its normal DOS function.
  346.           You can use it for graphics printing. All PCP options will still
  347.           be available in the text mode from the PCP menu.
  348.              To remove PCP from memory, first remove all other programs
  349.           that were loaded after PCP. Then activate PCP by pressing the hot
  350.           key. When the PCP menu appears, type <Ctrl><R> or <Ctrl><r>. PCP
  351.           will remove itself from memory, release the hot key and return to
  352.           DOS. Press the <Enter> key.
  353.  
  354.                                NOTES, COMMENTS, PROBLEMS
  355.  
  356.              The IBM character set includes some characters which will
  357.           display properly on the screen but not on the printer. For
  358.           example, ASCII 13 (hex 0D) displays a musical note on the screen,
  359.           but the printer reads it as a carriage return. The printer reads
  360.           ASCII character 10 (hex 0A) as a line feed. PCP will intercept
  361.           these two characters and change them to blanks before sending
  362.           them to the printer.
  363.              For some printers there may also be a problem with characters
  364.           just above ASCII 127 (hex 7F). If you get an unexpected line feed
  365.           or page eject in a print screen, check the screen character at
  366.           the point where the effect occurs. You can use menu option 7 to
  367.           change the offending characters.
  368.              These problems occur infrequently because the offending
  369.           characters are rarely used in displays.
  370.              PCP is compatible with both monochrome and color monitors.
  371.           Note however, that the color monitor (CGA) cannot display
  372.           underlining. Furthermore, some color monitors are incapable of
  373.           producing high intensity text. If your software package sends
  374.           underlined text to the screen, the color monitor displays it as
  375.           blue characters on a black background. PCP will read this text
  376.           from the screen and print underlined text. If your software
  377.           package sends high intensity text to the screen, PCP will print
  378.           bold characters whether or not your color monitor can display
  379.           high intensity text.
  380.              Most printers are not capable of executing all combinations of
  381.           their individual print modes. If you leave your printer in its
  382.           data processing mode, it should be able to handle the mode
  383.           changes sent by PCP. If you preset your printer for another mode,
  384.           you may get unexpected results.
  385.              If you preset your printer for bold print and then do a PCP
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.           print screen, PCP will turn off the bold print. This is because
  398.           PCP sends commands to control bold printing and underlining in
  399.           order to match the text on the screen.
  400.              If you preset your printer for bold printing and do a DOS
  401.           print screen, it will print all of the screen in boldface. This
  402.           is because the DOS print screen routine does not recognize
  403.           underline, high intensity, reverse video, etc on the screen. It
  404.           sends just the characters to the printer.
  405.              The best way to determine which features of your printer you
  406.           can use is to experiment. Put commands for the different printer
  407.           features in your PRINTER.COD file and try them.
  408.  
  409.                           REGISTRATION
  410.  
  411.              Shareware gives you free home trial of new software. If you
  412.           don't plan to use PCP, then there is no obligation to pay for it.
  413.           If you use Print Control Program, please register your copy and
  414.           pay the ten dollar fee.
  415.              Send your $10.00 check payable to Walter Blanchard, along with
  416.           any comments, suggestions or complaints to
  417.  
  418.                           Walter Blanchard
  419.                           Blanchard Software
  420.                           P.O. Box 1650
  421.                           Norristown Pa. 19401
  422.  
  423.           I will keep you informed of program improvements, and I will send
  424.           you a disk with other shareware programs that I distribute.
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.                                 REGISTRATION FORM
  465.  
  466.              I expect to use the Print Control Program 2.0 on a regular or
  467.           occasional basis. I have enclosed a check payable to Walter
  468.           Blanchard for the ten dollar registration fee.
  469.  
  470.           Name:   ________________________________________________
  471.  
  472.           Company:________________________________________________
  473.  
  474.           Street: ________________________________________________
  475.  
  476.           City:   ________________________________________________
  477.  
  478.           State:  __________________________    ZIP  _____________
  479.  
  480.           I use Print Control Program on an:
  481.  
  482.                   [ ]  IBM PC   [ ] IBM XT   [ ] IBM AT
  483.  
  484.                   [ ]  OTHER _____________________________________
  485.  
  486.           Hard disk? (Y/N): ________
  487.  
  488.           Monitor?     [ ]  Monochrome   [ ] Color
  489.  
  490.           Printer   ________________________________________
  491.  
  492.           Where did you get your copy of PCP?
  493.                   [ ]  From a friend.
  494.  
  495.                   [ ]  Shareware library ____________________________
  496.  
  497.                   [ ]  Bulletin board ________________________________
  498.  
  499.                   [ ]  User group  ____________________________________
  500.  
  501.           Suggestions/Comments/Complaints:
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.           Mail to:       Walter Blanchard
  512.                          Blanchard Software
  513.                          P.O. Box 1650
  514.                          Norristown Pa. 19401
  515.  
  516.  
  517.