From 403515edcf7d55d8efe4db455c4fb0ef5196524f Mon Sep 17 00:00:00 2001 From: edA-qa mort-ora-y Date: Thu, 30 Aug 2012 06:23:31 +0200 Subject: [PATCH] Improve documentation of FT_Request_Size and FT_Set_Pixel_Sizes. --- include/freetype/freetype.h | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/include/freetype/freetype.h b/include/freetype/freetype.h index 65cfa532c..af020efb4 100644 --- a/include/freetype/freetype.h +++ b/include/freetype/freetype.h @@ -2231,6 +2231,12 @@ FT_BEGIN_HEADER /* 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 ); @@ -2300,6 +2306,11 @@ FT_BEGIN_HEADER /* */ /* FreeType error code. 0~means success. */ /* */ + /* */ + /* 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, FT_UInt pixel_width,