home *** CD-ROM | disk | FTP | other *** search
/ World of Shareware - Software Farm 2 / wosw_2.zip / wosw_2 / PRINTING / DISKLIST.ZIP / DISKLASR.DOC next >
Text File  |  1991-04-24  |  14KB  |  414 lines
  1.  
  2.  
  3.  
  4.                         DISKLIST LASER COMMAND GUIDE
  5.  
  6.      This is a guide to help you use DISKLIST on a HP LaserJet.  Since
  7.      other brand laser printers emulate the HP PCL (Printer Control
  8.      Language) this information is applicable to most laser printers.
  9.      The purpose is to help you customize the laser commands that
  10.      DISKLIST sends to the printer.  This will give you control over
  11.      how and where DISKLIST is printed.
  12.  
  13.      The basic syntax of a PCL command is:
  14.  
  15.           The first character is ESC
  16.  
  17.           ESC is followed by printable ASCII characters - letters,
  18.           numbers and symbols.
  19.  
  20.           The last character is always an uppercase letter.
  21.  
  22.      The simplest command is to reset the printer - ESC E.
  23.  
  24.      There is a space after ESC in this documentation for clarity.  In
  25.      the actual HP laser command there is no space.  In the DISKLIST
  26.      laser command editor, the ESC is displayed as a left arrow with
  27.      no space.
  28.  
  29.      ESC is usually followed by two characters that identify a family.
  30.      The first is usually a symbol and the second a lowercase letter.
  31.  
  32.      These are followed by a number.  It can be an integer or a
  33.      decimal to 4 decimal places, depending on the command.
  34.  
  35.      Example:
  36.  
  37.           To set the point size to 12, the command is:   ESC (s12V
  38.  
  39.           To set the pitch to 10 characters per inch:    ESC (s10H
  40.  
  41.  
  42.      Note that the integers match the desired value of the parameter,
  43.      and the point command ends in V for vertical and the pitch
  44.      command ends in H for horizontal.  Both commands have the family
  45.      characters (s.
  46.  
  47.      One final rule.  Commands that have the same two characters after
  48.      ESC can be grouped together without repeating the ESC or the
  49.      common 2 characters.  In this case, the last letter of each
  50.      imbedded command must be lowercase.
  51.  
  52.      Example:
  53.  
  54.           Using the commands of the previous example to form one
  55.           command produces:
  56.  
  57.  
  58.  
  59.                                       -1- 
  60.  
  61.  
  62.  
  63.                            ESC (s12v10H
  64.  
  65.           Note the v is now lowercase.
  66.  
  67.      Warning:  Case is very important.  Also, do not confuse the
  68.      number 0 and the letter O, or the number 1 and the lower case L.
  69.      If you are not getting the results that you expect, look at your
  70.      commands very carefully for these substitutions.
  71.  
  72.  
  73.      LASER COMMAND SETUP
  74.  
  75.      DISKLIST has a set of laser commands for each format.  They are
  76.      in the file DISKLIST.LSR.  It also has a laser command editor,
  77.      accessed with FK 6, so you can easily change them.  Remember to
  78.      save the changes you make in this file with FK 9.  The laser
  79.      commands are setup in the following categories:
  80.  
  81.                              Symbol
  82.                              Spacing
  83.                              Pitch & Point Size
  84.                              Orientation
  85.                              Top Margin
  86.                              Lines per inch
  87.                              Left Margin, Row
  88.  
  89.                              Reset
  90.  
  91.      You can put any commands on any line.  These categories are for
  92.      reference only.  Although the order is important because the
  93.      value of one command effects the operation of other commands.
  94.      This will be discussed later with left margin and row.
  95.  
  96.      When laser printer is selected, DISKLIST concatenates all of the
  97.      commands in the first 7 categories and sends them to the printer.
  98.      After the list is printed, DISKLIST sends the commands in the
  99.      eighth category, Reset.
  100.  
  101.      You don't have to have any laser commands.  Many of these
  102.      parameters are inherent in the default font or can be set by
  103.      controls on the printer.  You may need a few commands, such as
  104.      top and left margin, and lines per inch.  The editor has a key to
  105.      delete the commands on one line, FK 7, or all commands for a
  106.      format, FK 8.
  107.  
  108.      Laser commands are all printable ASCII characters except ESC.
  109.      The IBM character set displays ESC as a left pointing arrow.  So
  110.      does DISKLIST.  To enter ESC on the command line, just press the
  111.      ESC key.  Since the ESC key is used for input, press Function
  112.      Key 10 to exit the editor.  I try to make my software consistent,
  113.      so DISKLIST will quit all functions when FK 10 is pressed.
  114.  
  115.  
  116.  
  117.  
  118.                                       -2- 
  119.  
  120.  
  121.  
  122.      SYMBOL
  123.  
  124.      Within a font set are many symbol sets.  The IBM lines that
  125.      DISKLIST uses to print the frames are in the symbol set called
  126.      IBM-PC(USA).  The command to use this symbol set is ESC (10U.
  127.  
  128.      Some fonts do not have this symbol set, so the printer will
  129.      select another set close to it, but that symbol set probably
  130.      won't have the IBM lines.  In that case you can use the ASCII
  131.      lines or select a label format that doesn't have lines.
  132.  
  133.  
  134.      SPACING
  135.  
  136.      This command sets the character spacing to proportional or fixed.
  137.      Since DISKLIST prints columns and a frame, the fixed spacing must
  138.      be selected.  The command for fixed spacing is ESC (s0P.  For
  139.      proportional spacing the command is ESC (s1P.
  140.  
  141.      Most fonts only come in one spacing, so this command is probably
  142.      ignored.  And, you don't want to use a proportional font.
  143.  
  144.  
  145.      PITCH AND POINT SIZE
  146.  
  147.      These commands were used in the example above.  DISKLIST uses two
  148.      sets, one for normal and one for compressed.  They are:
  149.  
  150.           Normal         ESC (s10.00h12.0V
  151.  
  152.           Compressed     ESC (s16.66h8.5V
  153.  
  154.  
  155.      ORIENTATION
  156.  
  157.      This command determines whether the list will be printed in the
  158.      Portrait or Landscape mode.  The commands are:
  159.  
  160.           Portrait     ESC &l0O
  161.  
  162.           Landscape    ESC &l1O
  163.  
  164.  
  165.      TOP MARGIN
  166.  
  167.      This command positions the list from the top of the page.
  168.      Remember, with most lasers there is a border around the page
  169.      where the printer cannot physically print.  If you set it up to
  170.      print there, nothing will be printed in this area.  The command
  171.      for the number of lines down from the top is ESC &l#E where #
  172.      represents the number of lines.
  173.  
  174.  
  175.  
  176.  
  177.                                       -3- 
  178.  
  179.  
  180.  
  181.      LINES PER INCH
  182.  
  183.      Lines per inch control the vertical spacing of the data lines.
  184.      There are two ways to select this.  Either select a specific
  185.      number of lines per inch, or select a fractional vertical motion
  186.      index.
  187.  
  188.      The lines per inch command is ESC &l#D where # is the number of
  189.      lines per inch.  However, unlike most of the other commands, this
  190.      command only allows specific numbers.  They are 1, 2, 3, 4, 6, 8,
  191.      12, 16, 24, and 48.
  192.  
  193.      Line spacing by vertical motion index command is ESC &l#C.
  194.      # represents the number of 1/48 inch increments and can be a
  195.      decimal.  The following table illustrates some useful values but
  196.      any value is acceptable by PCL.
  197.  
  198.  
  199.                                Lines
  200.                                 per
  201.                                Inch          #
  202.  
  203.                                 6.0         8.00
  204.                                 6.5         7.38
  205.                                 7.0         6.86
  206.                                 7.5         6.40
  207.                                 8.0         6.00
  208.                                 8.5         5.65
  209.                                 9.0         5.33
  210.                                 9.5         5.05
  211.                                10.0         4.80
  212.                                10.5         4.57
  213.                                11.0         4.36
  214.                                11.5         4.17
  215.                                12.0         4.00
  216.  
  217.  
  218.      LEFT MARGIN
  219.  
  220.      This command positions the list from the left edge of the page.
  221.      The command for the column number to start printing in is
  222.      ESC &a#L where # represents the column number.  This is important
  223.      when you position the list on labels.  The positioning of the
  224.      left margin is based on the current horizontal motion index which
  225.      was set by the pitch command.
  226.  
  227.  
  228.      ROW
  229.  
  230.      Row positions the start of the list down from the top margin,
  231.      not the top of the page.  The command is ESC &a#R where # is the
  232.      number of lines below the top margin.  Since it is in the &a
  233.      family, DISKLIST puts this in one command with the left margin.
  234.  
  235.  
  236.                                       -4- 
  237.  
  238.  
  239.  
  240.      The positioning of the row based on the current vertical motion
  241.      index which was set by the lines per inch command.
  242.  
  243.  
  244.      DEFAULT COMMANDS
  245.  
  246.      FK 6 will insert these commands in the editor for the selected
  247.      format only:
  248.  
  249.                      Pitch ==>   Normal             Compressed
  250.  
  251.           Symbol              ESC E ESC (10U        ESC E ESC (10U
  252.           Spacing             ESC (s0P              ESC (s0P
  253.           Pitch & Point Size  ESC (s10.00h12.0V     ESC (s16.66h8.5V
  254.           Orientation         ESC &l0O              ESC &l0O
  255.           Top Margin          ESC &l0E              ESC &l0E
  256.           Lines per inch      ESC &l6D              ESC &l8D
  257.           Left Margin, Row    ESC &a0l0R            ESC &a0l0R
  258.  
  259.           Reset               ESC E                 ESC E
  260.  
  261.      The symbol command is preceded by the ESC E, the reset command.
  262.      This forces a page eject in some printers, so you may want to
  263.      eliminate it.  If laser printer is selected, CTRL E will also
  264.      send a page eject from the control window.  If you want to print
  265.      more than one list on a sheet, remove the reset, then use CTRL E
  266.      to eject the page.
  267.  
  268.  
  269.      DOWNLOAD FONT
  270.  
  271.      DISKLIST sends the following commands to the laser when it
  272.      downloads your font that you have selected from the Download
  273.      Window.
  274.  
  275.                     Reset                    ESC E
  276.                     Font ID Assignment       ESC *c#D
  277.                     The Font File
  278.                     Font ID Assignment       ESC *c#D
  279.                     Make Font Permanent      ESC *c5F
  280.                     Select Font              ESC (#X
  281.  
  282.      # is the font number.  DISKLIST generates a number by adding 70
  283.      to the sequence number of the font in the font selection window.
  284.      Except selection 10, which is assigned the number 70.  So the
  285.      range of font ID numbers that DISKLIST assigns is from 70 to 79.
  286.      You can then reselect a font with the command ESC (#X.  The
  287.      downloaded fonts are lost when the printer is turned off.
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.                                       -5- 
  296.  
  297.  
  298.  
  299.      MORE
  300.  
  301.      This is just a beginning of learning about PCL.  It is sufficient
  302.      to produce useful lists and labels.  There are many more commands
  303.      that may be of help in configuring DISKLIST to print lists
  304.      exactly as you like.  They are all in your printer manual.  I
  305.      hope this write-up helps you to read and understand the laser
  306.      printer manual.
  307.  
  308.  
  309.      HELPFUL HINTS
  310.  
  311.      If you download or select a font, try deleting all commands (use
  312.      FK 8 in the editor), then insert a command for lines per inch and
  313.      maybe commands for top, left margin, and row.  Otherwise the
  314.      commands may override the selected font and the printer may
  315.      select another.
  316.  
  317.      If the vertical IBM lines look like dashes, squeeze the lines
  318.      together by printing more lines per inch.  Use the ESC &l#C
  319.      command.
  320.  
  321.      With a laser printer you can create your own list formats.  For
  322.      example, if you have a 6 point 25 pitch font, you can use the
  323.      format for 5.25 inch 5 across to print a list that can hold 165
  324.      file names and be cut to fit the size of a 3.5 inch disk.  Then
  325.      tape the list to the back of the diskette with one small piece of
  326.      tape placed along the edge of the diskette that doesn't go into
  327.      the drive.  You then have a list that stays attached to the
  328.      diskette even when it is inserted in the drive.
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.                                       -6- 
  355.  
  356.  
  357.  
  358.      DISKLIST LASER COMMAND REFERENCE CARD
  359.  
  360.  
  361.  
  362.                     Reset                   ESC E
  363.  
  364.                     Point Size              ESC (s#V
  365.                     Pitch                   ESC (s#H
  366.  
  367.                     Portrait                ESC &l0O
  368.                     Landscape               ESC &l1O
  369.  
  370.                     Top Margin              ESC &l#E
  371.                     Left Margin             ESC &a#L
  372.  
  373.                     Row                     ESC &a#R
  374.  
  375.                     Lines Per Inch          ESC &l#D
  376.  
  377.            Valid Values of # for lines per inch are:
  378.  
  379.                 1, 2, 3, 4, 6, 8, 12, 16, 24, and 48.
  380.  
  381.                     Vertical Motion Index   ESC &l#C
  382.  
  383.            # represents the number of 1/48 inch increments and can be
  384.            a decimal.  The following table illustrates useful values:
  385.  
  386.                                Lines
  387.                                 per
  388.                                Inch          #
  389.  
  390.                                 6.0         8.00
  391.                                 6.5         7.38
  392.                                 7.0         6.86
  393.                                 7.5         6.40
  394.                                 8.0         6.00
  395.                                 8.5         5.65
  396.                                 9.0         5.33
  397.                                 9.5         5.05
  398.                                10.0         4.80
  399.                                10.5         4.57
  400.                                11.0         4.36
  401.                                11.5         4.17
  402.                                12.0         4.00
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.                                       -7- 
  414.