bin/man1/psfed.1


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
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
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166

.Dd January 14, 2019
.Dt PSFED 1
.Os
.
.Sh NAME
.Nm psfed
.Nd PSF2 font editor
.
.Sh SYNOPSIS
.Nm
.Op Fl H Ar height
.Op Fl g Ar glyphs
.Op Fl h Ar height
.Op Fl w Ar width
.Ar file
.
.Sh DESCRIPTION
.Nm
is a PSF2 font editor
for the Linux framebuffer.
.
.Pp
The arguments are as follows:
.
.Bl -tag -width Ds
.It Fl H Ar height
Modify the height of an existing font.
Only increasing the height is allowed.
.
.It Fl g Ar glyphs
Set the number of glyphs in a new font.
The default number of glyphs is 256.
.
.It Fl h Ar height
Set the height of a new font.
The default height is 16.
.
.It Fl w Ar width
Set the width of a new font.
The default width is 8.
.El
.
.Ss Normal Mode
In normal mode,
each glyph is displayed in a grid.
.
.Pp
.Bl -tag -width Ds -compact
.It Ic q
Quit.
.Nm
will ask for confirmation
if the font has been modified
since the last write.
.
.It Ic w
Write font to
.Ar file .
.
.It Ic - Ic +
Adjust display scale.
.
.It Ic h Ic l
Select previous/next glyph.
.
.It Ic k Ic j
Select glyph in previous/next row.
.
.It Ic f
Select glyph of next input character.
.
.It Ic '
Return to previously selected glyph.
.
.It Ic y
Copy selected glyph.
.
.It Ic e
Edit selected glyph in
.Sx Edit Mode .
.
.It Ic i
Enter
.Sx Preview Mode .
.El
.
.Ss Edit Mode
In edit mode,
the selected glyph is displayed for editing
surrounded by a checked border.
The glyph is also displayed unscaled
in the bottom-right corner.
.
.Pp
.Bl -tag -width Ds -compact
.It Ic ESC
Return to
.Sx Normal Mode .
.
.It Ic - Ic +
Adjust display scale.
.
.It Ic g Ic G
Toggle guide on selected column/row.
.
.It Ic h Ic l
Select previous/next bit in row.
.
.It Ic k Ic j
Select previous/next bit in column.
.
.It Ic SPACE
Flip selected bit.
.
.It Ic r
Invert glyph.
.
.It Ic H Ic L
Move glyph left/right.
.
.It Ic K Ic J
Move glyph up/down.
.
.It Ic p
Paste the copied glyph.
.
.It Ic u
Revert glyph to initial state.
.El
.
.Ss Preview Mode
In preview mode,
arbitrary text may be entered
for preview.
Press
.Ic ESC
to return to
.Sx Normal Mode .
.
.Sh ENVIRONMENT
.Bl -tag -width FRAMEBUFFER
.It Ev FRAMEBUFFER
The framebuffer device path.
The default path is
.Pa /dev/fb0 .
.El
.
.Sh SEE ALSO
.Xr psfaddtable 1 ,
.Xr psfgettable 1 ,
.Xr psfstriptable 1 ,
.Xr setfont 8
.
.Sh CAVEATS
.Nm
does not support Unicode tables.
Use
.Xr psfaddtable 1
to add Unicode tables
to fonts created by
.Nm .
.
.Sh BUGS
.Nm
makes no attempt to convert header fields
to and from little-endian format.