OS Manuals

/usr/bin/cmptxtrender

SIL's palaso Python library and scripts for font and language engineering, including cmptxtrender for comparing font shaping output

From palaso-python 0.7.1_git20260911-r0 (os), captured 2026-11-05 by running cmptxtrender --help (exit 0). permalink

usage: cmptxtrender [-h] [-t TEXT] [-o OUTPUT] [-f FEAT] [-e ENGINE] [-l LANG] [-s SCRIPT] [-r]
                    [-k] [-p] [-L LABEL] [-S] [-g GLYPHDATA] [--copy COPY]
                    [--outputtype OUTPUTTYPE] [--texttype TEXTTYPE] [-n] [-V]
                    infonts [infonts ...]

If the first font is above the output file in the filesystem hierarchy, it may not load. On
firefox, ensure that the configuration option security.fileuri.strict_origin_policy is set to
false to allow locally loaded html files to access fonts anywhere on the local filesystem.
Alternatively use --copy to copy the font and reference that.

positional arguments:
  infonts               Input fonts

options:
  -h, --help            show this help message and exit
  -t, --text TEXT       text file to test each line from
  -o, --output OUTPUT   file to log results to
  -f, --feat FEAT       id=value pairs, may be repeated
  -e, --engine ENGINE   renderer(s) to use (ot,*gr,hb,icu). Repeatable
  -l, --lang LANG       language to tag text with
  -s, --script SCRIPT   script of text
  -r, --rtl             right to left
  -k, --keep            keep going, don't return error count
  -p, --split           Split on spaces
  -L, --label LABEL     report font labels
  -S, --strip           Strips smart code other than needed by engine, when copying font
  -g, --glyphdata GLYPHDATA
                        CSV file for glyph name mappings
  --copy COPY           Make a conditional copy of infont1 to the given directory relative to the
                        output directory so that the html does not have to look up in the
                        filesystem hierarchy to find the font. The relative directory is suffixed
                        by the font index (1, 2)
  --outputtype OUTPUTTYPE
                        Type of output file [*html, json]
  --texttype TEXTTYPE   Type of text input file else taken from text file extension
  -n, --nocompare       Show all shaping results, even if they are the same
  -V, --verbose         Give progress indicator
Options (18)
OptionDescriptionSource
-h, --helpshow this help message and exithelp
-t, --text TEXTtext file to test each line fromhelp
-o, --output OUTPUTfile to log results tohelp
-f, --feat FEATid=value pairs, may be repeatedhelp
-e, --engine ENGINErenderer(s) to use (ot,*gr,hb,icu).help
-l, --lang LANGlanguage to tag text withhelp
-s, --script SCRIPTscript of texthelp
-r, --rtlright to lefthelp
-k, --keepkeep going, don't return error counthelp
-p, --splitSplit on spaceshelp
-L, --label LABELreport font labelshelp
-S, --stripStrips smart code other than needed by engine, when copying fonthelp
-g, --glyphdata GLYPHDATACSV file for glyph name mappingshelp
--copy COPYMake a conditional copy of infont1 to the given directory relative to the output directory so that the html does not have to look up in the filesystem hierarchy to find the font.help
--outputtype OUTPUTTYPEType of output file [*html, json]help
--texttype TEXTTYPEType of text input file else taken from text file extensionhelp
-n, --nocompareShow all shaping results, even if they are the samehelp
-V, --verboseGive progress indicatorhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.