home *** CD-ROM | disk | FTP | other *** search
/ Frostbyte's 1980s DOS Shareware Collection / floppyshareware.zip / floppyshareware / LUNACY / WIDGRF10.ZIP / WIDGRAPH.DOC next >
Text File  |  1990-06-24  |  9KB  |  148 lines
  1.                                                                    24 June 1990
  2.  
  3. ╔═════════════════════════════════════════════════════════════════════════════╗
  4. ║                           WIDGRAPH (Version 1.00)                           ║
  5. ║          Copyright 1990 by Rufus S. Hendon.  All rights reserved.           ║
  6. ╚═════════════════════════════════════════════════════════════════════════════╝
  7.  
  8.      Word-processing programs require tables showing the widths of the
  9. characters in proportional-spaced fonts that are to be used to print documents
  10. on a Hewlett-Packard LaserJet printer.  If the printer driver provided by the
  11. vendor of the word-processing program doesn't include a width table for a
  12. particular font, you have to create it yourself and incorporate it in the
  13. driver in order to enable the program to make use of the font.
  14.  
  15.      For downloadable bitmapped fonts, this isn't a problem, since various
  16. utilities are available that can create width tables by extracting the
  17. information from the file in which the font is stored.  Such programs, however,
  18. can't operate on bitmapped fonts contained in cartridges or on the scalable
  19. fonts resident in the LaserJet III or similar fonts provided in cartridge form.
  20. In these cases the widths of the characters must be determined by measurement
  21. of samples of printed output.  This is a tedious and error-prone chore.
  22.  
  23.      The purpose of WIDGRAPH is to simplify this task of measuring the widths
  24. of characters.  It does this by producing what is in effect a horizontal bar
  25. graph with a separate bar for each character.  The length of the bar is
  26. proportional to the width of the character.  A system of grid lines on the
  27. graph makes it easy to read off the width of a given character from a scale
  28. that is calibrated in dots, the unit of character width used in width tables
  29. for LaserJet fonts.  (One dot = 1/300 inch.)
  30.  
  31.      To use WIDGRAPH to produce a graph for a particular font, you must know
  32. the command that causes the printer to select the font for use.  The form of
  33. such a command is illustrated by the following example, which is the command to
  34. select 12-point Normal Upright CG Times with the Roman-8 symbol set ("<Esc>"
  35. represents the Esc character):
  36.  
  37.                          <Esc>(8U<Esc>(s1p12v0s0b4101T
  38.  
  39. When WIDGRAPH is invoked, the font-selection command is specified as the first
  40. or only argument, with "$" substituted for the Esc character.  If you wanted to
  41. have WIDGRAPH produce a graph for 12-point Normal Upright CG Times with the
  42. Roman-8 symbol set, you would issue this command:
  43.  
  44.                         widgraph $(8U$(s1p12v0s0b4101T
  45.  
  46.      In the graph, the font-selection command is printed at the top of the
  47. first page, to identify the font to which the graph pertains.
  48.  
  49.      The graph itself has vertical grid lines that lead to scales at the top
  50. and the bottom.  The interval between grid lines corresponds to one dot of
  51. width.  The alternate grid lines are labeled 0, 2, 4, 6, and so on in the
  52. scales.  The grid line labeled 18, for example, corresponds to a character
  53. width of 18 dots.  The unlabeled grid line between those labeled 16 and 18
  54. corresponds to a width of 17 dots.
  55.  
  56.      For each character, a bar is shown composed of repetitions of the
  57. character.  The bar begins at grid line 0; the code for the character is shown
  58. to the left.  The bar extends to the grid line that corresponds to the width of
  59. the character in dots.  The character "" is printed just to the right of this
  60. grid line.  This provides an unambiguous identification of the grid line to be
  61. used to determine the width of the character in those cases in which the bar
  62. may not quite reach the grid line (because of space left blank on the right of
  63. the particular character) and in the case of the space character, for which the
  64. bar is invisible.  To ascertain the width of a given character, simply locate
  65. the code for the character in the column at the left of the graph, find the
  66. grid line at the end of the bar that is marked by "", and follow the grid line
  67. up or down to the nearer scale, from which the width can be read off.
  68.  
  69.      If the font-selection command is the only argument given when WIDGRAPH is
  70. invoked, WIDGRAPH itself decides which characters to include in the graph on
  71. the basis of the symbol set specified in the font-selection command.  It
  72. distinguishes three cases:
  73.  
  74.      (1) If the symbol set is 0U, 1U, or 15U, only the standard ASCII
  75. characters (codes 32-127) are included.
  76.  
  77.      (2) If the symbol set is 10U or 11U, all characters with codes from 1 to
  78. 255 are included.
  79.  
  80.      (3) For any other symbol set, the graph includes the characters with codes
  81. in the ranges 32-127 and 160-255.
  82.  
  83.      This simple scheme works in most cases.  However, you can override the
  84. automatic choice of ranges by including additional arguments in the command
  85. that invokes WIDGRAPH.  These arguments consist of one or more pairs of
  86. numbers.  Each pair specifies a range of characters to be included in the graph
  87. by their codes.  The pair 65 90, for example, specifies the uppercase letters
  88. from A (code 65) to Z (code 90); the pair 97 122 specifies the lowercase
  89. letters.  If a range comprises only a single character, the code for the
  90. character is repeated to form a pair, e.g. 32 32 to specify the range that
  91. contains only the space character.  Up to 10 ranges may be specified in this
  92. way.  The following command, for instance, would restrict the graph for
  93. 24-point Bold CG Times with the US ASCII symbol set to the space character and
  94. the alphabetic characters:
  95.  
  96.                widgraph $(0U$(s1p24v0s3b4101T 32 32 65 90 97 122
  97.  
  98.      Sometimes the range of codes covered by the graph may include a code that
  99. isn't assigned to a character in the font being processed.  In such cases the
  100. bar for that code will have a length of 0, indicated by the fact that the ""
  101. symbol points to the 0 grid line.
  102.  
  103.      With respect to orientation, LaserJet fonts are of two kinds.  Some, such
  104. as the scalable fonts resident in the LaserJet III, are neutral:  the printer
  105. can print them in either portrait or landscape orientation, in response to the
  106. appropriate command.  Others, such as downloadable bitmapped fonts, are
  107. designed to be used in only one of the two possible orientations.  Whether the
  108. printer can use orientation-neutral fonts depends on the printer:  the LaserJet
  109. III can, whereas the LaserJet Series II can only use fonts with a specific
  110. orientation.
  111.  
  112.      If your printer is capable of printing from the same font in either
  113. orientation and the font for which a graph is to be produced is of the
  114. orientation-neutral type, don't include a specification of orientation in the
  115. font-selection command used as the first or only argument for WIDGRAPH.  This
  116. allows WIDGRAPH to select whichever orientation is better for printing the
  117. graph.  Portrait orientation will be used for smaller point sizes; for larger
  118. point sizes, WIDGRAPH will switch to landscape orientation in order to keep the
  119. grid lines a legible distance apart.
  120.  
  121.      If, on the other hand, the font can only be used in a particular
  122. orientation, include the orientation specification ("$&l0O" for portrait,
  123. "$&l1O" for landscape) in the font-selection command.  This forces WIDGRAPH to
  124. print the graph in that orientation.  If, for example, you needed to produce a
  125. width graph for a portrait-orientation 14-point Upright Bold Helv font with the
  126. Roman-8 symbol set contained in a cartridge, you would issue this command:
  127.  
  128.                        widgraph $&l0O$(8U$(s1p14v0s3b4T
  129.  
  130.      The largest point size that WIDGRAPH can handle depends on the type of
  131. font.  For orientation-neutral fonts or for specifically landscape fonts, the
  132. upper limit is approximately 40 points.  For specifically portrait fonts, the
  133. fact that the graph must be printed in portrait orientation imposes a lower
  134. upper limit of approximately 30 points.
  135.  
  136. -------------------------------------------------------------------------------
  137.  
  138.      Reports of problems with WIDGRAPH and suggestions for its improvement are
  139. welcome.  Send them by EASYPLEX (MAIL) to Rufus S. Hendon [73250,2674].
  140.  
  141. -------------------------------------------------------------------------------
  142.  
  143.      WIDGRAPH is a copyrighted program, and selling it or distributing it for a
  144. fee is prohibited.  However, individuals are authorized to make personal use of
  145. the program without charge, and may distribute copies to others provided that
  146. both the program and this documentation are kept together unmodified and no
  147. payment is accepted for such distribution.
  148.