On 22/08/12 17:11, Werner LEMBERG wrote:
>> Should perhaps the API docs for FT_Request_Size indicate this, along
>> with a link to the glyph doc?
> Yes, this would be helpful.  Can you provide a patch for freetype.h?

Okay, I've tried to keep it simple and just direct to the full doc.

Attached patch is using git diff.

-- 
edA-qa mort-ora-y
-- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
Sign: Please digitally sign your emails.
Encrypt: I'm also happy to receive encrypted mail.
diff --git a/freetype.h b/comment_freetype.h
index 65cfa53..14a9a7b 100644
--- a/freetype.h
+++ b/comment_freetype.h
@@ -2231,6 +2231,11 @@ 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 +2305,10 @@ FT_BEGIN_HEADER
   /* <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,
                       FT_UInt  pixel_width,

Attachment: signature.asc
Description: OpenPGP digital signature

_______________________________________________
Freetype mailing list
[email protected]
https://lists.nongnu.org/mailman/listinfo/freetype

Reply via email to