From 631c16837f08cdabaa1d0fe76e0fe7dc3343a928 Mon Sep 17 00:00:00 2001 From: David Turner Date: Tue, 14 Jul 2020 16:12:29 +0200 Subject: [doc] Update FT_Set_Transform documentation. In order to mention the limited accuracy of FT_Matrix coefficients and encourage client code to perform the transform themselves with floating point values instead. --- include/freetype/freetype.h | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/include/freetype/freetype.h b/include/freetype/freetype.h index ba3950e63..1b603a55f 100644 --- a/include/freetype/freetype.h +++ b/include/freetype/freetype.h @@ -3175,6 +3175,12 @@ FT_BEGIN_HEADER * A pointer to the translation vector. Use `NULL` for the null vector. * * @note: + * This function is provided as a convenience, but keep in mind that + * FT_Matrix coefficients are only 16.16 fixed point values, which can + * limit the accuracy of the results. Using floating-point computations + * to perform the transform directly in client code instead will always + * yield better numbers. + * * The transformation is only applied to scalable image formats after the * glyph has been loaded. It means that hinting is unaltered by the * transformation and is performed on the character size given in the -- 2.20.1