It is however possible to create more sizes for a given face, mostly in order to manage several character pixel sizes of the same font family and style. See FT_New_Size and FT_Done_Size.
99% of applications won't need the functions provided here, especially if they use the caching sub-system, so be cautious when using these.
FT_Done_Size
Defined in FT_SIZES_H (freetype/ftsizes.h).
FT_EXPORT( FT_Error )
FT_Done_Size( FT_Size size );
Discard a given size object. Note that FT_Done_Face automatically discards all size objects allocated with FT_New_Size.
input
| size |
A handle to a target size object.
|
return
FreeType error code. 0 means success.
FT_Activate_Size
Defined in FT_SIZES_H (freetype/ftsizes.h).
FT_EXPORT( FT_Error )
FT_Activate_Size( FT_Size size );
Even though it is possible to create several size objects for a given face (see FT_New_Size for details), functions like FT_Load_Glyph or FT_Load_Char only use the one that has been activated last to determine the ‘current character pixel size’.
This function can be used to ‘activate’ a previously created size object.
input
| size |
A handle to a target size object.
|
return
FreeType error code. 0 means success.
note
If ‘face’ is the size's parent face object, this function changes the value of ‘face->size’ to the input size handle.