ref: 403515edcf7d55d8efe4db455c4fb0ef5196524f
parent: 590344cde09f6b9645e98c5bbe6e5960c34449f1
author: edA-qa mort-ora-y <[email protected]>
date: Thu Aug 30 02:23:31 EDT 2012
Improve documentation of FT_Request_Size and FT_Set_Pixel_Sizes.
--- a/include/freetype/freetype.h
+++ b/include/freetype/freetype.h
@@ -2231,6 +2231,12 @@
/* particular bitmap strike. Use @FT_Select_Size instead in that */
/* case. */
/* */
+ /* The relation between the requested size and the resulting glyph */
+ /* size is dependent entirely on how the size is defined in the */
+ /* source face. The font designer chooses the final size of each */
+ /* glyph relative to this size. For more information refer to */
+ /* `http://www.freetype.org/freetype2/docs/glyphs/glyphs-2.html' */
+ /* */
FT_EXPORT( FT_Error )
FT_Request_Size( FT_Face face,
FT_Size_Request req );
@@ -2299,6 +2305,11 @@
/* */
/* <Return> */
/* FreeType error code. 0~means success. */
+ /* */
+ /* <Note> */
+ /* You should not rely on the resulting glyphs matching, or being */
+ /* constrained, to this pixel size. Refer to @FT_Request_Size to */
+ /* understand how requested sizes relate to actual sizes. */
/* */
FT_EXPORT( FT_Error )
FT_Set_Pixel_Sizes( FT_Face face,