fntsample(1)

1fntsample(1)                General Commands Manual               fntsample(1)
2
3
4

NAME

6       fntsample - PDF and PostScript font samples generator
7
8

SYNOPSIS

10       fntsample [ OPTIONS ] -f FONT-FILE -o OUTPUT-FILE
11       fntsample -h
12

DESCRIPTION

14       fntsample  program  can be used to generate font samples that show Uni‐
15       code coverage of the font and are  similar  in  appearance  to  Unicode
16       charts. Samples can be saved into PDF (default) or PostScript file.
17

OPTIONS

19       fntsample supports the following options.
20
21       --blocks-file, -b BLOCKS-FILE
22              Read Unicode blocks information from BLOCKS-FILE.
23
24       --font-file, -f FONT-FILE
25              Make samples of FONT-FILE.
26
27       --font-index, -n IDX
28              Font  index  for  FONT-FILE  specified using --font-file option.
29              Useful for files that contain multiple fonts, like TrueType Col‐
30              lections (.ttc).  By default font with index 0 is used.
31
32       --output-file, -o OUTPUT-FILE
33              Write output to OUTPUT-FILE.
34
35       --other-font-file, -d OTHER-FONT
36              Compare  FONT-FILE  with  OTHER-FONT.  Glyphs added to FONT-FILE
37              will be highlighted.
38
39       --other-index, -m IDX
40              Font index for OTHER-FONT specified using --other-font-file  op‐
41              tion.
42
43       --postscript-output, -s
44              Use PostScript format for output instead of PDF.
45
46       --svg, -g
47              Use  SVG format for output.  The generated document contains one
48              page.  Use range selection options to specify which.
49
50       --print-outline, -l
51              Print document outlines data to standard output.  This data  can
52              be  used  to  add outlines (aka bookmarks) to resulting PDF file
53              with pdfoutline program.
54
55       --write-outline, -w
56              Write document outlines directly (only in PDF output),  requires
57              cairo >= 1.15.4.
58
59       --use-pango, -p
60              Use  Pango for drawing glyph cells.  Pango applies OpenType lay‐
61              out which may be more bullet proof than  just  relaying  on  the
62              font's  cmap.   This especially important for fonts that rely on
63              OpenType layout for showing even the base forms of the glyphs.
64
65       --include-range, -i RANGE
66              Show characters in RANGE.
67
68       --exclude-range, -x RANGE
69              Do not show characters in RANGE.
70
71       --style, -t "STYLE: VAL"
72              Set STYLE to value VAL.  Run fntsample with option --help to see
73              list of styles and default values.
74
75       --no-embed, -e
76              Draw the outlines of the glyphs instead of embedding them in the
77              PDF file.  This can be used when embedding the font is  not  de‐
78              sired or not allowed.
79
80       --help, -h
81              Display help text and exit.
82
83       Parameter  RANGE for -i and -x can be given as one integer or a pair of
84       integers delimited by minus sign (-).  Integers  can  be  specified  in
85       decimal,  hexadecimal (0x...) or octal (0...) format.  One integer of a
86       pair can be missing (-N can be used  to  specify  all  characters  with
87       codes less or equal to N, and N- for all characters with codes greather
88       or equal to N).  Multiple -i and -x options can be used.
89

COLORS

91       Glyph cells can have one of  several  background  colors.   Meaning  of
92       those colors is following:
93
94       white  normal  glyph  present  in  the font, this includes space glyphs
95              that are usually invisible;
96
97       gray   this glyph is defined in Unicode but not present in the font;
98
99       blue   this is a control character;
100
101       black  this glyph is not defined in Unicode;
102
103       yellow this is a new glyph (only when used with -d).
104

ENVIRONMENT

106       SOURCE_DATE_EPOCH
107              If $SOURCE_DATE_EPOCH is set, its value is interpreted  as  Unix
108              timestamp  to  be used for creation date of generated PDF files.
109              This is useful for  making  builds  that  use  fntsample  repro‐
110              ducible.
111

EXAMPLES

113       Make PDF samples for font.ttf and write them to file samples.pdf:
114              fntsample -f font.ttf -o samples.pdf
115
116       Make  PDF  samples  for font.ttf, compare it with oldfont.ttf and high‐
117       light new glyphs. Write output to file samples.pdf:
118              fntsample -f font.ttf -d oldfont.ttf -o samples.pdf
119
120       Make PostScript samples for font.ttf and  write  output  to  file  sam‐
121       ples.ps.   Show  only glyphs for characters with codes less or equal to
122       U+04FF but exclude U+0370-U+03FF:
123              fntsample -f font.ttf -s -o samples.ps -i -0x04FF -x 0x0370-0x03FF
124
125       Make PDF samples for font.ttf  and  save  output  to  file  samples.pdf
126       adding outlines to it:
127              fntsample -f font.ttf -o temp.pdf -l > outlines.txt
128              pdfoutline temp.pdf outlines.txt samples.pdf
129

AUTHOR

131       Copyright © 2007-2017 Eugeniy Meshcheryakov <eugen@debian.org>
132       Homepage: <https://github.com/eugmes/fntsample/>
133