ref: fc61b5f211c76ce320a44a1b3e873b977103bc63
parent: 495bd3cc4f54f5f4604709391a716fcd0c033277
author: Werner Lemberg <[email protected]>
date: Tue Jun 12 04:07:19 EDT 2012
Fix Savannah bug #36634. Minor documentation improvement of FT_Get_Char_Index.
--- a/include/freetype/freetype.h
+++ b/include/freetype/freetype.h
@@ -3093,9 +3093,15 @@
/* <Note> */
/* If you use FreeType to manipulate the contents of font files */
/* directly, be aware that the glyph index returned by this function */
- /* doesn't always correspond to the internal indices used within */
- /* the file. This is done to ensure that value~0 always corresponds */
- /* to the `missing glyph'. */
+ /* doesn't always correspond to the internal indices used within the */
+ /* file. This is done to ensure that value~0 always corresponds to */
+ /* the `missing glyph'. If the first glyph is not named `.notdef', */
+ /* then for Type~1 and Type~42 fonts, `.notdef' will be moved into */
+ /* the glyph ID~0 position, and whatever was there will be moved to */
+ /* the position `.notdef' had. For Type~1 fonts, if there is no */
+ /* `.notdef' glyph at all, then one will be created at index~0 and */
+ /* whatever was there will be moved to the last index -- Type~42 */
+ /* fonts are considered invalid under this condition. */
/* */
FT_EXPORT( FT_UInt )
FT_Get_Char_Index( FT_Face face,