home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / LASER / DOWNLD15.ZIP / DOWNLOAD.DOC < prev    next >
Encoding:
Text File  |  1988-06-14  |  19.2 KB  |  513 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                                  DOWNLOAD
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                                 Version 1.5
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.                  Copyright 1987, 1988 by Elfring Soft Fonts
  33.  
  34.  
  35.  
  36.                              TABLE OF CONTENTS
  37.  
  38.  
  39.      SUMMARY....................................................... 1
  40.  
  41.  
  42.  
  43.  
  44.      REQUIREMENTS.................................................. 1
  45.  
  46.  
  47.  
  48.  
  49.      FONT CHARACTERISTICS.......................................... 1
  50.  
  51.  
  52.  
  53.  
  54.      RUNNING DOWNLOAD.............................................. 2
  55.  
  56.  
  57.  
  58.  
  59.      ARCHIVE FONT STORAGE.......................................... 5
  60.  
  61.  
  62.  
  63.  
  64.      ERROR MESSAGES................................................ 6
  65.  
  66.  
  67.  
  68.  
  69.      DISTRIBUTION.................................................. 7
  70.  
  71.  
  72.  
  73.  
  74.      WARRANTY...................................................... 7
  75.  
  76.  
  77.  
  78.  
  79.      ORDER FORM.................................................... 8
  80.  
  81.  
  82.  
  83.                                   SUMMARY
  84.  
  85.      DOWNLOAD.EXE is an IBM PC utility program that manages the pro-
  86.      cess of downloading soft fonts to a LaserJet, DeskJet, or compatible 
  87.      printer.  DOWNLOAD can also select fonts as they are being downloaded.  
  88.      The commercial version of DOWNLOAD can send a font, or group of 
  89.      fonts, through the standard MS-DOS devices to your LaserJet 
  90.      printer.  It can also extract your fonts from an archive file, 
  91.      which offers significant disk space savings.  You have optional 
  92.      control over the soft font ID number, whether the font is perman-
  93.      ent or temporary, and whether it is a primary or secondary font.  
  94.      A list of fonts may be sent to the printer by specifying the 
  95.      individual fonts names in an ASCII text file.  All fonts resident 
  96.      in your laser may be optionally deleted before fonts are downloaded.
  97.  
  98.      The public domain version of DOWNLOAD will not work with a 
  99.      list of file names, nor will it extract files from an archive.  
  100.      These are the only differences between the public domain and 
  101.      commercial versions of the program.  You may obtain the commer-
  102.      cial version of DOWNLOAD by sending me $25.  See the end of this 
  103.      documentation file for an order form.
  104.  
  105.  
  106.                                REQUIREMENTS
  107.  
  108.      DOWNLOAD requires a minimum of 128K of memory, an HP LaserJet, DeskJet,
  109.      or compatible printer, and a parallel port to talk to the printer.  
  110.      Parallel printer ports LPT1:, LPT2:, LPT3: are supported by the program.  
  111.      If you plan to archive your font files to save disk space you must 
  112.      have a copy the public domain archive program PKXARC.
  113.  
  114.  
  115.  
  116.                            FONT CHARACTERISTICS
  117.  
  118.      All soft fonts have three characteristics associated with them.  
  119.      Each font must have a unique ID number assigned to it.  This lets 
  120.      you select a soft font through software or the front panel of the 
  121.      printer. Each font must be defined as either temporary or perman-
  122.      ent.  Temporary fonts are deleted whenever the LaserJet is reset 
  123.      and are thus not very useful since most software that controls 
  124.      the LaserJet sends a reset command out first, (deleting all temp-
  125.      orary fonts).  Finally, a font may be defined as either primary 
  126.      or secondary.  (Note that only one primary and one secondary font 
  127.      can exist at one time and you don not have to have a primary or 
  128.      secondary font.)  The LaserJet lets you switch between primary 
  129.      and secondary fonts with simple control characters.  Control-N 
  130.      selects the secondary font, while control-O selects the primary 
  131.      font.  Embedding these characters in your text file will let you 
  132.  
  133.  
  134.                                        1
  135.  
  136.  
  137.  
  138.      switch between fonts.
  139.  
  140.      The DOWNLOAD program is designed to send soft fonts to the laser 
  141.      printer and to help you manage all these font characteristics.  
  142.      You can select the font ID number, and font status at the same 
  143.      time that you download the font.  You can also make batch files 
  144.      to manage the process of sending a number of soft fonts to your 
  145.      printer at one time.  Finally, soft fonts may be archived into a 
  146.      common file and automatically extracted for downloading.
  147.  
  148.  
  149.                              RUNNING DOWNLOAD
  150.  
  151.      DOWNLOAD is easy to use.  The only thing you need to remember is 
  152.      that DOWNLOAD will automatically prompt you with a brief descrip-
  153.      tion of how to use it if you want it to.  Simply type DOWNLOAD 
  154.      followed by a carriage return.  The program will print a short 
  155.      explanation of its operation and options as shown below:
  156.  
  157.  
  158.      ┌───────────────────────────────────────────────────────────────┐
  159.      │Send soft fonts to a LaserJet or compatible printer, V1.5      │
  160.      │Copyright 1987, 1988 by Gary Elfring                           │
  161.      │                                                               │
  162.      │                                                               │
  163.      │Use ──> download fontname [device ID ─options]                 │
  164.      │                                                               │
  165.      │  where: everything the between '[]'s is optional and...       │
  166.      │                                                               │
  167.      │   fontname = the name of the font to download or the name of  │
  168.      │              a list of fonts to download preceded by an '@'   │
  169.      │              character                                        │
  170.      │   device   = LPT1, LPT2, or LPT3                              │
  171.      │   ID       = starting ID number to assign font to (0 ─ 32767) │
  172.      │   options  = T to make font temporary, P to make font primary │
  173.      │              S to make font secondary, Q for quiet operat,    │
  174.      │              or D for delete all fonts prior to downloading.  │
  175.      │                                                               │
  176.      │When optional arguments are not present, download defaults to: │
  177.      │LPT1, ID = 0, permanent font, and font is NOT selected. If env─│
  178.      │ironment variable DOWNLOAD is set to a drive, path, and archive│
  179.      │file name─ download will search the archive for the font files │
  180.      │using the PKXARC program.                                      │
  181.      │                                                               │
  182.      │     For example:                                              │
  183.      │download he100rpn.usp lpt1: 5 ─tp                              │
  184.      │download @font.lst ─q                                          │
  185.      │download od300rpn.usp 1000 ─sq LPT2                            │
  186.      └───────────────────────────────────────────────────────────────┘
  187.  
  188.  
  189.                                        2
  190.  
  191.  
  192.  
  193.      To run DOWNLOAD you must specify either the name of the soft font 
  194.      to send to your printer, or the name of a disk file that contains 
  195.      a list of soft fonts to send to the printer.  You can optionally 
  196.      specify the device to send the file to, LPT1, LPT2, or LPT3.  In 
  197.      addition, you can optionally control the three font attributes, 
  198.      (ID number, permanent/temporary, primary/secondary), 
  199.  
  200.      specified above.  To invoke DOWNLOAD type:
  201.  
  202.      download yourfont [port ID# -options]
  203.  
  204.      All items between the "[" and "]" characters are optional.  This 
  205.      means you do not have to include them.  Note that the "[" and "]" 
  206.      characters are not actually used in a command.  Also note that 
  207.      these optional items can be specified in any order.
  208.  
  209.      So, to download a Times-Roman 24 point bold font you would enter:
  210.  
  211.      download tr240bpn.usp
  212.  
  213.      The DOWNLOAD program will find that file, (if it doesn't exist 
  214.      DOWNLOAD will let you know), and defaults to: printer port LPT1, 
  215.      soft font ID 0, and permanent status.  The font will not be sel─
  216.      ected as either primary or secondary.  The screen will look as 
  217.      follows:
  218.  
  219.      ┌───────────────────────────────────────────────────────────────┐
  220.      │Send soft fonts to a LaserJet or compatible printer, V1.5      │
  221.      │Copyright 1987 by Gary Elfring                                 │
  222.      │Sending font tr240bpn.usp with ID 0, 12427 bytes               │
  223.      │Sent 1 file, with a total of 12427 bytes.                      │
  224.      └───────────────────────────────────────────────────────────────┘
  225.  
  226.      A more complicated command might involve using a different print─
  227.      er port and assigning a soft font ID number.  For example:
  228.  
  229.      download tr100bpn.usp 1000 lpt2 ─s
  230.  
  231.      sends the bold faced Times─Roman font to the LaserJet via LPT2: 
  232.      and assigns it font ID 1000, permanent and secondary status.  The 
  233.      secondary status lets you select this font in a document by em─
  234.      bedding a control─N, (you can change back to your primary font 
  235.      with a control─O).
  236.  
  237.      DOWNLOAD is capable of using a list of file names created with any 
  238.      ASCII text editor.  To do this type:
  239.  
  240.      download @fonts.lst 10 
  241.  
  242.  
  243.  
  244.                                        3
  245.  
  246.  
  247.  
  248.      This instructs the program to find the disk file "fonts.lst".  
  249.      This file is assumed to contain a list of font file names to send 
  250.      to the LaserJet.  All files will be sent in the order they appear 
  251.      in the list.  For example, if the file "fonts.lst" looks as fol─
  252.      lows:
  253.  
  254.      he100rpn.usp
  255.      he100bpn.usp
  256.      he100ipn.usp
  257.      he180bpn.usp
  258.      he300bpn.usp
  259.  
  260.      then the command "download @fonts.lst 10" will load all five 
  261.  
  262.      fonts to your LaserJet through LPT1.  The "he100rpn.usp" font 
  263.      will be assigned font ID 10 and loaded first.  Font 
  264.      "he100bpn.usp" will be loaded next with font ID 11.  This process 
  265.      will continue sequentially until font "he300bpn.usp" is sent to 
  266.      the printer as font ID 14.  All fonts will be assigned permanent 
  267.      status.  The screen will look as follows after the downloading 
  268.      process is finished:
  269.  
  270.      ┌───────────────────────────────────────────────────────────────┐
  271.      │Send soft fonts to a LaserJet or compatible printer, V1.5      │
  272.      │Copyright 1987 by Gary Elfring                                 │
  273.      │Sending font he100rpn.usp with ID 0, 12427 bytes               │
  274.      │Sending font he100bpn.usp with ID 1, 18834 bytes               │
  275.      │Sending font he100ipn.usp with ID 2, 33754 bytes               │
  276.      │Sending font he180bpn.usp with ID 3, 48531 bytes               │
  277.      │Sending font he300bpn.usp with ID 4, 68929 bytes               │
  278.      │Sent 5 files, with a total of 133944 bytes.                    │
  279.      └───────────────────────────────────────────────────────────────┘
  280.  
  281.      For a more detailed explanation of soft font ID numbers, and font 
  282.      status see you LaserJet user's manual.
  283.  
  284.      Another useful option is the "D" command.  This command lets you 
  285.      delete all soft fonts resident in your laser printer prior to 
  286.      downloading.  For example, if you have limited font memory you 
  287.      can lose track of how many fonts have been sent to the laser 
  288.      printer.  Rather than blindly sending more fonts, (which can 
  289.      result in a "20" error), you can tell DOWNLOAD to delete 
  290.      all soft fonts first, and then send the new fonts to the printer.
  291.  
  292.      download @batch.lst 1 -d
  293.  
  294.      Finally, the "quiet" option lets you disable much of the screen 
  295.      output from DOWNLOAD.  This is particularly useful with batch 
  296.  
  297.  
  298.  
  299.                                        4
  300.  
  301.  
  302.  
  303.      files since you are probably not interested in file statistics 
  304.      when downloading a batch of files.  To use the quiet option you 
  305.      would type:
  306.  
  307.      download @batch.lst 1000 -qt
  308.  
  309.      This would result in the following display:
  310.  
  311.      ┌───────────────────────────────────────────────────────────────┐
  312.      │Send soft fonts to a LaserJet or compatible printer, V1.5      │
  313.      │Copyright 1987 by Gary Elfring                                 │
  314.      └───────────────────────────────────────────────────────────────┘
  315.  
  316.      Note that the "-t" option used above would give all soft fonts 
  317.      listed above "temporary" status.  They would automatically be 
  318.      erased after the first reset command is sent the the laser 
  319.      printer.
  320.  
  321.  
  322.                            ARCHIVE FONT STORAGE
  323.  
  324.      As previously mentioned, soft fonts may be stored in an archive 
  325.      file.  If DOWNLOAD is told that the fonts reside in an archive 
  326.      file the program will extract each font from the archive file, 
  327.      download (and optionally select it), and then erase the font from 
  328.      your disk.
  329.  
  330.      DOWNLOAD operates in exactly the same manner, whether you are 
  331.      working from an archive file or a disk drive.  All options and 
  332.      control features work in the exact same manner.
  333.  
  334.      So how do you tell DOWNLOAD to look in an archive file instead of 
  335.      a disk drive?  You set a variable in your environment string.  
  336.      The DOWNLOAD program examines the environment strings when it is 
  337.      started and uses this information to decide on the source for 
  338.      soft fonts.  An example might help here.  Use the MS-DOS SET 
  339.      command to define the variable DOWNLOAD as follows:
  340.  
  341.      set download=c:\fonts\fontfile.arc
  342.      
  343.      The download program uses this environment variable to construct 
  344.      a command for the PKXARC program.  Thus the above command tells 
  345.      DOWNLOAD that the \fonts subdirectory on drive C: contains an 
  346.      archive file named fontfile.arc.  If you want to extract the file 
  347.      HE100RPN.USP from this archive DOWNLOAD will construct the fol-
  348.      lowing command to un-archive each font.
  349.  
  350.      pkxarc c:\fonts\fontfile he100rpn.usp
  351.  
  352.  
  353.  
  354.                                        5
  355.  
  356.  
  357.  
  358.      Note that once the SET command is used to define the DOWNLOAD 
  359.      environment variable, the DOWNLOAD program assumes all fonts will 
  360.      be found in the archive file specified by this variable.  To 
  361.      switch DOWNLOAD back to using straight fonts you may use the SET 
  362.      command as follows, or re-boot your computer.
  363.  
  364.      set download=
  365.  
  366.      When using this archived font option you must have a copy of 
  367.      pkxarc located on the current path.  (The program does not have 
  368.      to be in the current directory if you have established a search 
  369.      path using the MS-DOS PATH command.)  In addition, since each 
  370.      font is un-archived, downloaded, and then erased, you must have 
  371.      enough free disk space to un-archive the single largest font 
  372.      contained in this archive file.
  373.  
  374.  
  375.                                ERROR MESSAGES
  376.  
  377.      DOWNLOAD automatically checks the status of your laser printer 
  378.      before sending anything to it.  If the printer is off, not con-
  379.      nected, deselected, or out of paper DOWNLOAD will display an er-
  380.      ror message.  For example, if your printer was out of paper you 
  381.      would see:
  382.  
  383.      download cp300rpn.usp
  384.      Send soft fonts to a LaserJet or compatible printer, V1.5
  385.      Copyright 1987, 1988 by Elfring Soft Fonts
  386.      Sending font cp300rpn.usp with ID 0
  387.      Printer I/O error
  388.      Printer out of paper
  389.      Abort, Retry, Ignore?
  390.  
  391.      Answer with the appropriate letter (A/R/I) followed by a carriage 
  392.      return.  This process lets you select the printer or add more 
  393.      paper to correct the problem.
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.                                        6
  410.  
  411.  
  412.  
  413.  
  414.                                 DISTRIBUTION
  415.  
  416.      This program is provided free of charge to all who are interested 
  417.      in it.  It may be freely exchanged as long as no fee is charged 
  418.      for it. Please distribute this package with BOTH this documenta-
  419.      tion file and the executable program. This program and documenta-
  420.      tion are Copyright 1987, 1988 by Elfring Soft Fonts. All rights are 
  421.      reserved.  Commercial use is strictly prohibited.  Business users
  422.      MUST register this program and pay for this program.  Use of this 
  423.      program on a LAN without a specific LAN license is a violation of 
  424.      the copyright.
  425.  
  426.      An enhanced version of this program, which lets you use a list of 
  427.      fonts to download and works with archived font files, is avail-
  428.      able for $25.00.  This price also includes the DISPFONT & FONTINFO
  429.      utilities.  I offer a large number of different downloadable fonts 
  430.      including Roman-Times, Helvetica, Century, Rockford, Broadway, Script, 
  431.      Old English, Courier, Line Draw, Lotus fonts, and Symbol Sets for both
  432.      laser printers and the DeskJet.  If you don't see the font you are looking 
  433.      for, write me.  I am always making new fonts.  I also do inexpensive
  434.      custom fonts.  In addition I have a number of soft font utility programs 
  435.      including: download- send and select fonts to a LaserJet or DeskJet, 
  436.      dispfont- display a sample sheet of a soft font, and fm- an interactive 
  437.      English based soft font management program.  For more information on these 
  438.      inexpensive downloadable soft fonts for your LaserJet or DeskJet contact 
  439.      me at the address listed below.
  440.  
  441.                                  WARRANTY
  442.  
  443.      None.
  444.  
  445.      Elfring Soft Fonts specifically disclaims all other warranties, ex-
  446.      pressed or implied, including but not limited to, implied war-
  447.      ranties of merchantability and fitness for a particular purpose 
  448.      with respect to defects in the disk or documentation, and the 
  449.      program License granted herein. In no event shall Elfring Soft Fonts 
  450.      be liable for any loss of profit or any other commercial damage, 
  451.      including but not limited to special, incidental, consequential, 
  452.      or other damages.
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.                                        7
  465.  
  466.  
  467.      
  468.                                 ORDER FORM
  469.  
  470.      To order a copy of the commercial version of DOWNLOAD and to receive 
  471.      a copy of my LaserJet & DeskJet font brochure, please fill out the
  472.      following form, and mail it along with a check for $25.00 to:
  473.  
  474.                             Elfring Soft Fonts
  475.                                 P.O. Box 61
  476.                           Wasco, Illinois  60183
  477.                                312-377-3520
  478.  
  479.      Make all checks payable to: Elfring Soft Fonts.  The commercial version 
  480.      of my download program also includes a sampler set of soft fonts for 
  481.      your LaserJet or compatible printer.  These sampler fonts presently 
  482.      include: 10 point, medium, bold, & italic Roman-Times and Helvetica.  
  483.      Also included is a 10 point Script and a 10 point Old English.  All 
  484.      sampler fonts are portrait mode.  Additional fonts may be included 
  485.      along with LaserJet utilities.  All utilities work with the DeskJet 
  486.      and the LaserJet printers.  Sampler fonts are for the LaserJet.  
  487.      (Note, LaserJet fonts will not work on a DeskJet, you need a DeskJet 
  488.      specific font.)
  489.  
  490.  
  491.               Please send me the current version of DOWNLOAD
  492.  
  493.  
  494.      Name:             _________________________________________
  495.  
  496.  
  497.      Address:          _________________________________________
  498.  
  499.  
  500.      Address:          _________________________________________
  501.  
  502.  
  503.      City, State, Zip: _________________________________________
  504.  
  505.  
  506.      Comments:         _________________________________________
  507.  
  508.  
  509.      Source of public domain version:  _________________________
  510.  
  511.  
  512.      Printer:    [ ] LaserJet,  [ ] DeskJet,  [ ] Compatible
  513.