freetype-commit
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[freetype2] master 5fe7c04: freetype.h (FT_Set_Transform): Minor documen


From: Werner LEMBERG
Subject: [freetype2] master 5fe7c04: freetype.h (FT_Set_Transform): Minor documentation update.
Date: Tue, 14 Jul 2020 10:27:42 -0400 (EDT)

branch: master
commit 5fe7c044c25bba9dfae315ef56bacfc83976ddd0
Author: David Turner <david@freetype.org>
Commit: Werner Lemberg <wl@gnu.org>

    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 ba3950e..71e22a1 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



reply via email to

[Prev in Thread] Current Thread [Next in Thread]