diff options
author | Alexei Podtelezhnikov <apodtele@gmail.com> | 2022-01-20 15:06:09 +0000 |
---|---|---|
committer | Alexei Podtelezhnikov <apodtele@gmail.com> | 2022-01-20 15:06:09 +0000 |
commit | 99a940f84acb1c2adc0f66d3473b5aad14c7c61f (patch) | |
tree | 1a4108a57a08f4ade2653d73197d1100d15c41af | |
parent | 054782c48ef12988bc278a7667c9368bf74e50d0 (diff) | |
download | freetype2-99a940f84acb1c2adc0f66d3473b5aad14c7c61f.tar.gz |
* include/freetype/freetype.h: Clarify `FT_Size` life cycle.
-rw-r--r-- | include/freetype/freetype.h | 13 |
1 files changed, 7 insertions, 6 deletions
diff --git a/include/freetype/freetype.h b/include/freetype/freetype.h index cb31c3cd7..101863659 100644 --- a/include/freetype/freetype.h +++ b/include/freetype/freetype.h @@ -526,9 +526,11 @@ FT_BEGIN_HEADER * functions like @FT_Load_Glyph to determine the scaling transformation * that in turn is used to load and hint glyphs and metrics. * - * You can use @FT_Set_Char_Size, @FT_Set_Pixel_Sizes, @FT_Request_Size + * A newly created `FT_Size` object contains only meaningless zero values. + * You must use @FT_Set_Char_Size, @FT_Set_Pixel_Sizes, @FT_Request_Size * or even @FT_Select_Size to change the content (i.e., the scaling - * values) of the active `FT_Size`. + * values) of the active `FT_Size`. Otherwise, the scaling and hinting + * will not be performed. * * You can use @FT_New_Size to create additional size objects for a given * @FT_Face, but they won't be used by other functions until you activate @@ -2828,10 +2830,9 @@ FT_BEGIN_HEADER * * @note: * For proper scaling and hinting, the active @FT_Size object owned by - * the face has to be meaningfully non-trivially initialized by - * calling @FT_Set_Char_Size before this function, for example. - * The loaded glyph may be transformed. See @FT_Set_Transform for the - * details. + * the face has to be meaningfully initialized by calling + * @FT_Set_Char_Size before this function, for example. The loaded + * glyph may be transformed. See @FT_Set_Transform for the details. * * For subsetted CID-keyed fonts, `FT_Err_Invalid_Argument` is returned * for invalid CID values (this is, for CID values that don't have a |