home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / r / rentt103.zip / RENAMETT.DOC < prev    next >
Text File  |  1992-08-12  |  16KB  |  321 lines

  1.                                                                  12 August 1992
  2.  
  3.                                  RENAMETT 1.03
  4.  
  5.            Copyright 1992 by Rufus S. Hendon.  All rights reserved.
  6.  
  7.  
  8. What RENAMETT does
  9. ------------------
  10.  
  11.    RENAMETT is a DOS program (not a Windows program) with the aid of which you
  12. can change the name by which Windows 3.1 refers to a TrueType font.  To
  13. accomplish this, RENAMETT alters the specifications of the name in the font
  14. itself and writes the modified font into a new file.
  15.  
  16.    There are three names that are affected by the operation of RENAMETT.
  17. These are (1) the "font family name", e.g. "Arial" or "Bookman Old Style",
  18. (2) the "font style name", e.g. "Regular" or "Bold", and (3) the "full font
  19. name".  The TrueType convention is for the full font name to consist of the
  20. font family name followed by the font style name, e.g. "Arial Bold", except
  21. that if the font style name is "Regular" the full font name is identical with
  22. the font family name, e.g. "Arial" for Regular Arial.  (A font that isn't Bold,
  23. Italic, or Bold Italic is "Regular".)
  24.  
  25.    TrueType fonts specify names for both the Microsoft and the Macintosh
  26. "platforms" and also give variants of the names for different languages.
  27. RENAMETT changes only the "US English" names for the Microsoft platform.  If
  28. the file produced by RENAMETT were used on a Macintosh, the original names
  29. would be in effect.  If you are running Windows with a different country and
  30. language selected, the names will likewise be the original names (in the form
  31. specified in the font for the particular language).
  32.  
  33.  
  34. Obligatory arguments
  35. --------------------
  36.  
  37.    RENAMETT can operate either interactively or automatically.  In either
  38. mode, it requires two arguments.  The first is the name of the file containing
  39. the TrueType font the names of which are to be changed.  The second argument is
  40. the name for the file into which the modified font is to be written.  Suppose,
  41. for example, that you want to modify the SWFTE font called "Copperfield" to
  42. change the name by which the font is shown on Windows font menus to something
  43. other than "Copperfield".  The font is stored in the file CPBSWFTE.TTF in your
  44. \WINDOWS\SYSTEM directory.  If you want the modified font to be stored in
  45. COOPERBL.TTF in the root directory of your D: drive, you would issue this
  46. command:
  47.  
  48.              renamett \windows\system\cpbswfte.ttf d:\cooperbl.ttf
  49.  
  50. (With only these two arguments, RENAMETT would run in interactive mode.)
  51.  
  52.  
  53. Interactive operation
  54. ---------------------
  55.  
  56.    To run RENAMETT in interactive mode, invoke it with only the two
  57. obligatory arguments.  After it has loaded the TrueType font, RENAMETT shows
  58. you the three existing names and prompts you to replace them.  If you want to
  59. follow the TrueType convention, you will retain the original font style name
  60. and change only the font family name and the font family name portion of the
  61. full font name.
  62.  
  63.    Let's say you want to change the name of the font in CPBSWFTE.TTF from
  64. "Copperfield" to "Cooper Black".  To do this interactively, you would issue
  65. the command with only the two file names as arguments:
  66.  
  67.              renamett \windows\system\cpbswfte.ttf d:\cooperbl.ttf
  68.  
  69. Your interaction with RENAMETT would then go like this:
  70.  
  71.         Current font family name: Cooperfield
  72.         Enter new font family name: Cooper Black
  73.         Current font style name: Regular
  74.         Enter new font style name: Regular
  75.         Current full font name: Copperfield
  76.         Enter new full font name: Cooper Black
  77.  
  78. After you responded to the last prompt, RENAMETT would modify the font
  79. accordingly and write the result into D:\COOPERB.TTF.
  80.  
  81.    If you want to retain the original name, simply press Enter in response to
  82. the prompt for a new name.  RENAMETT will ask you if you want to keep the
  83. original name, prompting you to type y (for "yes") or n (for "n").  This is an
  84. example of the dialog:
  85.  
  86.         Current font style name: Regular
  87.         Enter new font style name:
  88.         Keep 'Regular' as the font style name? (y/n) y
  89.  
  90. If you type n instead of y, RENAMETT will tell you that a blank name isn't
  91. acceptable and will prompt you again to enter a new name.
  92.  
  93.  
  94. Automatic operation
  95. -------------------
  96.  
  97.    If you specify the new font family name on the command line following the
  98. second argument, RENAMETT will operate in automatic mode, without prompting
  99. you for new names.  In this mode, RENAMETT changes the original font family
  100. name to the one you specify, retains the original font style name, and creates
  101. a new full font name according to the TrueType convention.
  102.  
  103.    For the "Copperfield" to "Cooper Black" example, the command would take this
  104. form:
  105.  
  106.       renamett \windows\system\cpbswfte.ttf d:\cooperbl.ttf Cooper Black
  107.  
  108. If the original font style name is "Regular", RENAMETT would write into
  109. D:\COOPERBL.TTF a modified version of the font with "Cooper Black" as the
  110. font family name, "Regular" as the font style name, and "Cooper Black" as the
  111. full font name.
  112.  
  113.    If \WINDOWS\SYSTEM\BAISWFTE.TTF contains a font with "Baskerton" as the
  114. font family name, "Italic" as the font style name, and "Baskerton Italic" as
  115. the full font name, execution of the command
  116.  
  117.         renamett \windows\system\baiswfte.ttf d:\baskit.ttf Baskerville
  118.  
  119. would write into D:\BASKIT.TTF a modified version of the font with
  120. "Baskerville" as the font family name, "Italic" as the font style name, and
  121. "Baskerville Italic" as the full font name.
  122.  
  123.    Because operation is automatic, this mode is suitable for use in a batch
  124. file when you want to process a series of TrueType fonts.  The following
  125. batch file, for instance, would modify the four SWFTE "Baskerton" fonts and
  126. the four SWFTE "Carnegie" fonts:
  127.  
  128.      renamett \windows\system\baaswfte.ttf d:\baskrg.ttf Baskerville
  129.      renamett \windows\system\babswfte.ttf d:\baskbd.ttf Baskerville
  130.      renamett \windows\system\baiswfte.ttf d:\baskit.ttf Baskerville
  131.      renamett \windows\system\batswfte.ttf d:\baskbi.ttf Baskerville
  132.      renamett \windows\system\craswfte.ttf d:\goudyrg.ttf Goudy Old Style
  133.      renamett \windows\system\crbswfte.ttf d:\goudybd.ttf Goudy Old Style
  134.      renamett \windows\system\criswfte.ttf d:\goudyit.ttf Goudy Old Style
  135.      renamett \windows\system\crkswfte.ttf d:\goudybk.ttf Goudy Old Style
  136.  
  137.  
  138. Character Set
  139. -------------
  140.  
  141.    RENAMETT only permits the use of ordinary keyboard characters (i.e.
  142. characters with ASCII codes in the range from 32 to 126) in names.  (This is
  143. a RENAMETT limitation, not a TrueType or Windows restriction.)
  144.  
  145.  
  146. Installing modified fonts in Windows
  147. ------------------------------------
  148.  
  149.    If a font is already installed in Windows, you should follow a procedure
  150. such as this in order to substitute the modified font for the original font:
  151.  
  152.    (1) Make sure you have a backup copy of the original .TTF file, in case
  153. you later want to revert to it.  (It isn't necessary to back up the .FOT file,
  154. since the Windows font installer can recreate it.)
  155.  
  156.    (2) Copy the file created by RENAMETT to a directory other than
  157. \WINDOWS\SYSTEM.
  158.  
  159.    (3) Start Windows and use the Control Panel Font Installer to remove the
  160. installed font.  (This causes the reference to it in WIN.INI to be removed and
  161. also causes the .FOT file to be deleted from \WINDOWS\SYSTEM.)  If you want to
  162. recover the storage occupied by the .TTF file, check the box that requests that
  163. the font file be deleted.
  164.  
  165.    (4) Select "Add ...".  On the "Add Fonts" screen that this brings up,
  166. specify the directory where you put the modified .TTF file in step 2.  The name
  167. of the font (i.e. its new full font name) should appear.  Click on it to select
  168. it and then click the OK button to install the font.  Font Installer takes you
  169. back to the "Fonts" screen where the installed fonts are shown; the name of the
  170. newly installed font will be added to the list and highlighted, and a sample of
  171. it will be displayed below the list.  That's all there is to it.  The new font
  172. is immediately available -- you don't have to exit from Windows and then
  173. restart it.
  174.  
  175.  
  176. Ascertaining the names specified in a TrueType font
  177. ---------------------------------------------------
  178.  
  179.    RENAMETT can also be used to find out what the font family, font style, and
  180. full font names specified in a TrueType font are, without modifying them.  For
  181. this purpose, invoke RENAMETT with a single argument giving the name of the
  182. font file.  If, for example, you issue the command
  183.  
  184.                       renamett \windows\system\arial.ttf
  185.  
  186. RENAMETT will show you the name of the font file and the three names as they
  187. are given in the font.  No changes will be made to the font and no new file
  188. will be produced.
  189.  
  190.    This portion of RENAMETT output can be redirected to a file by using the
  191. DOS redirection operator ">" or ">>" in the command.  If, for example, you
  192. issue the command
  193.  
  194.                  renamett \windows\system\arial.ttf >font.nam
  195.  
  196. the report will be written into the file FONT.NAM instead of being shown on the
  197. screen; any previously existing file called FONT.NAM will be replaced by the
  198. new file.  If you use ">>font.nam" instead of ">font.nam" and a file FONT.NAM
  199. already exists, the report will be added to that file, following its original
  200. contents.  If there is no existing FONT.NAM, ">>font.nam" has the same effect
  201. as ">font.nam".
  202.  
  203.  
  204. Changing names that have already been changed by RENAMETT
  205. ---------------------------------------------------------
  206.  
  207.    After modifying the names in a font using RENAMETT, you may sometimes change
  208. your mind and decide to change them to something else.  In such cases it is
  209. possible to apply RENAMETT to the modified font produced by the earlier use of
  210. RENAMETT in order to alter the names again.  However, each time RENAMETT is
  211. used the font it produces is slightly larger than the input font, so if you use
  212. RENAMETT several times, each time applying it to the modified font produced by
  213. the previous application, these increases will cumulate.  When you change your
  214. mind about the new names, it is therefore preferable to discard the font
  215. produced by the earlier use of RENAMETT and run RENAMETT again on the original
  216. font.
  217.  
  218.  
  219. Executing RENAMETT in the DOS window of Windows
  220. -----------------------------------------------
  221.  
  222.    RENAMETT is a DOS program.  It is, of course, possible to run it in the DOS
  223. window of Windows, but doing so opens the door to various types of malfunction
  224. due to the way Windows runs DOS programs.
  225.  
  226.    One documented problem is that the default PIF under which Windows runs
  227. RENAMETT allots only 128K of system memory to the program.  RENAMETT can handle
  228. ordinary fonts with this amount of memory, but some unusually large font files
  229. (files of more than about 100K bytes) require more memory than the default
  230. allocation makes available.  If RENAMETT, when run under Windows, fails with an
  231. error code of 10001, 10002, or 10003, it is telling you that Windows didn't
  232. give it enough system memory to handle the font you asked it to process.
  233.  
  234.    The easy solution to this problem is to exit from Windows and issue the
  235. RENAMETT command again from the DOS command line.  Otherwise, if you want to be
  236. able to operate within Windows, you'll have to modify the default PIF for DOS
  237. programs or create a special PIF for RENAMETT, specifying in either case a
  238. memory requirement greater than the default 128K.  A specification of 256K
  239. should be adequate; if it isn't, you can try higher amounts.
  240.  
  241.    Users running RENAMETT under Windows have reported various other problems
  242. the causes of which are difficult to pinpoint.  They appear, however, to be
  243. due to some kind of interaction between Windows and the program.  Again, the
  244. way to avoid such problems is to run RENAMETT under DOS.
  245.  
  246.  
  247. Problem reports
  248. ---------------
  249.  
  250.    If, in step 4 of the installation procedure, the name of the font doesn't
  251. appear on the "Add Fonts" screen, or if the name of the new font doesn't appear
  252. in the list of installed fonts on the "Fonts" screen after you've supposedly
  253. installed it, or if the sample displayed for the font is obviously garbled or
  254. if no sample is shown, Font Installer is telling you that there's something
  255. wrong with the new font.  This indicates that RENAMETT has made some mistake in
  256. taking the font apart and putting it together again as a result of which the
  257. modified font is malformed.  If you encounter this or any other problem, I'll
  258. be glad to try to track down the cause, but to do so I'll have to have a copy
  259. of the original font to work with.
  260.  
  261.  
  262.                                   Rufus S. Hendon
  263.                                   804 Still Hill Road
  264.                                   Hamden, CT 06518
  265.  
  266.                                   CompuServe userID: [73250,2674]
  267.  
  268. ===============================================================================
  269.                                Revision History
  270.  
  271. 1.01 (21 May 1992) - Initial release.
  272. 1.02 (10 June 1992) - Version 1.01 neglected to recalculate the field called
  273.      'checkSumAdjustment' in the 'head' table.  (This field is a modified
  274.      checksum for the entire file.)  This omission is corrected in 1.02.
  275.      (Fonts processed by RENAMETT 1.01 are acceptable to Windows despite the
  276.      incorrect 'checkSumAdjustment' value, because Windows ignores the
  277.      checksums in TrueType fonts.)
  278. 1.03 (12 August 1992) - (1) Entering a null or blank name in response to a
  279.      prompt for a new name now triggers a query asking if the original name is
  280.      to be retained as a new name.  If the answer is no, the user is prompted
  281.      again for a new name (null or blank names aren't accepted).  (2) Names
  282.      supplied by the user are checked to make sure they don't contain any
  283.      characters with codes outside the range 32-126.  (3) When there is no
  284.      second argument, the report of the names (which now includes the file
  285.      name) is written to Standard Output, so that it can be redirected to a
  286.      file.  (4) The more generally used term 'style name' is used instead of
  287.      the official TrueType term, 'subfamily name'.
  288.  
  289. ===============================================================================
  290.                                     NOTICE
  291.  
  292.    RENAMETT is a copyrighted program, the distribution and use of which are
  293. controlled by the author and copyright owner, Rufus S. Hendon.  It is not in
  294. the public domain.
  295.  
  296.    I, the copyright owner, have placed the RENAMETT program and this
  297. documentation file in software libraries on the CompuServe Information Service
  298. to enable individuals to download them for their own private, non-commercial
  299. use.  You may do so without charge.  You may also give copies of the program
  300. to other individuals for their private, non-commercial use, provided that such
  301. copies include both the program file (RENAMETT.EXE) and this documentation file
  302. (RENAMETT.DOC) in unaltered form and provided that you neither ask nor accept
  303. remuneration in any form for the copies.
  304.  
  305.    Commercial distribution of RENAMETT is forbidden unless there has been
  306. prior approval by the copyright owner and the payment of a license fee.
  307. Prohibited forms of commercial distribution include the bundling of the
  308. program with commercially distributed products such as software and books,
  309. the distribution of the program as part of a "premium" for magazine
  310. subscribers, the distribution of the program by companies that sell collections
  311. of "freeware" and "shareware" programs on disks, and the posting of the program
  312. on electronic bulletin boards maintained by vendors of commercial products in
  313. support of those products.
  314.  
  315.    RENAMETT is made available without warranty of any kind.  The copyright
  316. owner is not liable for any damages resulting from the use of the program.
  317.  
  318.    It is the responsibility of the user to take care that RENAMETT is not used
  319. in ways that would violate the license agreements (if any) of the fonts to
  320. which it is applied.
  321.