TABLE OF CONTENTS
font.cygclass
[ Top ] [ Cygclasses ] [ Cygclasses ]
DESCRIPTION
This cygclass provides functions for installing fonts so that they will be found by the X server (for Xaw/Motif applications) and fontconfig (used by most modern GUI toolkits).
EXAMPLE
ORIG_PN="cantarell-fonts" inherit gnome.org font NAME="font-cantarell-otf" VERSION=0.0.12 RELEASE=1 CATEGORY="X11" SUMMARY="Cantarell TTF sans serif fonts" DESCRIPTION="The Cantarell typeface family was designed as a contemporary Humanist sans serif, and was developed for on-screen reading; in particular, reading web pages on a mobile phone." HOMEPAGE="http://abattis.org/cantarell/" src_compile() { :; } src_install() { cd ${S} fontinto OTF dofont otf/*.otf dofontconf fontconfig/*.conf }
NOTE
Regardless of the usage of font.cygclass, cygport will compress all bitmap fonts (.pcf) and create postinstall scripts for all fonts installed in FONTSDIR in order to register them with the X server and fontconfig.
FONTSDIR
[ Top ] [ font.cygclass ] [ Definitions ]
DESCRIPTION
The top font directory, AKA the fontrootdir.
sfd2ttf
[ Top ] [ font.cygclass ] [ Compile Functions ]
SYNOPSIS
sfd2ttf SFD_FILE[S] ...
DESCRIPTION
Creates TrueType Font (TTF) files from FontForge Spline Font Database (SFD) sources.
fontinto
[ Top ] [ font.cygclass ] [ Install Functions ]
SYNOPSIS
fontinto SUBDIR
DESCRIPTION
Tells dofont which font directory to install into. Accepts a single argument, the name of the font subdirectory.
NOTE
Technically any subdir can be used for fonts, and fontconfig will find the font no matter which subdir you use. OTOH, the X server by default searches only in a specific list of subdirectories, namely:
- misc: miscellaneous bitmap fonts (.pcf.gz)
- 75dpi: lower-resolution standard bitmap fonts (.pcf.gz)
- 100dpi: higher-resolution standard bitmap fonts (.pcf.gz)
- OTF: OpenType fonts (.otf)
- TTF: TrueType fonts (.ttf)
- Type1: Postscript fonts (.afm, .pfa/.pfb)
Fonts installed into any other subdirectory will not be found by the X server without the user adjusting their fontpath accordingly.
dofont
[ Top ] [ font.cygclass ] [ Install Functions ]
SYNOPSIS
dofont FONTFILE [FONTFILE] ...
DESCRIPTION
Installs the given font file(s) into the font subdirectory specified by the most recent call to fontinto.
dofontconf
[ Top ] [ font.cygclass ] [ Install Functions ]
SYNOPSIS
dofontconf CONFFILE [CONFFILE] ...
DESCRIPTION
Installs the given font configuration file(s) into the system fontconfig configuration directories. If file is not named [0-9][0-9]*.conf, then use newfontconf instead to rename it.
newfontconf
[ Top ] [ font.cygclass ] [ Install Functions ]
SYNOPSIS
newfontconf CONFFILE DESIRED_NAME
DESCRIPTION
Installs the given font configuration file into the system fontconfig configuration directories as the given DESIRED_NAME, which must be of the form [0-9][0-9]*.conf:
- 00 through 09: Font directories
- 10 through 19: system rendering defaults (AA, etc)
- 20 through 29: font rendering options
- 30 through 39: family substitution
- 40 through 49: generic identification, map family->generic
- 50 through 59: alternate config file loading
- 60 through 69: generic aliases, map generic->family
- 70 through 79: select font (adjust which fonts are available)
- 80 through 89: match target="scan" (modify scanned patterns)
- 90 through 99: font synthesis