1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74
|
.TH PYFTFEATFREEZE "1" "June 2025" "pyftfeatfreeze" "User Commands"
.SH NAME
pyftfeatfreeze \- Freezes OpenType features into a font
.SH DESCRIPTION
usage: pyftfeatfreeze [\-h] [\-f FEATURES] [\-s SCRIPT] [\-l LANG] [\-z] [\-S]
.TP
[\-U USESUFFIX] [\-R REPLACENAMES] [\-i] [\-r] [\-n] [\-v]
[\-V]
inpath [outpath]
.PP
With pyftfeatfreeze you can "freeze" some OpenType features into a font. These
features are then "on by default", even in apps that don't support OpenType
features. Internally, the tool remaps the "cmap" table of the font by applying
the specified GSUB features. Only single and alternate substitutions are
supported.
.SS "positional arguments:"
.TP
inpath
input .otf or .ttf font file
.TP
outpath
output .otf or .ttf font file (optional)
.SS "options:"
.TP
\fB\-h\fR, \fB\-\-help\fR
show this help message and exit
.SS "options to control feature freezing:"
.TP
\fB\-f\fR, \fB\-\-features\fR FEATURES
comma\-separated list of OpenType feature tags, e.g.
\&'smcp,c2sc,onum'
.TP
\fB\-s\fR, \fB\-\-script\fR SCRIPT
OpenType script tag, e.g. 'cyrl' (optional)
.TP
\fB\-l\fR, \fB\-\-lang\fR LANG
OpenType language tag, e.g. 'SRB ' (optional)
.TP
\fB\-z\fR, \fB\-\-zapnames\fR
zap glyphnames from the font ('post' table version 3,
\&.ttf only)
.SS "options to control font renaming:"
.TP
\fB\-S\fR, \fB\-\-suffix\fR
add a suffix to the font family name (by default, the
suffix will be constructed from the OpenType feature
tags)
.TP
\fB\-U\fR, \fB\-\-usesuffix\fR USESUFFIX
use a custom suffix when \fB\-\-suffix\fR is enabled
.TP
\fB\-R\fR, \fB\-\-replacenames\fR REPLACENAMES
search for strings in the font naming tables and
replace them, format is
\&'search1/replace1,search2/replace2,...'
.TP
\fB\-i\fR, \fB\-\-info\fR
update font version string
.SS "reporting options:"
.TP
\fB\-r\fR, \fB\-\-report\fR
report languages, scripts and features in font
.TP
\fB\-n\fR, \fB\-\-names\fR
output names of remapped glyphs during processing
.TP
\fB\-v\fR, \fB\-\-verbose\fR
print additional information during processing
.TP
\fB\-V\fR, \fB\-\-version\fR
show program's version number and exit
.PP
Examples: pyftfeatfreeze \fB\-f\fR 'c2sc,smcp' \fB\-S\fR \fB\-U\fR SC OpenSans.ttf OpenSansSC.ttf
pyftfeatfreeze \fB\-R\fR 'Lato/Otal' Lato\-Regular.ttf Otal\-Regular.ttf
|