home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / h / hpp103.zip / HPP.DOC next >
Text File  |  1992-08-04  |  18KB  |  460 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                                H P P
  11.  
  12.  
  13.                      version 1.03  (12 July 1992)
  14.  
  15.                           Jurgen A. Doornik
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.     1. Introduction.
  26.     ___________________________________________________________________
  27.  
  28.     HPP is a print utility for Hewlett Packard (tm) compatible laser
  29.     printers. It facilitates printing of more than one column of text,
  30.     either in landscape, or in portrait orientation. As a default it
  31.     will print two columns in landscape, using the small internal
  32.     lineprinter font. HPP can also print PCX files in four different
  33.     resolutions. HPP does not support gray levels, but can print many
  34.     PCX files on one page.
  35.  
  36.     As a first action, you might wish to print this file using the
  37.     following Dos command
  38.  
  39.         HPP hpp.doc
  40.  
  41.     If you have any suggestions for improvement, or find any bugs,
  42.     please report them to me, via email:
  43.  
  44.        INTERNET: ECONZ@UK.AC.OX.VAX
  45.  
  46.     or by mail:
  47.  
  48.     Jurgen Doornik
  49.     Institute of Economics and Statistics
  50.     St Cross Building, Manor Road
  51.     Oxford OX1 3UL
  52.     United Kingdom
  53.     FAX +44 - 865 - 271094
  54.  
  55.     Special thanks are due to Marius Ooms and Arjen Merckens for
  56.     comments on earlier releases of HPP.
  57.     Arjen is author of the popular program called ACD (ChDir FAST;
  58.     more features than LCD/NCD and free).
  59.  
  60.  
  61.     2. HPP help screen
  62.     ___________________________________________________________________
  63.  
  64.     If you just type HPP, the following help screen is shown
  65.     (the square brackets indicate that the argument is optional, the
  66.     braces show the default):
  67.  
  68.     HPP version 1.00 (C) J.A. Doornik, 1991,1992.
  69.     Hewlett Packard (tm) printer utility
  70.     Usage:  HPP filemask [range] [#] [&outfile] [@cmndfile] [/options]
  71.  
  72.     filemask:      {} valid file mask
  73.     range:         {1..-1} #-#,  print file from line # to #, -1=EOF
  74.     line numbering:{} #, #=number lines
  75.     outfile:       {&LPT1} redirect to file or device
  76.     cmndfile:      file with options
  77.     /options
  78.     printer setup: {hpp.ini} NOINIT NORESET NOEXIT
  79.     printer code:  ESC.....
  80.     paper type:    {A4} EXECUTIVE LEGAL LETTER
  81.     paper source:  {} DECK LOWERTRAY MANUAL TRAY
  82.     paper side:    {} DUPLEX, SHORT LONG, both invoke double sided printing
  83.     paper layout:  {L2} P# L#, P=portait L=landscape #=no of columns
  84.     font select:   {FI10U FH16.67} F# FI# FH# FV# FS# FB# FT#
  85.     print side:    {} ODD EVEN
  86.     print size:    {CPI16.67}, CPI# LPP#, of characters per inch in font
  87.                    and no of printed lines per page
  88.     print margin:  {ML4 MR3 MT2 MB1}, in rows/columns
  89.     box layout:    {FILE7 PAGE9} NOBOX FILE# PAGE# PRESCAN USA,
  90.                    #=7891230,-7913
  91.     various:       {} NOFF, ignore form feeds
  92.     pcx print:     {MONO4} MONO#, #=1..4 1=smallest,4=largest; REVERSE
  93.  
  94.  
  95.     3. Some general notes
  96.     ___________________________________________________________________
  97.  
  98.     - It is advised, when using command line arguments, to keep them
  99.       in the same order as on the help screen.
  100.     - Older printers like the Laserjet, Laserjet+ and Laserjet 500
  101.       do not have the upper ascii characters in their font.
  102.     - Older printers like the Laserjet, Laserjet+ and Laserjet 500
  103.       do not support PCX printing in landscape orientation.
  104.     - Only recent printers like the IIId support duplex printing.
  105.       For other printers each side of the page has to be printed
  106.       separately.
  107.  
  108.  
  109.     4. HPP command line arguments
  110.     ___________________________________________________________________
  111.  
  112.     HPP supports the following command line arguments:
  113.  
  114.         filemask [range] [#] [&outfile] [@cmndfile] [/options]
  115.  
  116.     The square brackets indicate that the argument is optional.
  117.  
  118.     - filemask
  119.       The file(s) to be printed. Wildcards are allowed. So
  120.           HPP *.doc
  121.       will print all files with the doc extension; and
  122.           HPP pic??.pcx
  123.       will print all the PCX files matching the mask (each
  124.       on a separate page).
  125.       It is possible to print more than one image on a page, e.g.
  126.           HPP pic1.pcx+pic2.pcx /mono2 /p1
  127.       Now you will get two graphs on the page. This feature is
  128.       discussed under the /MONO# option. No spaces are allowed
  129.       in the filemask.
  130.  
  131.     - range
  132.       Only print the selected lines. To just print lines 100 to 200
  133.       of hpp.doc:
  134.           HPP hpp.doc 100..200
  135.  
  136.     - #
  137.       Number the lines, e.g.
  138.           HPP hpp.doc #
  139.  
  140.     - &outfile
  141.       Sets the destination to outfile, where outfile is either a
  142.       file or a device.
  143.       Devices are LPT1, LPT2, LPT3, COM1, COM2, COM3, PRN.
  144.       HPP writes to LPT1..LPT3 through bios function, enabling it
  145.       to detect whether the printer is ready. To the other four
  146.       devices it writes in the normal way. This will lead to a
  147.       message saying that the files already exist, if the device
  148.       is indeed a printer, just press Y to overwrite.
  149.       Finally you can print to a file, and send the file to a
  150.       printer later.
  151.       To print hpp.doc on LPT2, type:
  152.           HPP hpp.doc &lpt2
  153.       to print hpp.doc to a file, e.g. hpp.prn, type:
  154.           HPP hpp.doc &hpp.prn
  155.       Then you can send it to the printer as follows:
  156.           COPY hpp.prn /B PRN:
  157.       Of course you cannot use HPP to send hpp.prn to the printer.
  158.  
  159.     - @cmndfile
  160.       Instead of passing arguments to HPP on the command line, you
  161.       can type them in a file, and then pass the file on to HPP.
  162.       This is useful if you use a certain format often.
  163.  
  164.     - /options
  165.       These are discussed below.
  166.  
  167.  
  168.     5. HPP options
  169.     ___________________________________________________________________
  170.  
  171.     This section explains the options. They must always be preceeded
  172.     by a forward slash (/) or a minus sign (-).
  173.  
  174.     - printer setup: {hpp.ini} NOINIT NORESET NOEXIT
  175.       HPP operates as follows:
  176.       1. printer reset command, unless /noreset issued
  177.       2. do commands in hpp.ini, unless /noinit issued.
  178.          HPP wil first look for hpp.ini in the current directory,
  179.          if it cannot find it, HPP will look in the directory
  180.          where HPP.EXE resides.
  181.       3. print the files
  182.       4. printer reset command, unless /noexit issued
  183.       So to skip 1,2, and 4:
  184.           HPP hpp.doc /noreset /noinit /noexit
  185.  
  186.     - printer code:  ESC.....
  187.       Send an escape code to the printer, use e.g.
  188.           HPP hpp.doc /ESC&l2X
  189.       to print two copies of hpp.doc.
  190.  
  191.     - paper type:    {A4} EXECUTIVE LEGAL LETTER
  192.       Tells HPP what format paper is being used.
  193.  
  194.     - paper source:  {} DECK LOWERTRAY MANUAL TRAY
  195.       Used if the paper has to come from another source than the
  196.       default.
  197.  
  198.     - paper side:    {} DUPLEX SHORT LONG
  199.       Both short and long invoke double sided printing. If you also
  200.       issue the duplex command (before either short or long), HPP
  201.       will assume that the printer supports double sided printing
  202.       (eg. the Hewlett Packard IIId).
  203.       Otherwise the paper has to be fed in twice, odd sides first.
  204.       After this, HPP will ask you to put the odd pages back into
  205.       the printer tray, advising you on the positioning (hpp at top,
  206.       or hpp at bottom; hpp is the print logo in the bottom right
  207.       of the printed page). This advice works for printers which
  208.       print on the downward facing side.
  209.  
  210.       Short and long relate to the type of binding:
  211.       ┌──────╥──────┐      ┌──────────────┐
  212.       │long  ║      │      │long landscape│
  213.       │por-  ║      │      │      -2-     │
  214.       │trait ║      │      ╞══════════════╡
  215.       │      ║      │      │              │
  216.       │  -2- ║  -3- │      │      -3-     │
  217.       └──────╨──────┘      └──────────────┘
  218.       ┌──────┐             ┌──────────────╥──────────────┐
  219.       │short │             │ short        ║ landscape    │
  220.       │por-  │             │      -2-     ║      -3-     │
  221.       │trait │             └──────────────╨──────────────┘
  222.       │      │
  223.       │  -2- │
  224.       ╞══════╡
  225.       │      │
  226.       │      │
  227.       │      │
  228.       │      │
  229.       │  -3- │
  230.       └──────┘
  231.  
  232.     - paper layout:  {L2} P# L#, P=portait L=landscape #=no of columns
  233.       This is one of the core commands, indicating to HPP the number of
  234.       columns to use, and whether to print in portrait or landscape
  235.       orientation.
  236.       ┌───────┐     ┌───────┐     ┌──────────────┐     ┌──────────────┐
  237.       │ xxxxx │     │ xx xx │     │ xxxxxxxxxxxx │     │ xxxxx  xxxxx │
  238.       │ xxxxx │     │ xx xx │     │ xxxxxxxxxxxx │     │ xxxxx  xxxxx │
  239.       │ xxxxx │     │ xx xx │     │ xxxxxxxxxxxx │     │ xxxxx  xxxxx │
  240.       │ xxxxx │     │ xx xx │     └──────────────┘     └──────────────┘
  241.       │ xxxxx │     │ xx xx │     landscape            landscape
  242.       └───────┘     └───────┘     one column           two columns
  243.       portrait      portrait
  244.       one column    two columns
  245.  
  246.       The default is two columns, landscape (/l2), to change this to
  247.       one column portrait:
  248.           HPP hpp.doc /p1
  249.       Using all default settings, you will get two columns of 66 lines
  250.       by 86 characters; using /P1 you get 98 lines by 118 characters.
  251.  
  252.     - font select:   {FI10U FH16.67} FI# FH# FV# FS# FB# FT# F#
  253.       These commands tell the PRINTER which font to use, you need
  254.       to tell HPP the size of the font, using the print size commands.
  255.       They translate into primary font select escape codes:
  256.       FI# - symbol set
  257.             10U = PC8
  258.       FH# - pitch (horixontal size)
  259.             Characters per inch of the fixed spaced font
  260.       FV# - height (point size, vertical size)
  261.             The height of the font. A point is 1/72 inch.
  262.       FS# - style
  263.             0 = upright, 1 = italic.
  264.       FB# - stroke weight
  265.             -3 = light, 0 = medium, 3 = bold
  266.       FT# - typeface selection              
  267.             0 = line printer, 3 = Courier, etc.
  268.       F#  - font selection by ID.
  269.             # is the ID
  270.  
  271.       The printer will select a font according to the specified
  272.       characteristics, here listed in decreasing priority.
  273.       If only one font matches the first characteristic, that will
  274.       selected, otherwise the second characteristic will be used
  275.       to decide, etc. Consult your printer reference manual for
  276.       further details.
  277.  
  278.     - print side:    {} ODD EVEN
  279.       Instruct HPP to only print odd or even sides.
  280.  
  281.     - print size:    {CPI16.67}, CPI# LPP#, of characters per inch in font
  282.                      and no of printed lines per page
  283.       In order to decide on a proper page layout, hpp needs to now
  284.       how many characters to print in an inch, and how many lines
  285.       to put on a page. If LPP is not specified, lines per inch is
  286.       set to LPI = 0.57 * CPI. From this LPP is then derived, using
  287.       the physical page size and the print margins. The printer is
  288.       instructed to set a vertical motion index corresponding to LPP.
  289.       This implies that LPP does not need to match the height of the font.
  290.       On the other hand, CPI must match the font pitch exactly. No
  291.       horizontal motion index instruction is sent to the printer.
  292.  
  293.     - print margin:  {ML4 MR3 MT2 MB1}
  294.       These are soft margins: they are maintained internally by HPP.
  295.       (Hard margins would be maintained by the printer.)
  296.       The units are characters for left and right (ML#, MR#), and
  297.       lines for top and bottom (MT#, MB#). The minimum for each margin
  298.       is 1.
  299.  
  300.     - box layout:    {FILE7 PAGE9} NOBOX FILE# PAGE# PRESCAN USA,
  301.                      #=7891230,-7913
  302.       NOBOX instructs HPP not to draw a box around every page.
  303.       FILE# and PAGE# position the file name/date/time and page number
  304.       on the page:
  305.             -7   7   8   9   -9
  306.             ┌─────────────────┐   These numbers are easy to remember:
  307.             │                 │   they correspond to the positioning
  308.             │                 │   on your numeric keypad.
  309.             └─────────────────┘   A 0 indicates not to write.
  310.             -1   1   2   3   -3
  311.  
  312.       So to add as little as possible use: /file0 /page0 /nobox .
  313.  
  314.       PRESCAN tells HPP to scan the file before printing it. Then HPP
  315.       will know the number of pages, and the page count will read
  316.       Page ## of ##.
  317.  
  318.       USA tells HPP to write the date and time in American format
  319.       (mm-dd-yy hh:mm am/pm), instead of European format
  320.       (dd-mm-yy hh:mm 24 hour clock).
  321.  
  322.     - various:       {} NOFF
  323.       Can be used to ignore form feeds (character 12) embedded in the
  324.       file.
  325.  
  326.     - pcx print:     {MONO4} MONO#, #=1..4 1=smallest,4=largest; REVERSE
  327.       If the file to be printed has the PCX extension, HPP assumes
  328.       it is a raster image, saved in the PCX format. HPP prints these
  329.       files efficiently, but with loss of colour information. Every
  330.       colour apart from the background is translated to black.
  331.       /Reverse will reverse the colours.
  332.  
  333.       The actual size of the image depends on the graphics mode in which
  334.       it is was saved. Some common sizes are:
  335.           Graphics mode    Graphics card
  336.           720 x 348        Hercules
  337.           320 x 200        CGA/EGA/VGA/SVGA
  338.           640 x 200        CGA/EGA/VGA/SVGA
  339.           640 x 350        EGA/VGA/SVGA
  340.           640 x 480        VGA/SVGA
  341.           800 x 600        SVGA
  342.  
  343.       Four sizes are supported:
  344.           MONO1 - 300 dots/inch, corresponds to 1 dot for each pixel.
  345.                   This gives the smallest graphs. A 640 x 480 image
  346.                   will be tiny.
  347.           MONO2 - 150 dots/inch, corresponds to 2 x 2 dots for each pixel.
  348.           MONO3 - 100 dots/inch, corresponds to 3 x 3 dots for each pixel.
  349.           MONO4 -  75 dots/inch, corresponds to 4 x 4 dots for each pixel.
  350.                   This gives the largest graphs. A 640 x 480 image
  351.                   will only just fit on an A4 page in portrait mode.
  352.  
  353.       On printers which don't support raster graphics printing along
  354.       the logical side of the page, you will have to issue the /p1
  355.       command. Landscape printing won't work, and without it your
  356.       graph will be squashed up in a tiny area of the page.
  357.  
  358.       Another paper saving feature is the option to print more than
  359.       one graph on a page. Two 800 x 600 super VGA pictures will
  360.       fit nicely in portrait mode:
  361.           HPP svga1.pcx+svga2.pcx /mono2 /p1
  362.  
  363.       If your printer supports landscape graphics printing, you
  364.       can fit four 640 x 480 images on a page, e.g.
  365.           HPP pic1.pcx+pic2.pcx+pic3.pcx+pic4.pcx /mono2
  366.       assuming the number of columns is two (which is the default).
  367.       It is your responsibility to select appropriate scaling
  368.       (hence the /mono2).
  369.  
  370.       If you wish to push it further, you can e.g. fit 15 images
  371.       of resolution 640 x 480 on a page using /p3 /mono1 /file0.
  372.       Now the command line argument might get too long, so that
  373.       you will have to rename the pcx files to 1.pcx, 2.pcx etc.
  374.  
  375.  
  376.     6. License, warranty and disclaimer.
  377.     ___________________________________________________________________
  378.  
  379.     HPP is written by Jurgen A. Doornik for the IBM PC using
  380.     DOS 3.0 or later. The following restrictions apply to the
  381.     use of HPP:
  382.  
  383.     o   Private Use
  384.  
  385.         The use of HPP on privately owned machinery is classified
  386.         as private use. Private use of HPP is free of charge.
  387.  
  388.         HPP may be distributed for private use given these two
  389.         restrictions:
  390.  
  391.         o   the program shall be supplied in its original, unmodified
  392.             form, which includes this documentation;
  393.  
  394.         o   no fee is charged;
  395.  
  396.  
  397.     o   Non-private Use
  398.  
  399.         Using HPP on a computer which is not privately owned,
  400.         or to print on a printer which is not privately owned is
  401.         classified as non-private use. This includes usage of
  402.         HPP in government or educational institutions.
  403.  
  404.         o   no fee is required if HPP has been received as part
  405.             of another program (provided this is done with my
  406.             permisison). HPP may then be used on the same
  407.             computers as those for which use of the program with
  408.             which HPP is supplied is legal.
  409.  
  410.         o   non-private users may use HPP free of charge for
  411.             a trial period of two weeks. After this period
  412.             a fee is required.
  413.  
  414.         o   in all other cases a fee is required, which depends
  415.             on the number of computers on which HPP is installed.
  416.             Pricing at the date of this document is:
  417.                 1 -  5       $20 per computer
  418.                 6 - 20       $10 per computer
  419.                21 and more   $ 5 per computer
  420.             So 30 computers work out as:
  421.             5 * $20 + 15 * $10 + 10 * $5 = $300
  422.             There is a 50% educational discount. These prices
  423.             relate to electronically distributed copies of HPP,
  424.             and do not include package, posting, VAT or local
  425.             taxes. For network pricing, count the number of
  426.             computers attached to the network.
  427.  
  428.     For any other use contact me.
  429.  
  430.  
  431.  
  432.     Jurgen Doornik          INTERNET: ECONZ@UK.AC.OX.VAX
  433.  
  434.     Institute of Economics and Statistics
  435.     St Cross Building, Manor Road
  436.     Oxford OX1 3UL
  437.     United Kingdom
  438.     FAX +44 - 865 - 271094
  439.  
  440.  
  441.  
  442.     DISCLAIMER:
  443.     I shall not be responsible for any damages or inconveniences
  444.     incurred due to the usage of HPP. More formally:
  445.  
  446.     IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW WILL JURGEN DOORNIK BE
  447.     LIABLE TO YOU FOR DAMAGES, INCLUDING ANY LOST PROFITS, LOST MONIES, OR
  448.     OTHER SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
  449.     USE OR INABILITY TO USE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR
  450.     DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY THIRD PARTIES)
  451.     THESE PROGRAMS, EVEN IF YOU HAVE BEEN ADVISED OF THE POSSIBILITY OF
  452.     SUCH DAMAGES, OR FOR ANY CLAIM BY ANY OTHER PARTY.
  453.  
  454.  
  455.     7. Revision history.
  456.     ___________________________________________________________________
  457.  
  458.      2- 7-92: released version 1.03
  459.  
  460.