README
¶
Text layout library for Golang 
This module provides a chain of tools to layout text. It is mainly a port of the C libraries harfbuzz and graphite.
Project superseded
This project has been merged into go-text/typesetting and this repository will not be maintained anymore : developpement will happen in the go-text repo. All users should use go-text instead, unless if they require support for old Type1 or Linux Bitmap fonts.
Project structure update
As of v0.1.0, the content of this repository has been split, with higher level, more experimental packages moved to textprocessing. The remaining packages are the more stable, low level logic used by go-text.
As of v0.1.1, the font files only used for internal tests have been moved in a separate module, so that regular builds do not have to download these large files (this requires go1.17 for module lazy loading).
Overview
The package fonts provides the low level primitives to load and read font files. Once a font is selected, harfbuzz is responsible for laying out a line of text, that is transforming a sequence of unicode points (runes) to a sequence of positionned glyphs. Graphite fonts are supported via the graphite package. Some higher level library may wrap these tools to provide an interface capable of laying out an entire text.
Status of the project
This project is a work in progress. Some parts of it are already usable : fonts/truetype, harfbuzz and graphite, but breaking changes may be committed on the fly.
Licensing
This module is provided under the MIT license.
Directories
¶
| Path | Synopsis |
|---|---|
|
Package fonts provides supports for parsing several font formats (postscript, bitmap and truetype) and provides a common API, inspired by freetype.
|
Package fonts provides supports for parsing several font formats (postscript, bitmap and truetype) and provides a common API, inspired by freetype. |
|
binaryreader
Package binaryreader provides a convenient reader to decode (big endian) binary content.
|
Package binaryreader provides a convenient reader to decode (big endian) binary content. |
|
bitmap
Pacakge bitmap provides support for bitmap fonts found in .pcf files.
|
Pacakge bitmap provides support for bitmap fonts found in .pcf files. |
|
glyphsnames
copied from https://git.maze.io/go/unipdf/src/branch/master/internal/textencoding
|
copied from https://git.maze.io/go/unipdf/src/branch/master/internal/textencoding |
|
psinterpreter
Package psinterpreter implement a Postscript interpreter required to parse .CFF files, and Type1 and Type2 Charstrings.
|
Package psinterpreter implement a Postscript interpreter required to parse .CFF files, and Type1 and Type2 Charstrings. |
|
simpleencodings
Simple encodings map a subset of the unicode characters (at most 256) to a set of single bytes.
|
Simple encodings map a subset of the unicode characters (at most 256) to a set of single bytes. |
|
truetype
Package truetype provides support for OpenType and TrueType font formats, used in PDF.
|
Package truetype provides support for OpenType and TrueType font formats, used in PDF. |
|
type1
Package type1 implements a parser for Adobe Type1 fonts, defined by .afm files (https://www.adobe.com/content/dam/acom/en/devnet/font/pdfs/5004.AFM_Spec.pdf) and .pdf files (https://www.adobe.com/content/dam/acom/en/devnet/font/pdfs/T1_SPEC.pdf)
|
Package type1 implements a parser for Adobe Type1 fonts, defined by .afm files (https://www.adobe.com/content/dam/acom/en/devnet/font/pdfs/5004.AFM_Spec.pdf) and .pdf files (https://www.adobe.com/content/dam/acom/en/devnet/font/pdfs/T1_SPEC.pdf) |
|
type1C
Package type1c provides a parser for the CFF font format defined at https://www.adobe.com/content/dam/acom/en/devnet/font/pdfs/5176.CFF.pdf.
|
Package type1c provides a parser for the CFF font format defined at https://www.adobe.com/content/dam/acom/en/devnet/font/pdfs/5176.CFF.pdf. |
|
Package graphite Graphite implements a "smart font" system developed specifically to handle the complexities of lesser-known languages of the world.
|
Package graphite Graphite implements a "smart font" system developed specifically to handle the complexities of lesser-known languages of the world. |
|
Package harfbuzz provides advanced text layout for various scripts and languages, with font-aware substitutions and positionning.
|
Package harfbuzz provides advanced text layout for various scripts and languages, with font-aware substitutions and positionning. |
|
langs
command
Generator of the mapping from OpenType tags to BCP 47 tags && vice versa.
|
Generator of the mapping from OpenType tags to BCP 47 tags && vice versa. |
|
Package unicodedata provides additional lookup functions for unicode properties, not covered by the standard package unicode.
|
Package unicodedata provides additional lookup functions for unicode properties, not covered by the standard package unicode. |
|
generate
command
Generate lookup function for Unicode properties not covered by the standard package unicode.
|
Generate lookup function for Unicode properties not covered by the standard package unicode. |