|The HBF header file name of the input font(s). hbf2gf uses the given searching mechanism (kpathsea, emtexdir, or MiKTeX) to locate this file.|
|The name stem of the output files. A running two digit decimal number starting with 01 will be appended. For Unicode fonts see the keyword unicode below. This value is in almost all cases identical to the name of the configuration file.|
|And now all optional keywords:|
|Increases the character width. Will be applied on both sides; default for non-rotated glyphs is the value given in the HBF header (HBF_BITMAP_BOUNDING_BOX) scaled to design_size (in pixels).|
|Shifts all characters up or down; default for non-rotated glyphs is the value given in the HBF header (HBF_BITMAP_BOUNDING_BOX) scaled to design_size (in pixels).|
|The design size (in points) of the font. x_offset and y_offset refer to this size. Default is 10.0.|
|slant||The slant of the font (given as /\x / /\y). Only values in the range 0 <= slant <= 1 are allowed. Default is 0.0.|
|If set to yes, all glyphs will be rotated 90 degrees counter-clockwise. The default offsets as given in the HBF header will be ignored (and set to 0). Default is no.|
|mag_y||Scaling values of the characters to reach design size. If only one magnification is given, x and y values are assumed to be equal. Default is mag_x = mag_y = 1.0.|
|A value between 1 and 254 defining a threshold for converting the internal graymap into the output bitmap; lower values cut more pixels. Default value is 128.|
|A comment describing the font; default is none.|
|The number of subfonts to create. Default value is -1 for creating all fonts.|
|If yes, a two digit hexadecimal number will be used as a running number, starting with the value of the first byte of the first code range. Default is no.|
|The minimum value of the encoding. You should set this value to get correct subfile offsets if it is not identical to the lowest character code in the HBF file.|
|dpi_y||The horizontal and vertical resolution (in dpi) of the printer. If only one resolution is given, x and y values are assumed to be equal. Default is 300.|
|A checksum to identify the GF files with the appropriate TFM files. The default value of this unsigned 32bit integer is 0.|
|coding||A comment describing the coding scheme; default is none.|
|The destination directory of the PK files; default: none. Attention! The batch file will not check whether this directory exists.|
|The destination directory of the TFM files; default: none. Attention! The batch file will not check whether this directory exists.|
|Whether to create PK files or not; default is yes.|
|Whether to create TFM files or not; default is yes.|
|Whether to create an OPL file or not; default is no. The batch file will then use ovp2ovf of the Omega distribution to convert it into an OFM and an OVF file. The OPL file simply maps all subfonts back to a single Omega font.|
|If yes, PK files will include the resolution in the extension (e.g. gsso1201.300pk). This affects the batch file only (default is yes).|
|The shell command to remove files; default: rm.|
|The shell command to copy files; default: cp.|
|The extension of the batch file which calls gftopk and pltotf to convert the GF and the PL files into PK and TFM files respectively; default is none.|
hbf2gf uses either the kpathsea, emtexdir, or MiKTeX library for searching files (emtexdir will work only on operating systems which have an MS-DOSish background, i.e., MS-DOS, OS/2, Windows; MiKTeX is for Win32 systems).
The actual version of kpathsea is displayed on screen if you call hbf2gf --version.
Here is a table of the file type and the corresponding kpathsea variables.
Please consult the info files of kpathsea for details on these variables. The decision which naming scheme to use for variables will be done during compilation.
You should set the TEXMFCNF variable to the directory where your texmf.cnf configuration file resides.
Here is the proper command to find out to which value a kpathsea variable is set (we use MISCFONTS as an example). This is especially useful if a variable isnt set in texmf.cnf or in the environment, thus pointing to the default value which is hard-coded into the kpathsea library.
kpsewhich -progname=hbf2gf -expand-var=$MISCFONTS
We select the program name also since it is possible to specify variables which are searched only for a certain program - in our example it would be MISCFONTS.hbf2gf.
A similar but not identical method is to say
kpsewhich -progname=hbf2gf -show-path=misc fonts
[A full list of format types can be obtained by saying kpsewhich --help on the command line prompt.] This is exactly how hbf2gf searches for files; the disadvantage is that all variables are expanded which can cause very long strings.
Here the list of suffixes and its related environment variables to be set in autoexec.bat (resp. in config.sys for OS/2):
If one of the variables isnt set, a warning message is emitted. The current directory will always be searched. As usual, one exclamation mark appended to a directory path causes subdirectories one level deep to be searched, two exclamation marks causes all subdirectories to be searched. Example:
Constructions like c:\\fonts!!\\hbf arent possible.
Please consult the documentation files of MiKTeX for more details.
The x and y output size must not exceed MAX_CHAR_SIZE, which is defined at compile time; its default value is 1023 (pixel).
hbf2gf.w: this is the source code written in CWEB which can be converted into a pretty-printed TEX document using cweave. The CJK package also contains a preformatted hbf2gf.pdf file.
the CJK documentation files ( hbf2gf.txt).
the Hanzi Bitmap File (HBF) standard version 1.3; available at ftp.ifcss.org.
the Omega documentation available at ftp.ens.fr and the CTAN hosts and mirrors.
*.cfg The hbf2gf configuration scripts. *.hbf HBF header files which describe fixed-width bitmap fonts. Note that the bitmap font name(s) themselves as specified in the header files are irrelevant for hbf2gf.
hbf2gf is part of the CJK macro package for LATEX2e available at the CTAN hosts and its mirrors.
CJK fonts together with HBF header files can be found at ftp.ifcss.org and its mirrors.
Werner Lemberg <firstname.lastname@example.org>
Ross Paterson (the HBF API) <email@example.com>
|CJK Version 4.8.4||HBF2GF (1)||18-Apr-2015|