Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
fntsample(1)		    General Commands Manual		  fntsample(1)

       fntsample - PDF and PostScript font samples generator

       fntsample [ OPTIONS ] -f	FONT-FILE -o OUTPUT-FILE
       fntsample -h

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

       fntsample supports the following	options.

       --blocks-file, -b BLOCKS-FILE
	      Read Unicode blocks information from BLOCKS-FILE.

       --font-file, -f FONT-FILE
	      Make samples of FONT-FILE.

       --font-index, -n	IDX
	      Font  index  for	FONT-FILE  specified using --font-file option.
	      Useful for files that contain multiple fonts, like TrueType Col-
	      lections (.ttc).	By default font	with index 0 is	used.

       --output-file, -o OUTPUT-FILE
	      Write output to OUTPUT-FILE.

       --other-font-file, -d OTHER-FONT
	      Compare  FONT-FILE  with	OTHER-FONT.  Glyphs added to FONT-FILE
	      will be highlighted.

       --other-index, -m IDX
	      Font index for OTHER-FONT	specified using	--other-font-file  op-

       --postscript-output, -s
	      Use PostScript format for	output instead of PDF.

       --svg, -g
	      Use  SVG format for output.  The generated document contains one
	      page.  Use range selection options to specify which.

       --print-outline,	-l
	      Print document outlines data to standard output.	This data  can
	      be  used	to  add	outlines (aka bookmarks) to resulting PDF file
	      with pdfoutline program.

       --write-outline,	-w
	      Write document outlines directly (only in	PDF output),  requires
	      cairo >= 1.15.4.

       --use-pango, -p
	      Use  Pango for drawing glyph cells.  Pango applies OpenType lay-
	      out which	may be more bullet proof than  just  relaying  on  the
	      font's  cmap.   This especially important	for fonts that rely on
	      OpenType layout for showing even the base	forms of the glyphs.

       --include-range,	-i RANGE
	      Show characters in RANGE.

       --exclude-range,	-x RANGE
	      Do not show characters in	RANGE.

       --style,	-t "STYLE: VAL"
	      Set STYLE	to value VAL.  Run fntsample with option --help	to see
	      list of styles and default values.

       --no-embed, -e
	      Draw the outlines	of the glyphs instead of embedding them	in the
	      PDF file.	 This can be used when embedding the font is  not  de-
	      sired or not allowed.

       --help, -h
	      Display help text	and exit.

       Parameter  RANGE	for -i and -x can be given as one integer or a pair of
       integers	delimited by minus sign	(-).  Integers	can  be	 specified  in
       decimal,	 hexadecimal (0x...) or	octal (0...) format.  One integer of a
       pair can	be missing (-N can be used  to	specify	 all  characters  with
       codes less or equal to N, and N-	for all	characters with	codes greather
       or equal	to N).	Multiple -i and	-x options can be used.

       Glyph cells can have one	of  several  background	 colors.   Meaning  of
       those colors is following:

       white  normal  glyph  present  in  the font, this includes space	glyphs
	      that are usually invisible;

       gray   this glyph is defined in Unicode but not present in the font;

       blue   this is a	control	character;

       black  this glyph is not	defined	in Unicode;

       yellow this is a	new glyph (only	when used with -d).

	      If $SOURCE_DATE_EPOCH is set, its	value is interpreted  as  Unix
	      timestamp	 to  be	used for creation date of generated PDF	files.
	      This is useful for  making  builds  that	use  fntsample	repro-

       Make PDF	samples	for font.ttf and write them to file samples.pdf:
	      fntsample	-f font.ttf -o samples.pdf

       Make  PDF  samples  for font.ttf, compare it with oldfont.ttf and high-
       light new glyphs. Write output to file samples.pdf:
	      fntsample	-f font.ttf -d oldfont.ttf -o samples.pdf

       Make PostScript samples for font.ttf and	 write	output	to  file  sam-	  Show	only glyphs for	characters with	codes less or equal to
       U+04FF but exclude U+0370-U+03FF:
	      fntsample	-f font.ttf -s -o -i	-0x04FF	-x 0x0370-0x03FF

       Make PDF	samples	for font.ttf  and  save	 output	 to  file  samples.pdf
       adding outlines to it:
	      fntsample	-f font.ttf -o temp.pdf	-l > outlines.txt
	      pdfoutline temp.pdf outlines.txt samples.pdf

       Copyright (C) 2007-2017 Eugeniy Meshcheryakov <>
       Homepage: <>


				  2020-08-31			  fntsample(1)


Want to link to this manual page? Use this URL:

home | help