.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH HB-INFO "1" "April 2025" "HarfBuzz 11.0.1" "User Commands"
.SH NAME
hb-info \- manual page for hb-info 11.0.1
.SH DESCRIPTION
.SS "Usage:"
.IP
hb\-info [OPTION?] [FONT\-FILE]
.PP
Query font information.
.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\-font\fR
Options for the font instance
.TP
\fB\-\-help\-variations\fR
Options for font variations used
.TP
\fB\-\-help\-misc\fR
Miscellaneous options affecting queries
.TP
\fB\-\-help\-query\fR
Options to query the font instance
.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 "Font-instance options:"
.TP
\fB\-\-font\-size\fR=\fI\,1\/\fR/2 integers or 'upem'
Font size (default: upem)
.TP
\fB\-\-font\-ppem\fR=\fI\,1\/\fR/2 integers
Set x,y pixels per EM (default: 0; disabled)
.TP
\fB\-\-font\-ptem\fR=\fI\,point\-size\/\fR
Set font point\-size (default: 0; disabled)
.TP
\fB\-\-font\-bold\fR=\fI\,1\/\fR/2 numbers; eg. 0.05
Set synthetic bold (default: 0)
.TP
\fB\-\-font\-grade\fR=\fI\,1\/\fR/2 numbers; eg. 0.05
Set synthetic grade (default: 0)
.TP
\fB\-\-font\-slant\fR=\fI\,slant\/\fR ratio; eg. 0.2
Set synthetic slant (default: 0)
.TP
\fB\-\-font\-funcs\fR=\fI\,impl\/\fR
Set font functions implementation to use (default: ot)
.IP
Supported font function implementations are: ot/ft
.TP
\fB\-\-list\-font\-funcs\fR
List available font functions and quit
.TP
\fB\-\-ft\-load\-flags\fR=\fI\,integer\/\fR
Set FreeType load\-flags (default: 2)
.SS "Variations options:"
.TP
\fB\-\-named\-instance\fR=\fI\,index\/\fR
Set named\-instance index (default: none)
.TP
\fB\-\-variations\fR=\fI\,list\/\fR
Comma\-separated list of font variations
.IP
Variations are set globally. The format for specifying variation settings
follows.  All valid CSS font\-variation\-settings values other than 'normal'
and 'inherited' are also accepted, though, not documented below.
.IP
The format is a tag, optionally followed by an equals sign, followed by a
number. For example:
.IP
"wght=500"
"slnt=\-7.5"
.SS "Miscellaneous options:"
.TP
\fB\-\-direction\fR=\fI\,ltr\/\fR/rtl/ttb/btt
Set direction (default: ltr)
.TP
\fB\-\-script\fR=\fI\,ISO\-15924\/\fR tag; eg. 'Latn'
Set script (default: none)
.TP
\fB\-\-language\fR=\fI\,BCP\/\fR 47 tag; eg. 'en'
Set language (default: $LANG)
.TP
\fB\-\-ot\-script\fR=\fI\,tag\/\fR; eg. 'latn'
Set OpenType script tag (default: none)
.TP
\fB\-\-ot\-language\fR=\fI\,tag\/\fR; eg. 'ENG'
Set OpenType language tag (default: none)
.SS "Query options:"
.TP
\fB\-a\fR, \fB\-\-all\fR
Show everything
.TP
\fB\-\-show\-all\fR
Show all short information (default)
.TP
\fB\-\-show\-face\-count\fR
Show face count
.TP
\fB\-\-show\-family\fR
Show family name
.TP
\fB\-\-show\-subfamily\fR
Show subfamily name
.TP
\fB\-\-show\-unique\-name\fR
Show unique name
.TP
\fB\-\-show\-full\-name\fR
Show full name
.TP
\fB\-\-show\-postscript\-name\fR
Show Postscript name
.TP
\fB\-\-show\-version\fR
Show version
.TP
\fB\-\-show\-technology\fR
Show technology
.TP
\fB\-\-show\-unicode\-count\fR
Show Unicode count
.TP
\fB\-\-show\-glyph\-count\fR
Show glyph count
.TP
\fB\-\-show\-upem\fR
Show Units\-Per\-EM
.TP
\fB\-\-show\-extents\fR
Show extents
.TP
\fB\-\-get\-name\fR=\fI\,name\/\fR id; eg. '13'
Get name
.TP
\fB\-\-get\-style\fR=\fI\,style\/\fR tag; eg. 'wght'
Get style
.TP
\fB\-\-get\-metric\fR=\fI\,metric\/\fR tag; eg. 'hasc'
Get metric
.TP
\fB\-\-get\-baseline\fR=\fI\,baseline\/\fR tag; eg. 'hang'
Get baseline
.TP
\fB\-\-get\-meta\fR=\fI\,tag\/\fR tag; eg. 'dlng'
Get meta information
.TP
\fB\-\-get\-table\fR=\fI\,table\/\fR tag; eg. 'cmap'
Get font table
.TP
\fB\-\-list\-all\fR
List all long information
.TP
\fB\-\-list\-names\fR
List names
.TP
\fB\-\-list\-style\fR
List style
.TP
\fB\-\-list\-metrics\fR
List metrics
.TP
\fB\-\-list\-baselines\fR
List baselines
.TP
\fB\-l\fR, \fB\-\-list\-tables\fR
List tables
.TP
\fB\-\-list\-unicodes\fR
List characters
.TP
\fB\-\-list\-glyphs\fR
List glyphs
.TP
\fB\-\-list\-scripts\fR
List layout scripts
.TP
\fB\-\-list\-features\fR
List layout features
.TP
\fB\-\-list\-variations\fR
List variations
.TP
\fB\-\-list\-palettes\fR
List color palettes
.TP
\fB\-\-list\-meta\fR
List meta information
.SS "Application Options:"
.TP
\fB\-q\fR, \fB\-\-quiet\fR
Generate machine\-readable output
.TP
\fB\-\-version\fR
Show version numbers
.PP
Queries font file for various information. If no query option is specified, \fB\-\-show\-all\fR is assumed.
.SH "EXIT CODES"
.IP
0: Success.
.IP
1: Option parsing failed.
.IP
2: Failed loading font face.
.IP
4: Failed setting font functions.
.SH ENVIRONMENT
.IP
HB_FACE_LOADER=face\-loader; Overrides the default face loader.
.IP
HB_FONT_FUNCS=font\-funcs; Overrides the default font\-funcs.
.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>