Improve/add source comments and documentation.

This commit is contained in:
Werner Lemberg 2023-04-25 09:54:09 +02:00
parent 40676afc4c
commit 0a3836c97d
2 changed files with 12 additions and 10 deletions

View File

@ -1002,7 +1002,7 @@ FT_BEGIN_HEADER
* Note that the bounding box might be off by (at least) one pixel for * Note that the bounding box might be off by (at least) one pixel for
* hinted fonts. See @FT_Size_Metrics for further discussion. * hinted fonts. See @FT_Size_Metrics for further discussion.
* *
* Note that the bounding box does not vary in OpenType variable fonts * Note that the bounding box does not vary in OpenType variation fonts
* and should only be used in relation to the default instance. * and should only be used in relation to the default instance.
* *
* units_per_EM :: * units_per_EM ::
@ -1090,9 +1090,9 @@ FT_BEGIN_HEADER
FT_Generic generic; FT_Generic generic;
/*# The following member variables (down to `underline_thickness`) */ /* The following member variables (down to `underline_thickness`) */
/*# are only relevant to scalable outlines; cf. @FT_Bitmap_Size */ /* are only relevant to scalable outlines; cf. @FT_Bitmap_Size */
/*# for bitmap fonts. */ /* for bitmap fonts. */
FT_BBox bbox; FT_BBox bbox;
FT_UShort units_per_EM; FT_UShort units_per_EM;
@ -1110,7 +1110,7 @@ FT_BEGIN_HEADER
FT_Size size; FT_Size size;
FT_CharMap charmap; FT_CharMap charmap;
/*@private begin */ /* private fields, internal to FreeType */
FT_Driver driver; FT_Driver driver;
FT_Memory memory; FT_Memory memory;
@ -1123,8 +1123,6 @@ FT_BEGIN_HEADER
FT_Face_Internal internal; FT_Face_Internal internal;
/*@private end */
} FT_FaceRec; } FT_FaceRec;

View File

@ -817,9 +817,9 @@
if ( !found ) if ( !found )
{ {
/* as a last resort we try the family name; note that this is */ /* according to the 'name' documentation in the OpenType */
/* not in the Adobe TechNote, but GX fonts (which predate the */ /* specification the font family name is to be used if the */
/* TechNote) benefit from this behaviour */ /* typographic family name is missing, so let's do that */
found = sfnt_get_name_id( face, found = sfnt_get_name_id( face,
TT_NAME_ID_FONT_FAMILY, TT_NAME_ID_FONT_FAMILY,
&win, &win,
@ -851,6 +851,10 @@
{ {
FT_TRACE0(( "sfnt_get_var_ps_name:" FT_TRACE0(( "sfnt_get_var_ps_name:"
" No valid PS name prefix for font instances found\n" )); " No valid PS name prefix for font instances found\n" ));
/* XXX It probably makes sense to never let this fail */
/* since an arbitrary prefix should work, too. */
/* On the other hand, it is very unlikely that */
/* we ever reach this code at all. */
return NULL; return NULL;
} }