home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / gdos / fntinf10 / fontinfo.txt < prev   
Encoding:
Text File  |  1992-09-16  |  7.3 KB  |  189 lines
  1.                          Font Info v1.0
  2.                         ================
  3.  
  4.  
  5.                          ** FREEWARE **
  6.  
  7.  
  8.                      By   Kenneth W. Hartlen
  9.  
  10.                         September 16,1992
  11.  
  12.  
  13.      Font  Info v1.0 produces a summary of your GEM  font  files. 
  14. The summary contains information such as filename,  font id, font 
  15. name,  point size,  etc.  This information is extracted from  the 
  16. font  header  of each GEM font file in a given directory  and  is 
  17. displayed on screen or written to a user specified file.
  18.  
  19.      The main reason I wrote this program was because I  wondered 
  20. how  many  GEM fonts I had were mono-spaced.  I was  looking  for 
  21. mono-spaced  GEM  fonts to use with  NeoDesk's  FONTLOAD.PRG  for 
  22. replacing the system font. Rather than load each font into a font 
  23. editor to check I thought a program to do the task would be  very 
  24. useful.  Once  I  started  writing  the  program  I  added  other 
  25. information so I would have an inventory list of exactly what  my 
  26. GEM font files contain.
  27.  
  28.      Font  Info  v1.0  was written in C and  was  compiled  using 
  29. HiSoft's Lattice C v5.52.
  30.  
  31.  
  32.                       FNTINF10.LZH Contents
  33.                      =======================
  34.  
  35.      The archive file FNTINF10.LZH contains the following files:
  36.  
  37. FONTINFO.TTP   The Font Info v1.0 program.  Can be run from  GEM, 
  38.                NeoDesk or a CLI.
  39. FONTINFO.TXT   This file.
  40. FONTINFO.NIC   NeoDesk v3.02 icon file containing an icon for the 
  41.                Font Info v1.0 program.
  42.  
  43.      If any of these files are missing, the original FNTINF10.LZH 
  44. file has be tampered with.  Please locate a complete FNTINF10.LZH 
  45. file.
  46.  
  47.  
  48.                            The Program
  49.                           =============
  50.  
  51.      To run the program simply double-click the FONTINFO.TTP icon 
  52. in  GEM  or NeoDesk.  Since the program is a .TTP,  you  will  be 
  53. prompted for parameters.  When run from a CLI such as NeoDesk CLI 
  54. or Gulam (as I had intended it to be) the program usage is:
  55.  
  56.      FONTINFO [template] [outfile.ext]
  57.  
  58. where,
  59.  
  60.      [template] is the optional path\template parameter used  for 
  61. the  file search.  For  example:  FONTINFO  A:\FONTS\??????HI.FNT 
  62. would  produce  a  summary for all .FNT files  in  the  A:\FONTS\ 
  63. directory  where  the last two characters in the  file  name  are 
  64. 'HI'.
  65.  
  66.                           ** WARNING **
  67.      Do  not  use *.* in the template as unexpected  results  may 
  68.      occur if a non-GEM font files are processed.
  69.  
  70.      [output.ext] is the optional path\filename.ext parameter  in 
  71. which  to  store the  summary.  For  example:  FONTINFO  A:\*.FNT 
  72. SUMMARY.TXT  would  produce a summary for all .FNT  in  the  root 
  73. directory  of  a:  and  save the summary in  SUMMARY.TXT  in  the 
  74. current directory.  If using a CLI that supports I/O  redirection 
  75. you  can  omit this parameter and simply use I/O  redirection  to 
  76. store the summary.
  77.  
  78.      Font Info v1.0 will return one of two exit codes:
  79.  
  80.        0: the program terminated normally.
  81.       -1: too many parameters.
  82.       -2: outfile.ext could not be opened.
  83.  
  84.  
  85.                          Program output
  86.                         ================
  87.  
  88.      Here  is  a  sample summary that I'll use  to  describe  the 
  89. output of Font Info v1.0:
  90.  
  91.  
  92. GEM font Summary for:                            Fontz! -----------+
  93. *.FNT                                            Spacing --------+ |
  94.                                                  Format -------+ | |
  95.                                                  Offset -----+ | | |
  96.                                                  Sys font -+ | | | |
  97.                                                            | | | | |    dpi
  98. Filename Id    Font name                       Pt. Low Hi  | | | | |  X     Y
  99. ===============================================================================
  100. ATCH11HI 00075 Chicago                         009 032 127 N N I P Y 090 x 090
  101. IBM06    15590 IBM-PC                          006 000 255 N N I M Y 090 x 090
  102. IBM11    15590 IBM-PC                          011 000 255 N N I M Y 090 x 090
  103. IBM12    15590 IBM-PC                          012 000 255 N N I M Y 090 x 090
  104. L2CT12   00101 Century                         012 032 255 N N I P N ??? x 300
  105. ATCH11FZ 00075 Chicago (test to pad font name) 009 032 127 N N I P Y 090 x 090
  106.  
  107.  
  108.      The header of the summary contains the template used for the 
  109. file  search so you'll know what directory and files the  summary 
  110. applies to.  The rest of the header indicates what information is 
  111. in each line of the summary. Which is (from left to right):
  112.  
  113. Filename:      obviously the filename for which the summary  line 
  114.                applies. The file extension is not shown since 99% 
  115.                of the time it will be a .FNT extension.
  116.  
  117. Id:            the GEM font id.
  118.  
  119. Font name:     the GEM font name.
  120.  
  121. Pt.:           the font's point size (in 1/72").
  122.  
  123. Low:           the lowest ASCII character with a font definition.
  124.  
  125. Hi:            the highest ASCII character with a font definition.
  126.  
  127. Sys font:      "Y" if default system font, otherwise "N".
  128.  
  129. Offset:        "Y"  if horizontal offset  table  used,  otherwise 
  130.                "N".
  131.  
  132. Format:        "M" if Motorola raster format,  otherwise "I"  for 
  133.                Intel raster format.
  134.  
  135. Spacing:       "M"  of  mono-spaced  font,   otherwise  "P"   for 
  136.                proportional font.
  137.  
  138. Fontz!:        "Y"  if  font contains the extended  font  header, 
  139.                otherwise "N".
  140.  
  141. dpi X * Y:     GEM  font resolution,  in  dpi.  This  information 
  142.                allows  you determine the output device for  which 
  143.                the  GEM font is intended.  If the GEM  font  file 
  144.                doesn't  use  the extended font header then  X  is 
  145.                shown  as ???  since it can't be  calculate  using 
  146.                font  header information.  However,  Y can and  is 
  147.                calculated from the given font header information.
  148.  
  149.  
  150.                       Disclaimer and Notes
  151.                      ======================
  152.  
  153.      Font  Info  v1.0 is FREEWARE,  meaning FNTINF10.LZH  can  be 
  154. distributed  freely  (unmodified) and there is no cost to  own  a 
  155. copy.  Font  Info v1.0 is provided AS IS.  I make no  warranties, 
  156. either expressed or implied,  with respect to the  software,  its 
  157. quality,  performance,  or  fitness.  I  will not be  liable  for 
  158. direct,  indirect,  or  consequential damages resulting from  any 
  159. defects in the software.
  160.  
  161.      Having  said  the that,  I hope you find Font Info  v1.0  as 
  162. useful as I do.
  163.  
  164.      Now you won't waste precious time searching for the GEM font 
  165. you know you have, somewhere!
  166.  
  167.  
  168.                              Support
  169.                             =========
  170.  
  171.      Suggestions  to improve Font Info v1.0,  or if any bugs  are 
  172. encountered, or if you'd like to send $, can be sent to myself:
  173.  
  174.           Kenneth W. Hartlen
  175.           Box 37, Site 6, RR#3
  176.           Armdale, Nova Scotia
  177.           Canada B3L-4J3
  178.  
  179.      Please  send a self-addressed stamped envelope if you  would 
  180. like me to reply.
  181.  
  182.      I  can  also  be reached by  e-mail  (until  the  university 
  183. realizes I've graduated, shhhh... ) at my Internet addresses:
  184.  
  185.           hartlenk@newton.ccs.tuns.ca
  186.      or   hartlekw@taurus.cs.tuns.ca
  187.      or   hartlekw@tardis.cs.tuns.ca
  188.  
  189.