.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH HB-SUBSET "1" "April 2025" "HarfBuzz 11.0.1" "User Commands"
.SH NAME
hb-subset \- manual page for hb-subset 11.0.1
.SH DESCRIPTION
.SS "Usage:"
.IP
hb\-subset [OPTION?] [FONT\-FILE] [TEXT]
.PP
Subset font to specification.
.SS "Help Options:"
.TP
\fB\-h\fR, \fB\-\-help\fR
Show help options
.TP
\fB\-\-help\-all\fR
Show all help options
.TP
\fB\-\-help\-face\fR
Options for the font face
.TP
\fB\-\-help\-subset\-glyphset\fR
Subsetting glyph\-set options
.TP
\fB\-\-help\-subset\-other\fR
Subsetting other options
.TP
\fB\-\-help\-subset\-flags\fR
Subsetting boolean options
.TP
\fB\-\-help\-output\fR
Options for the destination & form of the output
.SS "Font-face options:"
.TP
\fB\-\-font\-file\fR=\fI\,filename\/\fR
Set font file\-name
.TP
\fB\-y\fR, \fB\-\-face\-index\fR=\fI\,index\/\fR
Set face index (default: 0)
.TP
\fB\-\-face\-loader\fR=\fI\,loader\/\fR
Set face loader to use (default: ot)
.IP
Supported face loaders are: ot/ft
.TP
\fB\-\-list\-face\-loaders\fR
List available face loaders and quit
.SS "Subset glyph-set option:"
.TP
\fB\-g\fR, \fB\-\-gids\fR=\fI\,list\/\fR of glyph indices/ranges or *
Specify glyph IDs or ranges to include in the subset.
Use \fB\-\-gids\-=\fR... to subtract codepoints from the current set.
.TP
\fB\-\-gids\-file\fR=\fI\,filename\/\fR
Specify file to read glyph IDs or ranges from
.TP
\fB\-\-glyphs\fR=\fI\,list\/\fR of glyph names or *
Specify glyph names to include in the subset. Use \fB\-\-glyphs\-=\fR... to subtract glyphs from the current set.
.TP
\fB\-\-glyphs\-file\fR=\fI\,filename\/\fR
Specify file to read glyph names from
.TP
\fB\-t\fR, \fB\-\-text\fR=\fI\,string\/\fR
Specify text to include in the subset. Use \fB\-\-text\-=\fR... to subtract codepoints from the current set.
.TP
\fB\-\-text\-file\fR=\fI\,filename\/\fR
Specify file to read text from
.TP
\fB\-u\fR, \fB\-\-unicodes\fR=\fI\,list\/\fR of hex numbers/ranges or *
Specify Unicode codepoints or ranges to include in the subset. Use * to include all codepoints.
\fB\-\-unicodes\-=\fR... can be used to subtract codepoints from the current set.
For example: \fB\-\-unicodes=\fR* \fB\-\-unicodes\-\fR=\fI\,41\/\fR,42,43 would create a subset with all codepoints
except for 41, 42, 43.
.TP
\fB\-\-unicodes\-file\fR=\fI\,filename\/\fR
Specify file to read Unicode codepoints or ranges from
.SS "Subset other option:"
.TP
\fB\-\-gid\-map\fR=\fI\,List\/\fR of pairs old_gid1:new_gid1,old_gid2:new_gid2,...
Specify a glyph mapping to use, any unmapped gids will be automatically assigned.
.TP
\fB\-\-name\-IDs\fR=\fI\,list\/\fR of int numbers or *
Subset specified nameids. Use \fB\-\-name\-IDs\-=\fR... to subtract from the current set.
.TP
\fB\-\-name\-languages\fR=\fI\,list\/\fR of int numbers or *
Subset nameRecords with specified language IDs. Use \fB\-\-name\-languages\-=\fR... to subtract from the current set.
.TP
\fB\-\-layout\-features\fR=\fI\,list\/\fR of string table tags or *
Specify set of layout feature tags that will be preserved. Use \fB\-\-layout\-features\-=\fR... to subtract from the current set.
.TP
\fB\-\-layout\-scripts\fR=\fI\,list\/\fR of string table tags or *
Specify set of layout script tags that will be preserved. Use \fB\-\-layout\-scripts\-=\fR... to subtract from the current set.
.TP
\fB\-\-drop\-tables\fR=\fI\,list\/\fR of string table tags or *
Drop the specified tables. Use \fB\-\-drop\-tables\-=\fR... to subtract from the current set.
.TP
\fB\-\-variations\fR=\fI\,list\/\fR of comma separated axis\-locations.
(Partially|Fully) Instantiate a variable font. A location consists of the tag of a variation axis, followed by '=', followed by a number or the literal string 'drop'. For example: \fB\-\-variations=\fR"wdth=100 wght=200" or \fB\-\-variations=\fR"wdth=drop"
.SS "Subset boolean option:"
.TP
\fB\-\-keep\-everything\fR
Keep everything by default. Options after this can override the operation.
.TP
\fB\-\-no\-hinting\fR
Whether to drop hints
.TP
\fB\-\-retain\-gids\fR
If set don't renumber glyph ids in the subset.
.TP
\fB\-\-desubroutinize\fR
Remove CFF/CFF2 use of subroutines
.TP
\fB\-\-name\-legacy\fR
Keep legacy (non\-Unicode) 'name' table entries
.TP
\fB\-\-set\-overlaps\-flag\fR
Set the overlaps flag on each glyph.
.TP
\fB\-\-notdef\-outline\fR
Keep the outline of '.notdef' glyph
.TP
\fB\-\-no\-prune\-unicode\-ranges\fR
Don't change the 'OS/2 ulUnicodeRange*' bits.
.TP
\fB\-\-no\-layout\-closure\fR
Don't perform glyph closure for layout substitution (GSUB).
.TP
\fB\-\-glyph\-names\fR
Keep PS glyph names in TT\-flavored fonts.
.TP
\fB\-\-passthrough\-tables\fR
Do not drop tables that the tool does not know how to subset.
.TP
\fB\-\-preprocess\fR
If set preprocesses the face with the add accelerator option before actually subsetting.
.TP
\fB\-\-optimize\fR
Perform IUP delta optimization on the resulting gvar table's deltas
.SS "Output destination & format options:"
.TP
\fB\-o\fR, \fB\-\-output\-file\fR=\fI\,filename\/\fR
Set output file\-name (default: stdout)
.SS "Application Options:"
.TP
\fB\-\-version\fR
Show version numbers
.TP
\fB\-n\fR, \fB\-\-num\-iterations\fR=\fI\,N\/\fR
Run subsetter N times (default: 1)
.PP
Subsets font file to a specified set of glyphs, Unicode codepoints, or text, design\-space limiting, and other reductions.
.SH "EXIT CODES"
.IP
0: Success.
.IP
1: Option parsing failed.
.IP
2: Failed loading font face.
.SH ENVIRONMENT
.IP
HB_FACE_LOADER=face\-loader; Overrides the default face loader.
.SH "SEE ALSO"
.IP
hb\-view(1), hb\-shape(1), hb\-subset(1), hb\-info(1)
.PP
Find more information or report bugs at <https://github.com/harfbuzz/harfbuzz>