HB-RASTER(1) User Commands HB-RASTER(1) (NAME) hb-raster - HarfBuzz (SYNOPSIS) hb-raster [] [-] [] (DESCRIPTION) . (OPTIONS) : -h, --help --help-all --help-face (font face) --help-font (font instance) --help-variations (variations) --help-text --help-text-context --help-shape (shaping) --help-features (OpenType features) --help-output --help-view (Font-face options): --font-file=filename -y, --face-index=index (: 0) --face-loader=loader (: ot) : ot/ft --list-face-loaders (Font-instance options): --font-size=1/2 'upem' (: 256) --font-ppem=1/2 EM x y (: 0 ) --font-ptem=point-size (: 0 ) --font-bold=1/2 0.05 (synthetic bold) (: 0) --font-grade=1/2 0.05 (synthetic grade) (: 0) --font-slant=slant 0.2 (synthetic slant) (: 0) --font-funcs=impl (: ot) : ot/ft --list-font-funcs --ft-load-flags=integer FreeType (: 2) (Variations options): --named-instance=index (: none) --variations=list . . font-variation-settings CSS 'normal' 'inherited' . . : "wght=500" "slnt=-7.5" (Text options): (stdin) . --text=string --text-file=filename -u, --unicodes=list --single-par (Textual context options): --text-before=string --text-after=string --unicodes-before=list --unicodes-after=list (Shape options): --shapers=comma-separated list (: graphite2,ot,fallback) : graphite2/ot/fallback --list-shapers --direction=ltr/rtl/ttb/btt (: auto) --language=BCP 47 tag (: $LANG) --script=ISO-15924 tag / (: auto) --bot (beginning-of-paragraph) --eot (end-of-paragraph) --preserve-default-ignorables (Default-Ignorable) --remove-default-ignorables (Default-Ignorable) --invisible-glyph Default-Ignorable --not-found-glyph --not-found-variation-selector-glyph (variation-selector) --utf8-clusters UTF8 --cluster-level=0/1/2/3 (cluster merging level) (: 0) --normalize-glyphs (nominal order) --unsafe-to-concat (unsafe-to-concat) --safe-to-insert-tatweel / (safe-to-insert-tatweel) --glyphs --verify (Features options): --features=list . . font-feature-settings CSS 'normal' . CSS . --utf8-clusters UTF-8 . 0 . (Python-esque) . : 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 (Output destination & format options): -o, --output-file=filename (: stdout) -O, --output-format=format (: png) : png/ppm/ansi (View options): --background=rrggbb/rrggbbaa/none (: #FFFFFF) "none" --foreground=rrggbb/rrggbbaa[,...] (: #000000) --rainbow --font-palette=index (: 0) --custom-palette=comma-separated colors --line-space=units (: 0) --font-extents=one to three numbers // (ascent/descent/line-gap) (: auto) --margin=one to four numbers (: 16) --logical (logical box) --ink (ink box) --show-extents (glyph extents) --draw (monochrome draw path) ( ) --paint (color paint path) ( ) (Application Options): --version -n, --num-iterations=N N (: 1) (raster image) . (EXIT CODES) 0: . 1: . 2: (font face) . 3: . 4: . (ENVIRONMENT) HB_FACE_LOADER=face-loader; . HB_FONT_FUNCS=font-funcs; font-funcs . HB_SHAPER_LIST=shaper-list; . (SEE ALSO) hb-view(1), hb-shape(1), hb-raster(1), hb-vector(1), hb-subset(1), hb-info(1) HarfBuzz 14.4.0 August 2026 HB-RASTER(1)