... |
... |
@@ -526,9 +526,11 @@ FT_BEGIN_HEADER |
526
|
526
|
* functions like @FT_Load_Glyph to determine the scaling transformation
|
527
|
527
|
* that in turn is used to load and hint glyphs and metrics.
|
528
|
528
|
*
|
529
|
|
- * You can use @FT_Set_Char_Size, @FT_Set_Pixel_Sizes, @FT_Request_Size
|
|
529
|
+ * A newly created `FT_Size` object contains only meaningless zero values.
|
|
530
|
+ * You must use @FT_Set_Char_Size, @FT_Set_Pixel_Sizes, @FT_Request_Size
|
530
|
531
|
* or even @FT_Select_Size to change the content (i.e., the scaling
|
531
|
|
- * values) of the active `FT_Size`.
|
|
532
|
+ * values) of the active `FT_Size`. Otherwise, the scaling and hinting
|
|
533
|
+ * will not be performed.
|
532
|
534
|
*
|
533
|
535
|
* You can use @FT_New_Size to create additional size objects for a given
|
534
|
536
|
* @FT_Face, but they won't be used by other functions until you activate
|
... |
... |
@@ -2828,10 +2830,9 @@ FT_BEGIN_HEADER |
2828
|
2830
|
*
|
2829
|
2831
|
* @note:
|
2830
|
2832
|
* For proper scaling and hinting, the active @FT_Size object owned by
|
2831
|
|
- * the face has to be meaningfully non-trivially initialized by
|
2832
|
|
- * calling @FT_Set_Char_Size before this function, for example.
|
2833
|
|
- * The loaded glyph may be transformed. See @FT_Set_Transform for the
|
2834
|
|
- * details.
|
|
2833
|
+ * the face has to be meaningfully initialized by calling
|
|
2834
|
+ * @FT_Set_Char_Size before this function, for example. The loaded
|
|
2835
|
+ * glyph may be transformed. See @FT_Set_Transform for the details.
|
2835
|
2836
|
*
|
2836
|
2837
|
* For subsetted CID-keyed fonts, `FT_Err_Invalid_Argument` is returned
|
2837
|
2838
|
* for invalid CID values (this is, for CID values that don't have a
|