home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / os2 / dvidrv1.arj / EMTEX / DOC / ENGLISH / FONTLIB.DOC < prev    next >
Encoding:
Text File  |  1990-09-24  |  12.6 KB  |  289 lines
  1. ==============================================================================
  2. FONTLIB 1.1a                                               VERSION: 25.09.1990
  3. ==============================================================================
  4.  
  5. FONTLIB allows PK and PXL font files to be gathered into a font library file.
  6.  
  7.  
  8. Calling sequence
  9. ================
  10.  
  11. FONTLIB {option} library-file [output-file] {operation}
  12.  
  13. {a}   means `a' may appear 1 or more times or not at all
  14. [a]   means `a' may appear once or not at all
  15.  
  16. The default extension for the font library file and the output file is .FLI.
  17. When modifying large font libraries, it is recommended that the output file is
  18. located on another drive as the whole input file will be copied, being given
  19. the extension .BAK.  If the library is not modified, it will not be copied.
  20.  
  21.  
  22. Options
  23. =======
  24.  
  25. /1    Use old FLI file format.  This shouldn't be used, as the members
  26.       of the dvidrv family 1.4d or later can only read the new format.
  27.       Since the drivers of version 1.4c or earlier cannot read the new format,
  28.       this option is required for making new FLI files usable with the old
  29.       drivers.
  30.  
  31. /2    Use new FLI file format.  If /2 is specified, the output file
  32.       will be written using the new FLI format, even if the input file
  33.       is of the old format.  If neither /1 nor /2 is specified, the output
  34.       file will be written in the same format as the input file.  If a
  35.       new file is created (and /1 isn't given), the new format will be
  36.       used.
  37.  
  38. /b#   Set base resolution (device resolution).  This option must be used
  39.       when converting an old FLI file to the new format or when merging
  40.       an old FLI file with `&library' or when reading fonts from an old
  41.       FLI file with the `library name' operation.  The resolution set
  42.       with /b# enables fontlib to compute the exact font size (dpi) from
  43.       the old PXL font size.  If /b# is omitted, the font sizes in the
  44.       new lirary will have considerable rounding errors.  /b# also enables
  45.       usage of :0 to :9 and :h (without resolution) for specifying font sizes.
  46.       Note: don't use the resolution (size) of the fonts with /b# instead
  47.       of the device resolution ("magstep 0");
  48.  
  49. /c    A new font library will be created (no output file allowed).
  50.       If a file of the same name already exists, the user will be asked if it
  51.       should be overwritten -- if the option /w is used, any existing file
  52.       will be overwritten without being queried.  If /c is not given, the
  53.       library does not exist and no output file name is given, then the user
  54.       will be asked if a new file is to be created.
  55.  
  56. /d    Missing directories will be created while copying fonts from the
  57.       library (`#name' operation).
  58.  
  59. /f*   Font list.  /f* specifies the name of a file containing a list of
  60.       font names.  Every line of this file contains a font name, optionally
  61.       followed by the number of characters in that font.  The main purpose
  62.       of this file is to provide long font names (more than 8 characters).
  63.       The `+*.pk' operation yields font names truncated to 8 characters, as
  64.       DOS supports only file names of up to 8 characters (without extension).
  65.       fontlib uses the long font name from the font list if the (truncated)
  66.       font name contains exactly 8 characters and matches the first 8
  67.       characters of a long file name in the font list.  The line
  68.                 lcirclew10   70
  69.       causes the file name `lcirclew.pk' to be converted to the font name
  70.       `lcirclew10'.  The old FLI format supports only 8 characters per
  71.       font name.  The number of characters in a font (70 in the above example)
  72.       is used for checking the FLI file (/t option).  If the number of
  73.       character in a font doesn't match the number given in the font list,
  74.       a fatal error message will be displayed and fontlib will abort.  The
  75.       file \emtex\fontlist contains a list of all the fonts that come with
  76.       emTeX.
  77.  
  78. /i    After the command line has been interpreted, the user is prompted for
  79.       the operations required.  More than one operation can be entered on a
  80.       line: input is ended when an empty line is entered.  In this interactive
  81.       mode the entry of `?' will cause the selected directory and the selected
  82.       font size to be displayed.
  83.  
  84. /k    Fonts already in the library will not be replaced.  If neither /k nor /r
  85.       is given, FONTLIB will ask if an existing font is to be replaced.
  86.  
  87. /l    List the contents of the library; if the library is changed by this
  88.       call to FONTLIB, the contents of the new library will be listed.
  89.       For each font, the font name, the position in the file, and the length
  90.       will be displayed.
  91.  
  92. /r    Fonts already in the library will be replaced without query.  If neither
  93.       /k nor /r is given, FONTLIB will ask if an existing font is to be
  94.       replaced.
  95.  
  96. /t    If /t is given, every file to be entered in the library will be checked
  97.       to make sure it is a valid font file.  If /t is not given, any file can
  98.       be put in the library.  If the library is not modified, then this option
  99.       causes the files already in the library to be checked.
  100.       Using /t causes the program to run much more slowly.
  101.       When checking, only font files with an ID of 89 (PK), 1001 and 1002
  102.       (PXL) will be accepted.  See also /f*.
  103.  
  104. /v    Messages showing the progress of the library processing will be
  105.       displayed. This option should always be used.
  106.  
  107. /w    Existing files (library files and font files when copied from the
  108.       library) will be overwritten without query.
  109.  
  110. /x*   Change the library comment; the comment must immediately follow /x
  111.       without a space. If the comment contains spaces, then the comment must
  112.       be enclosed in quotes:
  113.             /x"this is a comment"
  114.  
  115. If both /r and /k are given as options then only the last one will be
  116. observed.
  117.  
  118. Options can also start with - instead of /.
  119.  
  120.  
  121. Operations
  122. ==========
  123.  
  124. font size
  125.           Sets the font size for the operation which follow.  fontlib supports
  126.           -- like dvidrv -- the following specifications of font size:
  127.                 328.63353               font size (dpi)
  128.                 300:h                   300 dpi * 1.2 ^ 0.5 (=328.63353)
  129.                 :2                      magnification step 2 (requires /b#)
  130.  
  131. directory
  132. =directory
  133.           The directory entered is taken to be the default directory for the
  134.           operations which follow.  To avoid confusion, you should precede
  135.           the directory with an equal sign.  The directory name may contain
  136.           %s and %r (font size (dpi) or PXL font size).
  137.  
  138. library name
  139.           Entering a font library name is taken to mean that any font files
  140.           used in the operations which follow are to be taken from this
  141.           library.  The path name must not contain percent signs.  If a
  142.           directory name is entered, font files are assumed to be single
  143.           files again.
  144.  
  145. +name     This font file is to be copied into the library -- before this can
  146.           be done, the font size must be set (see above).  The name can be a
  147.           path name in which case the file will be taken from the directory
  148.           given; if the name alone is used, it will be prefixed with the
  149.           default directory.  If no extension is given, first the file will be
  150.           sought under the name alone; if not found, it will then be sought
  151.           with the extension .PK and then, if it is still not found, with the
  152.           extension .PXL.
  153.           The first file found will then be copied into the library.  The
  154.           font name is derived from the file name by omitting drive, directory,
  155.           and extension.  Capital letters will be converted into lowercase.
  156.           See /f*.  If the name is to be selected from a library then it may
  157.           not be entered with a drive, directory or extension. If the font is
  158.           in the library and the /r option is not in force, the user will be
  159.           asked if it is to be replaced.  If the option /r has been given,
  160.           however, the font will be replaced without query.
  161.  
  162. -name     The font with this name and the selected size will be deleted from
  163.           the library.  The name may not be entered with either a directory or
  164.           an extension.
  165.  
  166. &library  All the fonts in this library will be copied into the library under
  167.           construction.  If the option /r has been chosen, fonts will be
  168.           replaced without query. The default extension used is .FLI and the
  169.           current directory set by the `directory' operation (see above) will
  170.           be ignored.  If this library is an old one, you should use /b# and
  171.           /f*.
  172.  
  173. #name     Fonts will be copied from the library.  The name can be a path name
  174.           and can have an extension which will be used to place the copy.  If
  175.           no directory is given, the selected directory will be used.  If no
  176.           extension is given, the copy of the file will not have an extension.
  177.           If the /w option has been selected, existing files will be
  178.           overwritten without query.  If /d is used, missing directories will
  179.           be created.
  180.  
  181. @file     This is the name of a response file, the library operations within
  182.           will be read and processed.  A response file may contain calls to
  183.           further response files.
  184.  
  185. All font names may contain the wildcard characters `?' and `*' which will be
  186. treated in the same way as PC-DOS and MS-DOS do.  NOTE: if wildcard characters
  187. are used with the +name operation an extension MUST be given: `+*', for
  188. example, will find only files without an extension -- the correct form is
  189. `+*.pk' or `+*.pxl'.  Caution: font file names are case sensitive -- they
  190. should normally be entered in lowercase.  If you're using `?' or `+', you
  191. should give the /f* option.
  192.  
  193. If you specify an invalid operation, the program automatically goes into
  194. interactive mode so that corrections can be made.
  195.  
  196. If no output file is given in the command line then the first operation
  197. must not be a directory without preceding `=' as this would be taken as the
  198. output file name: in this case the font size (or a directory preceded by `=')
  199. should be specified first.
  200.  
  201.  
  202. Examples
  203. ========
  204.  
  205. Create a new library (without prompting) and copy a number of fonts into it.
  206. Use device resolution 300 dpi (to enable :0 and :1) and the font list
  207. \emtex\fontlist for creating long font names:
  208.  
  209.     fontlib /c /b300 /f\emtex\fontlist hplaser =pxl%s :0 +*.pk :1 +*.pk
  210.  
  211.  
  212. Combine three libraries (bib1, bib2, bib3) into one (output file newbib) and
  213. remove the library comment:
  214.  
  215.     fontlib /x bib1 newbib &bib2 &bib3
  216.  
  217.  
  218. Convert an old FLI file to the new format, device resolution is 240 dpi:
  219.  
  220.     fontlib /2 /b240 /f\emtex\fontlist fx_1440 fx_1
  221.  
  222.  
  223. Convert a new FLI file to the old format:
  224.  
  225.     fontlib /1 fx_1 fx_1440
  226.  
  227.  
  228. Copy a few fonts out of a library displaying the actions as they take place:
  229.  
  230.     fontlib /w /v /b300 /d myfonts =c:\pixel\%rdpi :0 #cm*.pk :1 #lasy10.pk
  231.  
  232.  
  233. Check and list the contents of a library (the number of characters in each
  234. font listed with a number in \emtex\fontlist will be checked too):
  235.  
  236.     fontlib /l/t/f\emtex\fontlist hplaser
  237.  
  238.  
  239. Carry out large scale modifications with interactive input, display all
  240. operations, replace fonts without query and include a new comment:
  241.  
  242.     fontlib /i/v/r /x"New comment" c:epsonfx d:epsonfx
  243.  
  244.  
  245. Create a new library (300 dpi base resolution) using a response file:
  246.  
  247.     fontlib /c/v/f\emtex\fontlist /b300 newlib =c:\newfonts\$rdpi @all.rsp
  248.  
  249. ... all.rsp contains the following line:
  250.  
  251.     :0 +*.pk :1 +*.pk :2 +*.pk :3 +*.pk :4 +*.pk :5 +*.pk :h +*.pk
  252.  
  253.  
  254. History
  255. =======
  256.  
  257. 1.0a    First usable version.
  258.  
  259. 1.0b    Fatal errors and warnings numbered.
  260.         Checking of font files.
  261.         `*' and `?' can be used in operations.
  262.  
  263. 1.0c    Font names shortened to 8 characters.
  264.         Interactive input with /i option.
  265.         Adding library files with: &library.
  266.         File and font overwriting query with: /w, /r.
  267.         Output file can be given.
  268.  
  269. 1.0d    PXL files with ID 1002 are accepted as valid.
  270.  
  271. 1.0e    File buffers increased.
  272.  
  273. 1.0f    @response files.
  274.  
  275. 1.0g    /k option.
  276.         Reading from library files.
  277.  
  278. 1.0h    Now runs under OS/2 (bound version)
  279.  
  280. 1.0i    "Disk full" did not always give an error message.
  281.  
  282. 1.0j    The greatest font size is now 66535 (earlier 32767).
  283.  
  284. 1.1a    New FLI file format.
  285.         New options: /1, /2, /b#, /d, /f*.
  286.         Specifying font sizes using dpi instead of PXL font size.
  287.         %s and %r in directory names.
  288.         Options starting with -.
  289.