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