From b1286b32a9f2bcba3f22c9857ba6df30733b7845 Mon Sep 17 00:00:00 2001 From: Ben Wagner Date: Thu, 9 Jul 2020 14:31:00 -0400 Subject: [PATCH] Document `FT_Face_Rec_::box' with variable fonts (#54969). As pointed out in the "Note:" in the section of https://docs.microsoft.com/en-us/typography/opentype/spec/otvaroverview#variation-data-tables-and-miscellaneous-requirements ... the xMin, yMin, xMax, yMax, macStyle and lowestRecPPEM fields in the font header ('head') table are not supported by variation data and should only be used in relation to the default instance for the font. Document that `FT_Face_Rec_::box' does not vary with OpenType variable fonts. --- include/freetype/freetype.h | 3 +++ 1 file changed, 3 insertions(+) diff --git a/include/freetype/freetype.h b/include/freetype/freetype.h index 39662784d..ba3950e63 100644 --- a/include/freetype/freetype.h +++ b/include/freetype/freetype.h @@ -958,6 +958,9 @@ FT_BEGIN_HEADER * Note that the bounding box might be off by (at least) one pixel for * hinted fonts. See @FT_Size_Metrics for further discussion. * + * Note that the bounding box does not vary in OpenType variable fonts + * and should only be used in relation to the default instance. + * * units_per_EM :: * The number of font units per EM square for this face. This is * typically 2048 for TrueType fonts, and 1000 for Type~1 fonts. Only