ref: e592982a836c41050600d63ecf449ff8ab6a9a76
parent: c5516e0f7cd0c7075381b15d3194a640f4d35ee3
author: Anuj Verma <[email protected]>
date: Tue Jul 13 06:00:22 EDT 2021
[sdf] Improve documentation.
--- a/include/freetype/freetype.h
+++ b/include/freetype/freetype.h
@@ -3307,13 +3307,13 @@
* pixels and use the @FT_PIXEL_MODE_LCD_V mode.
*
* FT_RENDER_MODE_SDF ::
- * This mode corresponds to 8-bit signed distance fields (SDF)
- * bitmaps. Each pixel in a SDF bitmap contains information about the
- * nearest edge of the glyph outline. The distances are calculated
- * from the center of the pixel and are positive if they are filled by
- * the outline (i.e., inside the outline) and negative otherwise.
- * Check the note below on how to convert the output values to usable
- * data.
+ * This mode corresponds to 8-bit, single-channel signed distance field
+ * (SDF) bitmaps. Each pixel in the SDF grid is the value from the
+ * pixel's position to the nearest glyph's outline. The distances are
+ * calculated from the center of the pixel and are positive if they are
+ * filled by the outline (i.e., inside the outline) and negative
+ * otherwise. Check the note below on how to convert the output values
+ * to usable data.
*
* @note:
* The selected render mode only affects vector glyphs of a font.
--- a/src/sdf/ftsdf.c
+++ b/src/sdf/ftsdf.c
@@ -41,7 +41,8 @@
* file `ftbsdf.c` for more.
*
* * The basic idea of generating the SDF is taken from Viktor Chlumsky's
- * research paper.
+ * research paper. The paper explains both single and multi-channel
+ * SDF, however, this implementation only generates single-channel SDF.
*
* Chlumsky, Viktor: Shape Decomposition for Multi-channel Distance
* Fields. Master's thesis. Czech Technical University in Prague,