のねのBlog

パソコンの問題や、ソフトウェアの開発で起きた問題など書いていきます。よろしくお願いします^^。

hb-view --help-all

> hb-view --help-all
Usage:
hb-view.exe [OPTION…] [FONT-FILE] [TEXT]

View text with given font.

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-text Options for the input text
--help-text-context Options for the input context text
--help-shape Options for the shaping process
--help-features Options for font features used
--help-view Options for output rendering
--help-output Options for the destination & form of the output

Font-face options:
--font-file=filename Set font file-name
--face-index=index Set face index (default: 0)

Font-instance options:
--font-size=1/2 integers or 'upem' Font size (default: 256)
--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-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
--ft-load-flags=integer Set FreeType load-flags (default: 2)

Variations options:
--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"

Text options:

If no text is provided, standard input is used for input.

--text=string Set input text
--text-file=filename Set input text file-name
-u, --unicodes=list of hex numbers Set input Unicode codepoints
--single-par Treat text as single paragraph

Textual context options:
--text-before=string Set text context before each line
--text-after=string Set text context after each line
--unicodes-before=list of hex numbers Set Unicode codepoints context before each line
--unicodes-after=list of hex numbers Set Unicode codepoints context after each line

Shape options:
--list-shapers List available shapers and quit
--shapers=list Set comma-separated list of shapers to try
--direction=ltr/rtl/ttb/btt Set text direction (default: auto)
--language=BCP 47 tag Set text language (default: $LANG)
--script=ISO-15924 tag Set text script (default: auto)
--bot Treat text as beginning-of-paragraph
--eot Treat text as end-of-paragraph
--preserve-default-ignorables Preserve Default-Ignorable characters
--remove-default-ignorables Remove Default-Ignorable characters
--invisible-glyph Glyph value to replace Default-Ignorables with
--not-found-glyph Glyph value to replace not-found characters with
--utf8-clusters Use UTF8 byte indices, not char indices
--cluster-level=0/1/2 Cluster merging level (default: 0)
--normalize-glyphs Rearrange glyph clusters in nominal order
--unsafe-to-concat Produce unsafe-to-concat glyph flag
--safe-to-insert-tatweel Produce safe-to-insert-tatweel glyph flag
--verify Perform sanity checks on shaping results

Features options:
--features=list Comma-separated list of font features

Features can be enabled or disabled, either globally or limited to
specific character ranges. The format for specifying feature settings
follows. All valid CSS font-feature-settings values other than 'normal'
and the global values are also accepted, though not documented below.
CSS string escapes are not supported.
The range indices refer to the positions between Unicode characters,
unless the --utf8-clusters is provided, in which case range indices
refer to UTF-8 byte indices. The position before the first character
is always 0.

The format is Python-esque. Here is how it all works:

Syntax: Value: Start: End:

Setting value:
"kern" 1 0 ∞ # Turn feature on
"+kern" 1 0 ∞ # Turn feature on
"-kern" 0 0 ∞ # Turn feature off
"kern=0" 0 0 ∞ # Turn feature off
"kern=1" 1 0 ∞ # Turn feature on
"aalt=2" 2 0 ∞ # Choose 2nd alternate

Setting index:
"kern[]" 1 0 ∞ # Turn feature on
"kern[:]" 1 0 ∞ # Turn feature on
"kern[5:]" 1 5 ∞ # Turn feature on, partial
"kern[:5]" 1 0 5 # Turn feature on, partial
"kern[3:5]" 1 3 5 # Turn feature on, range
"kern[3]" 1 3 3+1 # Turn feature on, single char

Mixing it all:

"aalt[3:5]=2" 2 3 5 # Turn 2nd alternate on for range

View options:
--annotate Annotate output rendering
--background=rrggbb/rrggbbaa Set background color (default: #FFFFFF)
--foreground=rrggbb/rrggbbaa Set foreground color (default: #000000)
--line-space=units Set space between lines (default: 0)
--font-extents=one to three numbers Set font ascent/descent/line-gap (default: auto)
--margin=one to four numbers Margin around output (default: 16)

Output destination & format options:
-o, --output-file=filename Set output file-name (default: stdout)
-O, --output-format=format Set output format

Supported output formats are: ansi/png/svg/pdf/ps/eps

Application Options:
--version Show version numbers
-n, --num-iterations=N Run shaper N times (default: 1)

PS C:\Users\mfujii\oem\work>