new stream api

1 files changed, 22 insertions, 0 deletions

diff --git a/include/fitz/text.h b/include/fitz/text.h
index 8bb6ee5a..619aae83 100644
--- a/include/fitz/text.h
+++ b/include/fitz/text.h
@@ -1,3 +1,25 @@
+/*
+ * Fitz display tree text node.
+ *
+ * The text node is an optimization to reference glyphs in a font resource
+ * and specifying an individual transform matrix for each one.
+ *
+ * The trm field contains the a, b, c and d coefficients.
+ * The e and f coefficients come from the individual elements,
+ * together they form the transform matrix for the glyph.
+ *
+ * Glyphs are referenced by glyph ID.
+ * The Unicode text equivalent is kept in a separate array
+ * with indexes into the glyph array.
+ *
+
+TODO the unicode textels
+
+struct fz_textgid_s { float e, f; int gid; };
+struct fz_textucs_s { int idx; int ucs; };
+
+ */
+
 typedef struct fz_textel_s fz_textel;
 
 struct fz_textel_s