aboutsummaryrefslogtreecommitdiffstats
path: root/librifunktionsteckensnittsglyfrasteriseringsprogrambiblioteket.7
diff options
context:
space:
mode:
authorMattias Andrée <maandree@kth.se>2023-02-07 22:38:36 +0100
committerMattias Andrée <maandree@kth.se>2023-02-07 22:38:36 +0100
commit6bea61a199dd841b23053cf1b8ccd3dd753c0846 (patch)
tree62e526e51eac4b210305177dcc5222e800d42d35 /librifunktionsteckensnittsglyfrasteriseringsprogrambiblioteket.7
parentREADME: add usage information (diff)
downloadlibrifunktionsteckensnittsglyfrasteriseringsprogrambiblioteket-6bea61a199dd841b23053cf1b8ccd3dd753c0846.tar.gz
librifunktionsteckensnittsglyfrasteriseringsprogrambiblioteket-6bea61a199dd841b23053cf1b8ccd3dd753c0846.tar.bz2
librifunktionsteckensnittsglyfrasteriseringsprogrambiblioteket-6bea61a199dd841b23053cf1b8ccd3dd753c0846.tar.xz
Add man pages
Signed-off-by: Mattias Andrée <maandree@kth.se>
Diffstat (limited to 'librifunktionsteckensnittsglyfrasteriseringsprogrambiblioteket.7')
-rw-r--r--librifunktionsteckensnittsglyfrasteriseringsprogrambiblioteket.748
1 files changed, 48 insertions, 0 deletions
diff --git a/librifunktionsteckensnittsglyfrasteriseringsprogrambiblioteket.7 b/librifunktionsteckensnittsglyfrasteriseringsprogrambiblioteket.7
new file mode 100644
index 0000000..a0fe3d0
--- /dev/null
+++ b/librifunktionsteckensnittsglyfrasteriseringsprogrambiblioteket.7
@@ -0,0 +1,48 @@
+.TH LIBRIFUNKTIONSTECKENSNITTSGLYFRASTERISERINGSPROGRAMBIBLIOTEKET 7 LIBRIFUNKTIONSTECKENSNITTSGLYFRASTERISERINGSPROGRAMBIBLIOTEKET
+.SH NAME
+librifunktionsteckensnittsglyfrasteriseringsprogrambiblioteket - Font rasterisation library
+
+.SH DESCRIPTION
+.B librifunktionsteckensnittsglyfrasteriseringsprogrambiblioteket
+is a C library for converting shape outlines to filled shapes,
+with a focus on fonts, which that it only supports filled,
+closed shapes and that the direction of the outline determines
+whether a shape adds or subtracts to the image (the absolute
+values of the result is used in the image). Furthermore this
+means that the library only supports curve types that are used
+for drawing glyphs; specifically this means that lines and
+quadratic Bézier curves are supported by cause this is what is
+required to draw vectorised bitmap fonts and TrueType fonts,
+but also cubic Bézier curves as this is required for OpenType
+fonts and elliptical arcs (elliptical rather than circular
+because it may be need required to strech the circle to support
+outputs with different vertical and horizontal dot density and
+to support subpixel antialiasing) as this is commonly used for
+corners when stroking the outline of a glyph.
+.PP
+The create an image, first create a buffer using
+.BR rtgrpblib_create_raster (3)
+(if you already have one that is large enough, you can
+reinitialise it with
+.BR rtgrpblib_reset_raster (3)),
+and than using the drawing functions
+.RB ( rtgrpblib_draw_linear_bezier (3),
+.BR rtgrpblib_draw_quadratic_bezier (3),
+.BR rtgrpblib_draw_cubic_bezier (3),
+and
+.BR rtgrpblib_draw_elliptical_arc (3))
+to draw the components of each shape's outline. When done,
+create an image using the
+.BR rtgrpblib_fill_shapes (3)
+function: you will receive a ink-level map, where the value
+0 means background, and 1 means foreground, and values between
+are colours between (no transfer function is applied).
+
+.SH NOTES
+Rifunktionsteckensnittsglyfrasteriseringsprogrambiblioteket (hyphenation:
+ri|funk¦tions-tec¦ken|snit¦ts-glyf-ras¦ter¦iser¦ings-prog¦ram|bib¦lio¦te¦ket)
+is Swedish for \(dqthe library for rasterising glyphs from spline fonts\(dq.
+.PP
+Because of the length of the library name, and length limitation
+on function names, the functions in this library are namespaced
+with the prefix \(dqrtgrpblib_\(dq.