ref: a76108ba0babb5ebb2a5d5929bc8422db566bdcd
parent: e5bcbf95a8134e4629613bc02381bf8eef9501ad
author: Werner Lemberg <[email protected]>
date: Sun Apr 3 16:11:42 EDT 2005
* docs/CHANGES, include/freetype/freetype.h: Improve documentation of FT_Set_Pixel_Sizes and FT_Set_Char_Size.
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2005-04-03 Werner Lemberg <[email protected]>
+
+ * docs/CHANGES, include/freetype/freetype.h: Improve documentation
+ of FT_Set_Pixel_Sizes and FT_Set_Char_Size.
+
2005-03-26 Detlef W�rkner <[email protected]>
* builds/amiga/src/base/ftsystem.c (ft_amiga_stream_io): Fix buffer
--- a/docs/CHANGES
+++ b/docs/CHANGES
@@ -64,6 +64,15 @@
an FT_Bitmap structure in 1bpp, 2bpp, 4bpp, or 8bpp format into
another 8bpp FT_Bitmap, probably using a different pitch.
+ - The method how BDF and PCF bitmap fonts are accessed has been
+ refined. Formerly, FT_Set_Pixel_Sizes and FT_Set_Char_Size
+ were synonyms in FreeType's BDF and PCF interface. This has
+ changed now. FT_Set_Pixel_Sizes should be used to select the
+ actual font dimensions (the `strike', which is the sum of the
+ `FONT_ASCENT' and `FONT_DESCENT' properties), while
+ FT_Set_Char_Size selects the `nominal' size (the `PIXELSIZE'
+ property). In both functions, the width parameter is ignored.
+
III. MISCELLANEOUS
--- a/include/freetype/freetype.h
+++ b/include/freetype/freetype.h
@@ -2041,8 +2041,9 @@
/* FreeType error code. 0 means success. */
/* */
/* <Note> */
- /* When dealing with fixed-size faces (i.e., non-scalable formats), */
- /* @FT_Set_Pixel_Sizes provides a more convenient interface. */
+ /* For BDF and PCF formats, this function uses the `PIXEL_SIZE' */
+ /* property of the bitmap font; the `char_width' parameter is */
+ /* ignored. */
/* */
FT_EXPORT( FT_Error )
FT_Set_Char_Size( FT_Face face,
@@ -2094,6 +2095,9 @@
/* the height of the bitmap cell. Drivers for bitmap font formats */
/* which contain a single bitmap strike only (BDF, PCF, FNT) ignore */
/* `pixel_width'. */
+ /* */
+ /* For BDF and PCF formats, this function uses the sum of the */
+ /* `FONT_ASCENT' and `FONT_DESCENT' properties of the bitmap font. */
/* */
FT_EXPORT( FT_Error )
FT_Set_Pixel_Sizes( FT_Face face,