Reference

hb-info(1)

Query font information.

NAME

hb-info - Query font information.

DESCRIPTION

Usage:

hb-info [OPTION???] [FONT-FILE]

Query font information.

Help Options:

-h, --help

Show help options

--help-all

Show all help options

--help-face

Options for the font face

--help-font

Options for the font instance

--help-variations

Options for font variations used

--help-misc

Miscellaneous options affecting queries

--help-query

Options to query the font instance

Font-face options:

--font-file=filename

Set font file-name

-y, --face-index=index

Set face index (default: 0)

--face-loader=loader

Set face loader to use (default: ot)

Supported face loaders are: ot/ft

--list-face-loaders

List available face loaders and quit

Font-instance options:

--font-size=1/2 integers or 'upem'

Font size (default: upem)

--font-ppem=1/2 integers

Set x,y pixels per EM (default: 0; disabled)

--font-ptem=point-size

Set font point-size (default: 0; disabled)

--font-bold=1/2 numbers; eg. 0.05

Set synthetic bold (default: 0)

--font-grade=1/2 numbers; eg. 0.05

Set synthetic grade (default: 0)

--font-slant=slant ratio; eg. 0.2

Set synthetic slant (default: 0)

--font-funcs=impl

Set font functions implementation to use (default: ot)

Supported font function implementations are: ot/ft

--list-font-funcs

List available font functions and quit

--ft-load-flags=integer

Set FreeType load-flags (default: 2)

Variations options:

--named-instance=index

Set named-instance index (default: none)

--variations=list

Comma-separated list of font variations

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.

The format is a tag, optionally followed by an equals sign, followed by a number. For example:

"wght=500" "slnt=-7.5"

Miscellaneous options:

--direction=ltr/rtl/ttb/btt

Set direction (default: ltr)

--script=ISO-15924 tag; eg. 'Latn'

Set script (default: none)

--language=BCP 47 tag; eg. 'en'

Set language (default: $LANG)

--ot-script=tag; eg. 'latn'

Set OpenType script tag (default: none)

--ot-language=tag; eg. 'ENG'

Set OpenType language tag (default: none)

Query options:

-a, --all

Show everything

--show-all

Show all short information (default)

--show-face-count

Show face count

--show-family

Show family name

--show-subfamily

Show subfamily name

--show-unique-name

Show unique name

--show-full-name

Show full name

--show-postscript-name

Show Postscript name

--show-version

Show version

--show-technology

Show technology

--show-unicode-count

Show Unicode count

--show-glyph-count

Show glyph count

--show-upem

Show Units-Per-EM

--show-extents

Show extents

--get-name=name id; eg. '13'

Get name

--get-style=style tag; eg. 'wght'

Get style

--get-metric=metric tag; eg. 'hasc'

Get metric

--get-baseline=baseline tag; eg. 'hang'

Get baseline

--get-meta=tag tag; eg. 'dlng'

Get meta information

--get-table=table tag; eg. 'cmap'

Get font table

--list-all

List all long information

--list-names

List names

--list-style

List style

--list-metrics

List metrics

--list-baselines

List baselines

-l, --list-tables

List tables

--list-unicodes

List characters

--list-glyphs

List glyphs

--list-scripts

List layout scripts

--list-features

List layout features

--list-variations

List variations

--list-palettes

List color palettes

--list-meta

List meta information

Application Options:

-q, --quiet

Generate machine-readable output

--version

Show version numbers

Queries font file for various information. If no query option is specified, --show-all is assumed.

EXIT CODES

0: Success.

1: Option parsing failed.

2: Failed loading font face.

4: Failed setting font functions.

ENVIRONMENT

HB_FACE_LOADER=face-loader; Overrides the default face loader.

HB_FONT_FUNCS=font-funcs; Overrides the default font-funcs.

SEE ALSO

hb-view(1), hb-shape(1), hb-raster(1), hb-vector(1), hb-subset(1), hb-info(1)

Find more information or report bugs at <https://github.com/harfbuzz/harfbuzz>