From 03c6ca930c14724aa453722eaa8bfb4e1f12fa02 Mon Sep 17 00:00:00 2001 From: David Turner Date: Fri, 8 Feb 2002 10:50:12 +0000 Subject: [PATCH] adding comments to FT_Get_Next_Char --- ChangeLog | 8 ++++++++ include/freetype/freetype.h | 30 +++++++++++++++++++++++++++--- 2 files changed, 35 insertions(+), 3 deletions(-) diff --git a/ChangeLog b/ChangeLog index 704be4a6e..990500c75 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,9 @@ +2002-02-08 David Turner + + * include/freetype/freetype.h: adding comments to FT_Get_Next_Char + note that this function might temporarily be removed for the 2.0.8 + release.. + 2002-02-07 David Turner * src/pcf/pcfread.c (pcf_load_font): Removed immature support of @@ -32,6 +38,7 @@ better (delaying format checks out of FT_Access_Frame .. FT_Forget_Frame blocks to avoid leaving the stream in an incorrect state when encountering an invalid PCF font). + * src/pcf/pcfdriver.c (PCF_Done_Face): Renamed to ... (PCF_Face_Done): This. (PCF_Init_Face): Renamed to ... @@ -41,6 +48,7 @@ (PCF_Get_Next_Char): Renamed to ... (PCF_Char_Get_Next): This. (pcf_driver_class): Updated. + * src/pcf/pcf.h (PCF_Done_Face): Removed. 2002-02-06 Detlef Würkner diff --git a/include/freetype/freetype.h b/include/freetype/freetype.h index d6275a6e7..17e5fe31c 100644 --- a/include/freetype/freetype.h +++ b/include/freetype/freetype.h @@ -2398,15 +2398,39 @@ FT_BEGIN_HEADER /* FT_Get_Next_Char */ /* */ /* */ - /* Returns the next charcode that is defined in the charmap. */ + /* Returns the next charcode that is defined in a face's current */ + /* charmap. */ /* */ /* */ /* face :: A handle to the source face object. */ /* */ - /* charcode :: The character code. */ + /* charcode :: The current character code. */ /* */ /* */ - /* The charcode. 0 means `no encoded values above charcode'. */ + /* The next character code in the current charmap. 0 means */ + /* `no encoded values above charcode'. */ + /* */ + /* */ + /* You can always retrieve the first charcode in a given charmap */ + /* by calling FT_Get_Next_Char(face,0) */ + /* */ + /* (this assumes that 0 is not a valid character code in any known */ + /* charmap format, which is basically true for TrueType and Type1) */ + /* */ + /* note that certain charmaps can map character codes to "empty" */ + /* glyphs sometimes. Here are two examples: */ + /* */ + /* - the embedded bitmaps were stripped from the font, and certain */ + /* glyphs didn't have a corresponding outline */ + /* */ + /* - the font is a sub-set of another one and was generated with */ + /* a tool that simply changed the glyph tables, but not the */ + /* charmap.. */ + /* */ + /* you should thus use this function only to enumerate charmaps. If */ + /* you need to determine the list of "displayable" glyphs, you'll */ + /* need to use FT_Load_Glyph or wait until we provide another API */ + /* to do that.. */ /* */ FT_EXPORT( FT_ULong ) FT_Get_Next_Char( FT_Face face,