freetype-commit
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Git][freetype/freetype][master] * include/freetype/freetype.h: Clarify


From: Alexei Podtelezhnikov (@apodtele)
Subject: [Git][freetype/freetype][master] * include/freetype/freetype.h: Clarify `FT_Size` life cycle.
Date: Thu, 20 Jan 2022 15:06:12 +0000

Alexei Podtelezhnikov pushed to branch master at FreeType / FreeType

Commits:

1 changed file:

Changes:

  • include/freetype/freetype.h
    ... ... @@ -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
    


  • reply via email to

    [Prev in Thread] Current Thread [Next in Thread]