Example
This is an example font containing one glyph, for ASCII capital 'A'. This glyph is taken from the GNU Unifont.
STARTFONT 2.1 FONT -gnu-unifont-medium-r-normal--16-160-75-75-c-80-iso10646-1 SIZE 16 75 75 FONTBOUNDINGBOX 16 16 0 -2 STARTPROPERTIES 2 FONT_ASCENT 14 FONT_DESCENT 2 ENDPROPERTIES CHARS 1 STARTCHAR U+0041 ENCODING 65 SWIDTH 500 0 DWIDTH 8 0 BBX 8 16 0 -2 BITMAP 00 00 00 00 18 24 24 42 42 7E 42 42 42 42 00 00 ENDCHAR ENDFONTIn the above example, the global declarations begin with the "STARTFONT" line and end with the "CHARS" line.
"STARTFONT 2.1" defines the version of this BDF file as version 2.1.
"FONT -gnu-unifont-medium-r-normal--16-160-75-75-c-80-iso10646-1" defines the font family and face names.
"SIZE 16 75 75" defines this to be a 16 point font, with an X-axis resolution of 75 dots per inch (dpi) and a Y-axis resolution of 75 dpi. This is the norm under X Window.
"FONTBOUNDINGBOX 16 16 0 -2" defines a bounding box for the font of 16 pixels wide by 16 pixels high, with the lower left-hand corner starting at x=0, y=-2. Note that although the bounding box is defined to be a 16 by 16 cell, this can be overridden for individual glyphs. The "A" glyph, for example, is only 8 pixels wide.
"STARTPROPERTIES 2" declares that two special properties will follow. "STARTPROPERTIES" is optional in the BDF specification. X Window allows the properties FONT_ASCENT and FONT_DESCENT to show the height above and below the baseline, respectively, for all glyphs. "FONT_ASCENT 14" declares that 14 of the 16 pixels in height are above the baseline. "FONT_DESCENT 2" declares that 2 of the 16 pixels in height are below the baseline. "ENDPROPERTIES" appears at the end of the "STARTPROPERTIES" section.
"CHARS 1" declares that one character will follow. Although Adobe now refers to this file format as the Glyph BDF, they have retained the keyword "CHARS" in the final version of the specification.
Lines beginning with the word "COMMENT" can be inserted within a BDF file. Anything following the "COMMENT" keyword on a line is ignored.
Following the above global declarations, the following entries are repeated for each glyph.
"STARTCHAR U+0041" specifies the start of a character in version 2.1 and earlier, or of a glyph in version 2.2. The string name of this particular character is "U+0041", which is the Unicode convention for the code point hexadecimal 41 (decimal 65, the ASCII character "A"). In version 2.1 and earlier, the character name string was limited to 14 characters. In version 2.2, the glyph name string can contain up to 65,535 characters.
"ENCODING 65" declares the decimal code point for this glyph in the font.
"SWIDTH 500 0" declares the Scalable Width of 500 on the X-axis and 0 (default) on the Y-axis. This will result in an X-axis offset to the next glyph, but no Y-axis offset to the next glyph (i.e., the glyphs appear straight across in a line). The scalable width is 1000 times the actual point size of the character -- the same unit used in an Adobe Font Metric (AFM) file. The number of pixels calculated as
pixels = (scalable_width / 1000) * (resolution / 72),
where scalable_width is 500 in this example, and resolution is 75 dpi for this font. Because 75 is approximately equal to 72, the number of pixels is the full width of a glyph (defined globally as 16 pixels) times 500 / 1000, or in other words the width of this glyph is 8 pixels.
"DWIDTH 8 0" declares the Device Width of a glyph. In this case, after the glyph is rendered, the start of the next glyph is offset 8 pixels on the X-axis and 0 pixels on the Y-axis from the current glyph origin. Note that the Device Width is not necessarily equal to the width of the glyph. It is simply the offset on the X-axis to move the current point to the start of the next glyph.
The Scalable Width is used to calculate the width of a high-resolution glyph on a printer, whereas the Device Width is used to calculate the width of a glyph on a display device. Thus Scalable Width is specified to greater precision than Device Width.
"BBX 8 16 0 -2" declares a bounding box that is 8 pixels wide and 16 pixels tall. The lower left-hand corner of the character is offset by 0 pixels on the X-axis and -2 pixels on the Y-axis.
"BITMAP" begins the bitmap for the current glyph. This line must be followed by one line per pixel on the Y-axis. In this example the glyph is 16 pixels tall, so 16 lines follow. Each line contains the hexadecimal representation of pixels in a row. A "1" bit indicates a rendered pixel. Each line is rounded to an 8 bit (one byte) boundary, padded with zeroes on the right. In this example, the glyph is exactly 8 pixels wide, and so occupies exactly bits (one byte) per line so that there is no padding. The most significant bit of a line of raster data represents the leftmost pixel.
"ENDCHAR" ends the current glyph.
The declaractions "STARTCHAR" through "ENDCHAR" are repeated for each glyph in a font.
"ENDFONT" appears as the last line in the file, after all glyphs in the font have been enumerated.
Read more about this topic: Glyph Bitmap Distribution Format
Famous quotes containing the word example:
“Our intellect is not the most subtle, the most powerful, the most appropriate, instrument for revealing the truth. It is life that, little by little, example by example, permits us to see that what is most important to our heart, or to our mind, is learned not by reasoning but through other agencies. Then it is that the intellect, observing their superiority, abdicates its control to them upon reasoned grounds and agrees to become their collaborator and lackey.”
—Marcel Proust (1871–1922)