From 5fe7c044c25bba9dfae315ef56bacfc83976ddd0 Mon Sep 17 00:00:00 2001 From: David Turner Date: Tue, 14 Jul 2020 16:12:29 +0200 Subject: [PATCH] freetype.h (FT_Set_Transform): Minor documentation update. 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..71e22a1d6 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