ref: 5fe7c044c25bba9dfae315ef56bacfc83976ddd0
parent: 95de21ab19cc5409ea09c9347f1d9b5e2cc2d332
author: David Turner <david@freetype.org>
date: Tue Jul 14 12:12:29 EDT 2020
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.
--- a/include/freetype/freetype.h
+++ b/include/freetype/freetype.h
@@ -3175,6 +3175,12 @@
* 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