home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR16 / P4UP20.ZIP / P4UP.DOC next >
Text File  |  1988-12-11  |  19KB  |  448 lines
  1.  
  2.  
  3.         P4UP - A Text Printing Utility
  4.         ______________________________
  5.  
  6. Introduction
  7. ════════════
  8. P4UP is a DOS utility program that prints 4 60-line page images of ASCII text
  9. in portrait mode on one side of a piece of paper on a variety of printers. On
  10. printers such as the Hewlett-Packard LaserJet II or DeskJet, P4UP builds and
  11. downloads its own soft font.  On other printers which cannot use these soft
  12. fonts, P4UP uses printer graphics to draw the page of text.
  13.  
  14. P4UP has several options to let you control the print operation.  Enter these
  15. options on the command line along with the file names.  Precede each option
  16. with a dash (-).  All options have default values, and can be turned on or
  17. off.  (When you register P4UP, you will also receive P4CUSTOM which lets you
  18. customize P4UP to your liking by setting your own default value for all 
  19. options.)  An example of a P4UP command with options is:
  20.  
  21.         P4UP -NoB -Z archives.*
  22.  
  23. This prints text with No Breaks (NoB) in a Zigzag pattern (Z).  You may use
  24. upper or lower case for all P4UP arguments.
  25.  
  26. In its simplest form, using all the default values, P4UP works like the DOS
  27. PRINT command.  Just give it the file names you want printed, using disk,
  28. directory, or wild cards.  For example:
  29.  
  30.     P4UP  APRIL.LET    or    P4UP  *.PRN    or    P4UP P4UP.DOC
  31.  
  32. P4UP will:
  33.  
  34.     * Automatically expand tabs (you can set the width) and formfeeds;
  35.  
  36.     * Break the output into 60-line pages with the filename and page
  37.     number at the top of each page, or run the pages together unseparated;
  38.  
  39.     * Print the pages top-to-bottom or left-to-right;
  40.  
  41.     * Write to LPT1, LPT2, LPT3, COM1, or COM2;
  42.  
  43.     * On printers which support manual page feeding, pause between pages
  44.     so you can turn each sheet of paper over, getting up to 8 page images
  45.     on a single sheet of paper.
  46.  
  47. Enter P4UP with no filenames or options to display a help screen.
  48.  
  49. Modification History
  50. ════════════════════
  51. Version 1.0 of P4UP was the original version for the HPLJII.
  52. Version 1.1 corrected an incompatibility with other laser printers
  53. Version 2.0 adds the following features:
  54. *  The format (-F) option specifies either soft fonts or graphics printing to
  55.    support the HP ThinkJet, DeskJet, and LJII.
  56. *  60-line pages are used with headers (-H) or without (-NoH).
  57. *  The tab (-T) options allows variable expansion of tab characters in text.
  58. *  Options can now be turned off with the -No prefix for use with P4CUSTOM.
  59. *  All registered users get P4CUSTOM to set default values for all options.
  60.  
  61.  
  62.         P4UP - A Text Printing Utility
  63.         ______________________________
  64.  
  65.  
  66. General Options and Usage for P4UP
  67. ══════════════════════════════════
  68. P4UP prints files much as the DOS PRINT command does.  You can give it one or
  69. more file names, even using ? and *.    As examples:
  70.  
  71.     P4UP \123\plan.prn   or       P4UP  a:*.doc a:*.lst
  72.  
  73. Before you give the P4UP command, your printer should be attached, powered up,
  74. and switched online.  
  75.  
  76. P4UP processes the file specifications you give it.  If the file specifications
  77. do not use a disk or path, the current disk and path will be used.  If the file
  78. specifications contain the DOS wild cards ? or *, all matching files will be
  79. printed.  Entering P4UP with no files and no options prints a help screen.
  80.  
  81. P4UP has many options to give you control of the print operation. The following
  82. describes the general purpose options for P4UP.  See the section named Font
  83. Management for a description of other options which are specific to soft font
  84. capabilities of the HPLJII and HPDJ.  See the Printer Capabilities section
  85. for a further description of the Format option (-F).  You can set default 
  86. values for all options with P4CUSTOM which is included in the price of P4UP.
  87.  
  88.      -B Break to a new piece of paper with each new file.  If you use -NoB,
  89.     the next file will start in the next available quadrant of the paper.
  90.  
  91.      -Ddevice  Normally P4UP prints to the device LPT1.  You can use the -D
  92.     option to name a different printer device including: LPT1, LPT2, LPT3,
  93.     COM1, COM2.  Example: -Dlpt2
  94.  
  95.      -Fn Format (Further explained in section on Printer Capabilities):  
  96.     -F0 (HPLJII) is for laser printers which use soft fonts.
  97.     -F1 (HPDJ) is for the HPDeskJet with a memory cartridge for soft fonts.
  98.     -F2 is for printers which have 300 dots per inch graphics and over
  99.         500K of available memory but which cannot use either F0 or F1. 
  100.     -F3 is for printers which support 150 dots per inch graphics.
  101.         The characters are rougher than F2 but print twice as fast.
  102.     -F4 (HPTJ) is for the HPThinkJet running in Native mode (switch
  103.         5 down) which supports 160 dots per inch graphics.
  104.     -F5 (HPTJ) is for the HPThinkJet in Emulation mode (switch 5 up).
  105.  
  106.      -H Headers.  With this option, P4UP will print a header with the filename 
  107.     and page number before each 60-line page.  Use -NoH for no headings.
  108.  
  109.      -M Manual feed.  Normally, P4UP takes paper from the input tray. If you
  110.     specify -M, P4UP will pause on every other sheet for you to turn over
  111.     the previous sheet, allowing 8 pages to print on each physical page.
  112.  
  113.      -Tn Tab expansion.  Normally, P4UP expands tab characters in the text
  114.     to enough spaces to get to the next group of 8 characters.  You can
  115.     set a value between 1 and 9 with the -T option.  Example: P4UP -T3.
  116.  
  117.      -Z Zig-Zag printing.  When you specify -Z, page 2 is to the right of
  118.     page 1, and page 3 below page 1.  With -NoZ, page 2 is below page 1,
  119.     and page 3 is to the right of page 1.
  120.  
  121.  
  122.         P4UP - A Text Printing Utility
  123.         ______________________________
  124.  
  125.  
  126. Typical uses for P4UP
  127. ═════════════════════
  128. P4UP prints a lot of data in a small but readable format using little paper.
  129. I wouldn't recommend using P4UP to send memos you want people to read, but 
  130. there are several occasions where it is appropriate.  The following are some
  131. of my own experiences; I'm sure you will find others.
  132.  
  133. As a programmer, I often have to work with three or four hundred lines of 
  134. code at one time.  Using P4UP allows me to get this many lines printed out
  135. on two pieces of paper which fit easily on my desk.  Then I see the whole 
  136. picture at one time, making it easier to deal with problems.
  137.  
  138. When I've finished a program, I like to get an archive listing of all the 
  139. source.  Chances are I'll never have to refer to it again, but should the
  140. worst happen, I want to know there's a hardcopy backup around.  Using P4UP
  141. for archive purposes saves a lot of paper.
  142.  
  143. New software that I acquire often comes with a README or online documentation 
  144. file.  Admittedly I don't spend more time reading the documentation than most
  145. people, but having it printed out increases the chance that if I refer to it
  146. I'll be able to quickly find what I'm looking for, just by scanning for page
  147. headings.  Using P4UP means I don't waste a lot of paper.
  148.  
  149. The obvious value of P4UP is that when it is appropriate to use, it saves
  150. resources, space, and expense.
  151.  
  152.  
  153. The P4UP Character Set
  154. ══════════════════════
  155.  
  156. P4UP contains the shapes for all 256 characters in the 8-bit ASCII code.
  157. This includes all the single and double box characters.  A few of the low
  158. numbered characters won't print out because they are intercepted by other
  159. hardware and software and interpreted as special control characters.  
  160.  
  161. Although the box characters meet up across the page, they do not meet up
  162. vertically.  P4UP uses 12 lines per inch vertically.  Since all P4UP 
  163. characters are formed with 16 dots per line, P4UP would have to print at
  164. 18.75 lines per inch (300 dots per inch / 16 dots per line), to achieve
  165. vertical connections.  This would make normal text unreadable.
  166.  
  167. The following table shows the P4UP character set:
  168.  
  169.                         
  170.          !"#$%&'()*+,-./    0123456789:;<=>?
  171.         @ABCDEFGHIJKLMNO    PQRSTUVWXYZ[\]^_
  172.         `abcdefghijklmno    pqrstuvwxyz{|}~
  173.         ÇüéâäàåçêëèïîìÄÅ    ÉæÆôöòûùÿÖÜ¢£¥₧ƒ
  174.         áíóúñѪº¿⌐¬½¼¡«»    ░▒▓│┤╡╢╖╕╣║╗╝╜╛┐
  175.         └┴┬├─┼╞╟╚╔╩╦╠═╬╧    ╨╤╥╙╘╒╓╫╪┘┌█▄▌▐▀
  176.         αßΓπΣσµτΦΘΩδ∞φε∩    ≡±≥≤⌠⌡÷≈°∙·√ⁿ²■  
  177.  
  178.         P4UP - A Text Printing Utility
  179.         ______________________________
  180.  
  181.  
  182. The Format Option (-F) and Printer Capabilities
  183. ═══════════════════════════════════════════════
  184. This section contains background information which is necessary only 
  185. if you need to select a printing method for your printer.
  186.  
  187. In graphics mode, P4UP can draw characters in three formats which differ
  188. in the number of dots used to construct each letter.  The more dots, the
  189. better the character looks, but the more memory and time required.  The
  190. three formats are summarized in the following table:
  191.  
  192.     P4UP Graphic Format         -F2      -F3       -F4
  193.     Dots per character (Width)    13    7      8
  194.     Chars per line             160      160       160
  195.     Dots per line needed        2080     1120      1280
  196.  
  197.     Printer type            LJII    LJII       HPTJ
  198.     Resolution (DPI)         300     150     160
  199.     Dots per line available        2400    1200       1280
  200.  
  201.     Dots per character (Height)   16        8         8
  202.     Bytes per char  (W*H/8)          26    7      8
  203.     Lines per page             122      122       122
  204.     Chars per page           19520    19520     19520
  205.     Printer memory needed        495K     133K      152K
  206.  
  207. Printer Requirements
  208. If your printer supports soft fonts in the HPLJII format, use -F0 to print.
  209. If your printer supports soft fonts in the HPDJ format, use -F1 to print.
  210. These soft font methods result in the fastest, clearest printing. 
  211.  
  212. If your printer supports 300 dots per inch and has at least 500K of AVAILABLE
  213. memory, but doesn't accept the soft fonts used in -F0 or -F1, you can use -F2,
  214. which draws each page in graphics mode at 300 dots per inch.  -F2 uses 13 dot
  215. characters, so a full page requires 495K bytes of data to be sent to the
  216. printer.  This can be a tight fit in 500K.  Using 300 dots per inch, you may
  217. encounter problems such as the HP errors codes 20 or 21, especially on pages
  218. with every line filled with 80 characters.  These errors mean that the page 
  219. contains too much data for the printer to handle.  In this case, you must use
  220. method -F3, which draws each page at 150 dots per inch.
  221.  
  222. You might want to use -F3 anyway to save printing time and memory. -F3 prints 
  223. faster but with somewhat coarser characters. -F3 requires about half the time 
  224. and one quarter the memory requirements of -F2.  Since there are only 1200 
  225. dots per line at 150 dots per inch, P4UP uses 7 dots per character for -F3.
  226.  
  227. The HP ThinkJet supports 1280 dots per line.  This allows P4UP to use 8 dot
  228. characters.  Since the ThinkJet prints each line as it receives it, there
  229. is no memory problem.  Use -F4 if you run the ThinkJet in Native mode
  230. (switch 5 down) and -F5 if you run it in Emulation mode (switch 5 up).
  231.  
  232. The HPLJ+ is similar to the HPLJII, but the soft fonts available in P4UP do
  233. not run on the HPLJ+.  If you want to run P4UP on the HPLJ+, you will have to
  234. use -F3 (150dpi graphics).  Although the HPLJ+ has 500K of memory, some of it
  235. is used up by the printer, so there will not be enough memory to run -F2.
  236.  
  237.         P4UP - A Text Printing Utility
  238.         ______________________________
  239.  
  240.  
  241. Font Management Options (-P, -R, and -I) for HPLJ II and HPDJ
  242. ═════════════════════════════════════════════════════════════ 
  243. This section contains information on managing soft fonts, which are
  244. used by P4UP on the HPLJ II and HPDJ and compatibles.  This information
  245. is not necessary for normal operation.
  246.  
  247. On the HPLJII and HPDJ, P4UP generates and downloads a font with a
  248. point size of 3.8 and a pitch of 21.4.    This allows 171 characters
  249. to be printed across an 8 1/2 inch page, and this font can be printed
  250. at 12 lines per inch, allowing 120 lines to be printed down an 11 inch
  251. page.    You can make the P4UP soft font permanent for use with other
  252. software besides P4UP, although other software might require a special
  253. print driver or setup command to use the soft font.
  254.  
  255. Soft font printers have two classes of soft fonts, temporary and permanent.
  256. Temporary soft fonts are erased whenever the printer is reset, something
  257. that occurs during many print operations.  Permanent soft fonts are 
  258. retained until software specifically removes them, or until the printer
  259. is turned off.  
  260.  
  261. Normally, P4UP marks its font as temporary.  It is downloaded every time
  262. you use P4UP, and lasts only for the duration of the P4UP command.  If you
  263. plan to use P4UP several times in succession, you can tell P4UP to make 
  264. the font permanent in the first P4UP command, and all subsequent P4UP
  265. commands to bypass the downloading operation.  This will save some time.  
  266. The font takes up about 15K of your printer's memory.  To mark the font as
  267. permanent, enter:
  268.             P4UP -P
  269. The -P option makes the font Permanent in the LaserJet (until the
  270. printer is turned off).  Without the -P option, the P4UP font lasts
  271. only for the duration of the P4UP command.
  272.  
  273. In subsequent commands, use the R option:
  274.             P4UP -R filename
  275. The -R option tells P4UP to Reuse a Resident font (after a previous
  276. P4UP used the -P option).  Normally the font is downloaded anew with
  277. each P4UP invocation.  If you run P4UP with the -R option but the font
  278. is not resident, P4UP will use the built-in line printer font.  Since
  279. this font cannot support the necessary 171 characters, pages along the
  280. right hand side will be truncated.  Once the font is made permanent, you
  281. can use it with other software.  Select the soft font by calling for a
  282. portrait font with a pitch of 21.4 or identifying it by font id.  The
  283. font can be printed at 12 lines per inch.  A complete indentification of
  284. the P4UP font in printer language is:    E&l0OE(10UE(s0p21.43h3.84v0s0b3T
  285. where the E's stand for the Escape character.  In English, this means:
  286. portrait orientation; PC-8 symbol set; fixed spaced; 21.43 pitch; 3.84
  287. point; upright style; medium stroke; courier typeface.
  288.  
  289. The -I option can be used to give the soft font a specific font id.  Normally
  290. P4UP gives its font the id 1.  You can give it a different id with the -I
  291. option, as in -I33.  Pick an id not in use by other programs.  If you make
  292. the font Permanent, you can use this ID later to select the font.
  293.  
  294.  
  295.         P4UP - A Text Printing Utility
  296.         ______________________________
  297.  
  298.  
  299. What? No Phone? No Credit Cards?
  300. ════════════════════════════════
  301. When I asked my bank if I could take credit cards, they told me they 
  302. hate mail-order sales; they hate businesses run from home without a
  303. store front; and they hate small-volume businesses.  So, sorry, but 
  304. you'll have to pay by check.
  305.  
  306. I was thinking of getting a business phone put in, but no credit card
  307. sales means I can't get any good news by phone.  I hope that shareware
  308. marketing of a simple program will let me get away with it.  You've
  309. already got a copy of the program.  You already know whether it works or 
  310. not on your system.  There aren't many questions that need answering.
  311.  
  312. The Public (Software) Library doesn't have my problem with banks.  If you
  313. choose, you can order and register P4UP from PSL (MC/Visa Accepted):
  314.     Call:        1-800-2424-PSL (for orders only)
  315.             1-713-665-7017 (for information)
  316.     or write:    Public (Software) Library
  317.             P.O. Box 35705
  318.             Houston, TX  77235-5705
  319. With each registration you get a credit towards future PSL disk orders.
  320.  
  321.  
  322. If you have criticisms, suggestions for improvements, or requests for
  323. support of a particular printer, I'd love to hear from you.  If you need
  324. a quick response, you can leave an EasyPlex message for me on CompuServe;
  325. my account number is 76064,1776.
  326.  
  327.  
  328.  
  329.  
  330. Acknowledgement
  331. ═══════════════
  332. The rough edges of the soft font used by P4UP were smoothed out using
  333. FONTFIX.  This and other SoftFontWare programs are available from:
  334.             S. H.  Moody & Associates, Inc.
  335.             1810 Fair Oaks Avenue
  336.             South Pasadena, CA  91030
  337.             
  338.  
  339.  
  340.  
  341. A Note on this Document
  342. ═══════════════════════
  343. This documentation file is formatted with 60-line pages making use of a
  344. feature of P4UP.  If you are using an HPLJII or compatible that is attached
  345. as LPT1, you can print this document with the command:
  346.  
  347.             P4UP P4UP.DOC
  348.  
  349.  
  350.  
  351.         P4UP - A Text Printing Utility
  352.         ______________________________
  353.  
  354.  
  355. Shareware
  356. ═════════
  357. P4UP is distributed as shareware:  try it before you buy it.  Make sure it
  358. works on your system to your liking.  Shareware is NOT freeware - unless you
  359. pay for it, you don't have the right to continue using it beyond a test period.
  360.  
  361. ASP
  362. ═══
  363. Hexagon Products is a member of The Association of Shareware Professionals
  364. (ASP).  ASP has established stringent standards for its members.  ASP wants
  365. to make sure that the shareware principle works for you.  If you are unable
  366. to resolve a problem with an ASP member (other than technical support), ASP
  367. may be able to help.  Please write to the ASP Ombudsman at PO Box 5786,
  368. Bellvue, WA 98006.
  369.  
  370. Disk Vendors, Bulletin Boards, and Users Groups
  371. ═══════════════════════════════════════════════
  372. ASP is in the process of establishing guidelines for the distribution of
  373. shareware.  Contact them and ask to be informed of their progress.  In general,
  374. you may distribute this program as long as the following guidelines are met:
  375.  
  376.     You should distribute all files that make up the program essentially
  377.      unchanged.
  378.  
  379.     You should charge less than $10 for distribution of the program.
  380.  
  381.     You should be sure your customers know the program is not free but
  382.     is shareware, and that payment for your distribution is not payment
  383.     to the author.
  384.  
  385.     You should forward copies of problems or complaints about this program 
  386.     to the author.  In return, the author will make an attempt to answer
  387.     such problems or complaints.
  388.  
  389.     You should let the author know that you are distributing the program,
  390.     if possible by sending the author a copy of your catalog or literature
  391.     that mentions the program.  In return, the author will supply you 
  392.     with updates or corrections to the program.
  393.  
  394.     You should distribute the latest version of the program when it is
  395.     made available to you. 
  396.  
  397.  
  398.  
  399.         P4UP - A Text Printing Utility
  400.         ______________________________
  401.  
  402. Registration
  403. ════════════
  404. The price of P4UP is $29.95.  All registered users will also receive P4CUSTOM,
  405. a program that can set the default values for all P4UP options at whatever
  406. you choose.  For HPLJ II users, you also get a small landscape soft font that
  407. prints 240 characters across the page, suitable for spreadsheet printing.
  408.  
  409. Send your check to:
  410.             
  411.             P4UP
  412.             Hexagon Products
  413.             P.O. Box 1295
  414.             Park Ridge, IL  60068-1295
  415.  
  416. When you register P4UP, please include the following information which will
  417. be used for further product development.
  418.  
  419.  
  420.     Name: ___________________________________________________
  421.  
  422.  
  423.     Company: ________________________________________________
  424.  
  425.  
  426.     Address: ________________________________________________
  427.  
  428.  
  429.     City: ___________________________________ State: ________
  430.  
  431.  
  432.     Zip: _________________ Phone: ___________________________
  433.  
  434.     
  435.     Please circle what you use:        DOS    OS/2
  436.  
  437.  
  438.             VGA    EGA    CGA    HERC    MONO
  439.  
  440.  
  441.                         Mouse    NoMouse
  442.  
  443.  
  444.     What kind of printer do you use? ________________________
  445.  
  446.  
  447.     Where did you find P4UP? ________________________________
  448.