home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / LASER / P4UP.ZIP / P4UP.DOC < prev    next >
Encoding:
Text File  |  1988-12-16  |  19.0 KB  |  458 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, LaserJet+, and DeskJet, P4UP
  11. builds and downloads its own soft font.  On other printers which cannot use
  12. these soft 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, LJ+, 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 HP LJII, LJ+, and DJ.  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 HPLJ II 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 
  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 in Native mode (switch 5 down).
  103.     -F5 (HPTJ) is for the HPThinkJet in Emulation mode (switch 5 up).
  104.     -F6 (HPLJ+) is for laser printers which use HPLJ + soft fonts.
  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. (-F6 doesn't define characters in the range of 0-31 or 128-160.) 
  161.  
  162. Although the box characters meet up across the page, they do not meet up
  163. vertically.  P4UP uses 12 lines per inch vertically.  Since all P4UP 
  164. characters are formed with 16 dots per line, P4UP would have to print at
  165. 18.75 lines per inch (300 dots per inch / 16 dots per line), to achieve
  166. vertical connections.  This would make normal text unreadable.
  167.  
  168. The following table shows the P4UP character set:
  169.  
  170.                         
  171.          !"#$%&'()*+,-./    0123456789:;<=>?
  172.         @ABCDEFGHIJKLMNO    PQRSTUVWXYZ[\]^_
  173.         `abcdefghijklmno    pqrstuvwxyz{|}~
  174.         ÇüéâäàåçêëèïîìÄÅ    ÉæÆôöòûùÿÖÜ¢£¥₧ƒ
  175.         áíóúñѪº¿⌐¬½¼¡«»    ░▒▓│┤╡╢╖╕╣║╗╝╜╛┐
  176.         └┴┬├─┼╞╟╚╔╩╦╠═╬╧    ╨╤╥╙╘╒╓╫╪┘┌█▄▌▐▀
  177.         αßΓπΣσµτΦΘΩδ∞φε∩    ≡±≥≤⌠⌡÷≈°∙·√ⁿ²■  
  178.  
  179.         P4UP - A Text Printing Utility
  180.         ______________________________
  181.  
  182.  
  183. The Format Option (-F) and Printer Capabilities
  184. ═══════════════════════════════════════════════
  185. This section contains background information which is necessary only 
  186. if you need to select a printing method for your printer.
  187.  
  188. In graphics mode, P4UP can draw characters in three formats which differ
  189. in the number of dots used to construct each letter.  The more dots, the
  190. better the character looks, but the more memory and time required.  The
  191. three formats are summarized in the following table:
  192.  
  193.     P4UP Graphic Format         -F2      -F3       -F4
  194.     Dots per character (Width)    13    7      8
  195.     Chars per line             160      160       160
  196.     Dots per line needed        2080     1120      1280
  197.  
  198.     Printer type            LJII    LJII       HPTJ
  199.     Resolution (DPI)         300     150     160
  200.     Dots per line available        2400    1200       1280
  201.  
  202.     Dots per character (Height)   16        8         8
  203.     Bytes per char  (W*H/8)          26    7      8
  204.     Lines per page             122      122       122
  205.     Chars per page           19520    19520     19520
  206.     Printer memory needed        495K     133K      152K
  207.  
  208. Printer Requirements
  209. On the HPLJII and compatibiles, use -F0 to print.  On the HPLJ+, use -F6
  210. to print.  On the DeskJet with the 128K memory cartridge, use -F1 to print.
  211. These soft font methods result in the fastest, clearest printing.  On the 
  212. DeskJet without the memory cartridge, use graphics format -F2 or -F3.  The
  213. original HP LaserJet does not support soft fonts, print graphics a line at
  214. a time, or contain enough memory to hold a whole page of graphics.  P4UP
  215. will not run on the HP LaserJet.
  216.  
  217. If your printer supports 300 dots per inch and has at least 500K of AVAILABLE
  218. memory, but doesn't accept the soft font formats, you can use -F2, which draws
  219. each page in graphics mode at 300 dots per inch.  -F2 uses 13 dot characters,
  220. so a full page requires 495K bytes of data to be sent to the printer.  This
  221. can be a tight fit in 500K.  Using 300 dots per inch, you may encounter
  222. problems such as the HP errors codes 20 or 21, especially on pages with every 
  223. line filled with 80 characters.  These errors mean that the page contains too
  224. much data for the printer to handle.  In this case, you must use method -F3,
  225. which draws each page at 150 dots per inch.
  226.  
  227. You might want to use -F3 anyway to save printing time and memory. -F3 prints 
  228. faster but with somewhat coarser characters. -F3 requires about half the time 
  229. and one quarter the memory requirements of -F2.  Since there are only 1200 
  230. dots per line at 150 dots per inch, P4UP uses 7 dots per character for -F3.
  231.  
  232. The HP ThinkJet supports 1280 dots per line.  This allows P4UP to use 8 dot
  233. characters.  Since the ThinkJet prints each line as it receives it, there
  234. is no memory problem.  Use -F4 if you run the ThinkJet in Native mode
  235. (switch 5 down) and -F5 if you run it in Emulation mode (switch 5 up).
  236.  
  237.  
  238.         P4UP - A Text Printing Utility
  239.         ______________________________
  240.  
  241.  
  242. Font Management Options (-P, -R, and -I) for HP LJII, LJ+, and DJ
  243. ═════════════════════════════════════════════════════════════════
  244. This section contains information on managing soft fonts, which are used
  245. by P4UP on the HP LJII, LJ+, and DJ and compatibles.  This information
  246. is not necessary for normal operation.
  247.  
  248. On the HPLJII, HPLJ+, and HPDJ, P4UP generates and downloads a font with a
  249. point size of 3.8 and a pitch of 21.4.    This allows 171 characters
  250. to be printed across an 8 1/2 inch page, and this font can be printed
  251. at 12 lines per inch, allowing 120 lines to be printed down an 11 inch
  252. page.    You can make the P4UP soft font permanent for use with other
  253. software besides P4UP, although other software might require a special
  254. print driver or setup command to use the soft font.
  255.  
  256. Soft font printers have two classes of soft fonts, temporary and permanent.
  257. Temporary soft fonts are erased whenever the printer is reset, something
  258. that occurs during many print operations.  Permanent soft fonts are 
  259. retained until software specifically removes them, or until the printer
  260. is turned off.  
  261.  
  262. Normally, P4UP marks its font as temporary.  It is downloaded every time
  263. you use P4UP, and lasts only for the duration of the P4UP command.  If you
  264. plan to use P4UP several times in succession, you can tell P4UP to make 
  265. the font permanent in the first P4UP command, and all subsequent P4UP
  266. commands to bypass the downloading operation.  This will save some time.  
  267. The font takes up about 15K of your printer's memory.  To mark the font as
  268. permanent, enter:
  269.             P4UP -P
  270. The -P option makes the font Permanent in the LaserJet (until the
  271. printer is turned off).  Without the -P option, the P4UP font lasts
  272. only for the duration of the P4UP command.
  273.  
  274. In subsequent commands, use the R option:
  275.             P4UP -R filename
  276. The -R option tells P4UP to Reuse a Resident font (after a previous
  277. P4UP used the -P option).  Normally the font is downloaded anew with
  278. each P4UP invocation.  If you run P4UP with the -R option but the font
  279. is not resident, P4UP will use the built-in line printer font.  Since
  280. this font cannot support the necessary 171 characters, pages along the
  281. right hand side will be truncated.  Once the font is made permanent, you
  282. can use it with other software.  Select the soft font by calling for a
  283. portrait font with a pitch of 21.4 or identifying it by font id.  The
  284. font can be printed at 12 lines per inch.  A complete indentification of
  285. the P4UP font in printer language is:    E&l0OE(10UE(s0p21.43h3.84v0s0b3T
  286. where the E's stand for the Escape character.  In English, this means:
  287. portrait orientation; PC-8 symbol set; fixed spaced; 21.43 pitch; 3.84
  288. point; upright style; medium stroke; courier typeface.
  289.  
  290. The -I option can be used to give the soft font a specific font id.  Normally
  291. P4UP gives its font the id 1.  You can give it a different id with the -I
  292. option, as in -I33.  Pick an id not in use by other programs.  If you make
  293. the font Permanent, you can use this ID later to select the font.
  294.  
  295.  
  296.         P4UP - A Text Printing Utility
  297.         ______________________________
  298.  
  299.  
  300. What? No Phone? No Credit Cards?
  301. ════════════════════════════════
  302. When I asked my bank if I could take credit cards, they told me they 
  303. hate mail-order sales; they hate businesses run from home without a
  304. store front; and they hate small-volume businesses.  So, sorry, but 
  305. you'll have to pay by check.
  306.  
  307. I was thinking of getting a business phone put in, but no credit card
  308. sales means I can't get any good news by phone.  I hope that shareware
  309. marketing of a simple program will let me get away with it.  You've
  310. already got a copy of the program.  You already know whether it works or 
  311. not on your system.  There aren't many questions that need answering.
  312.  
  313. The Public (Software) Library doesn't have my problem with banks.  If you
  314. choose, you can order and register P4UP from PSL (MC/Visa Accepted):
  315.     Call:        1-800-2424-PSL (for orders only)
  316.             1-713-665-7017 (for information)
  317.     or write:    Public (Software) Library
  318.             P.O. Box 35705
  319.             Houston, TX  77235-5705
  320. With each registration you get a credit towards future PSL disk orders.
  321.  
  322.  
  323. If you have criticisms, suggestions for improvements, or requests for
  324. support of a particular printer, I'd love to hear from you.  If you need
  325. a quick response, you can leave an EasyPlex message for me on CompuServe;
  326. my account number is 76064,1776.
  327.  
  328.  
  329.  
  330.  
  331. Acknowledgement
  332. ═══════════════
  333. The rough edges of the soft font used by P4UP were smoothed out using
  334. FONTFIX.  This and other SoftFontWare programs are available from:
  335.             S. H.  Moody & Associates, Inc.
  336.             1810 Fair Oaks Avenue
  337.             South Pasadena, CA  91030
  338.             
  339.  
  340.  
  341.  
  342. A Note on this Document
  343. ═══════════════════════
  344. This documentation file is formatted with 60-line pages making use of a
  345. feature of P4UP.  If you are using an HPLJII or compatible that is attached
  346. as LPT1, you can print this document with the command:
  347.  
  348.             P4UP P4UP.DOC
  349.  
  350.  
  351.  
  352.         P4UP - A Text Printing Utility
  353.         ______________________________
  354.  
  355.  
  356. Shareware
  357. ═════════
  358. P4UP is distributed as shareware:  try it before you buy it.  Make sure it
  359. works on your system to your liking.  Shareware is NOT freeware - unless you
  360. pay for it, you don't have the right to continue using it beyond a test period.
  361.  
  362. ASP
  363. ═══
  364. Hexagon Products is a member of The Association of Shareware Professionals
  365. (ASP).  ASP has established stringent standards for its members.  ASP wants
  366. to make sure that the shareware principle works for you.  If you are unable
  367. to resolve a problem with an ASP member (other than technical support), ASP
  368. may be able to help.  Please write to the ASP Ombudsman at PO Box 5786,
  369. Bellvue, WA 98006.
  370.  
  371. Disk Vendors, Bulletin Boards, and Users Groups
  372. ═══════════════════════════════════════════════
  373. ASP is in the process of establishing guidelines for the distribution of
  374. shareware.  Contact them and ask to be informed of their progress.  In general,
  375. you may distribute this program as long as the following guidelines are met:
  376.  
  377.     You should distribute all files that make up the program essentially
  378.      unchanged.
  379.  
  380.     You should charge less than $10 for distribution of the program.
  381.  
  382.     You should be sure your customers know the program is not free but
  383.     is shareware, and that payment for your distribution is not payment
  384.     to the author.
  385.  
  386.     You should forward copies of problems or complaints about this program 
  387.     to the author.  In return, the author will make an attempt to answer
  388.     such problems or complaints.
  389.  
  390.     You should let the author know that you are distributing the program,
  391.     if possible by sending the author a copy of your catalog or literature
  392.     that mentions the program.  In return, the author will supply you 
  393.     with updates or corrections to the program.
  394.  
  395.     You should distribute the latest version of the program when it is
  396.     made available to you. 
  397.  
  398.  
  399.  
  400.         P4UP - A Text Printing Utility
  401.         ______________________________
  402.  
  403. Registration
  404. ════════════
  405. The price of P4UP is $29.95.  All registered users will also receive P4CUSTOM,
  406. a program that can set the default values for all P4UP options at whatever
  407. you choose.  For HPLJ II users, you also get a small landscape soft font that
  408. prints 240 characters across the page, suitable for spreadsheet printing.
  409.  
  410. Send your check to:
  411.             
  412.             P4UP
  413.             Hexagon Products
  414.             P.O. Box 1295
  415.             Park Ridge, IL  60068-1295
  416.  
  417. When you register P4UP, please include the following information which will
  418. be used for further product development.
  419.  
  420.  
  421.     Name: ___________________________________________________
  422.  
  423.  
  424.     Company: ________________________________________________
  425.  
  426.  
  427.     Address: ________________________________________________
  428.  
  429.  
  430.     City: ___________________________________ State: ________
  431.  
  432.  
  433.     Zip: _________________ Phone: ___________________________
  434.  
  435.     
  436.     Please circle what you use:
  437.  
  438.  
  439.     Printer:    LJII    LJ500    LJ+    DJ128    DJ    TJ
  440.  
  441.  
  442.     Other: __________________________________________________
  443.  
  444.  
  445.     P4UP Format:    F0    F1    F2    F3    F4    F5    F6
  446.  
  447.  
  448.     Display:    VGA    EGA    CGA    HERC    MONO
  449.  
  450.  
  451.     Oper.Sys:    DOS    OS/2
  452.  
  453.  
  454.     Input Device:    Mouse
  455.  
  456.  
  457.     Where did you find P4UP? ________________________________
  458.