ftstring.1 1.58 KB
Newer Older
Werner Lemberg's avatar
Werner Lemberg committed
1
.TH FTSTRING 1 "October 2020" "Freetype 2.10.4"
Werner Lemberg's avatar
Werner Lemberg committed
2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
.
.
.SH NAME
.
ftstring \- string viewer
.
.
.SH SYNOPSIS
.
.B ftstring
.RI [ options ]
.I pt font .\|.\|.
.
.
.SH DESCRIPTION
.
.B ftstring
19 20
displays a text string with the given font, allowing to change
various rendering and display options interactively.
Werner Lemberg's avatar
Werner Lemberg committed
21 22 23 24 25 26 27 28 29 30
.
.TP
.B pt
The point size for the given resolution.
If resolution is 72dpi, this directly gives the ppem value (pixels per EM).
.
.TP
.B font
The font file(s) to display.
For Type 1 font files,
Alexei Podtelezhnikov's avatar
Alexei Podtelezhnikov committed
31
.B ftstring
Werner Lemberg's avatar
Werner Lemberg committed
32 33 34 35
also tries to attach the corresponding metrics file (with extension `.afm'
or `.pfm').
.
.PP
36 37 38 39
Besides the string,
.B ftstring
also displays two stress test pattens sensitive to rendering flaws, such as
incorrect gamma settings.
40
Alternative text-carpeting and waterfall views are also available.
Werner Lemberg's avatar
Werner Lemberg committed
41 42 43 44 45 46
This program is part of the FreeType demos package.
.
.
.SH OPTIONS
.
.TP
47
.BI \-d \ W x H \fR[\fPx D\fR]\fP
Werner Lemberg's avatar
Werner Lemberg committed
48 49
Set the window width to
.I W
50
px, the height to
Werner Lemberg's avatar
Werner Lemberg committed
51
.I H
52
px, and optionally the depth to
Werner Lemberg's avatar
Werner Lemberg committed
53 54
.I D
bpp (default: 640x480x24).
Werner Lemberg's avatar
Werner Lemberg committed
55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81
.
.TP
.BI \-r \ r
Use resolution
.I r
dpi (default: 72dpi).
.
.TP
.BI \-e \ enc
Specify encoding tag (default: no encoding).
Common values:
.B unic
(Unicode),
.B symb
(symbol),
.B ADOB
(Adobe standard),
.B ADBC
(Adobe custom).
.
.TP
.BI \-m \ text
Use
.I text
for rendering.
.
.TP
82
.BI \-k \ keys
Werner Lemberg's avatar
Werner Lemberg committed
83
Emulate sequence of keystrokes upon start-up.
84
If the keystrokes contain 'q', the program operates in batch mode.
85 86 87 88 89 90 91
Function keys
.RI F x
are mapped to character codes
.RI 0xF x ;
as an example,
.B \-k\ $'\exF3q'
is function key 'F3' followed by character 'q'.
92 93
.
.TP
Werner Lemberg's avatar
Werner Lemberg committed
94 95 96 97
.B \-v
Show version.
.
.\" eof