1UNIHEXROTATE(1) General Commands Manual UNIHEXROTATE(1)
2
3
4
6 unihexrotate - rotate Unifont hex glyphs in quarter turn increments
7
9 unihexrotate [-n quarter-turns] [input-font.hex] > output-font.hex
10
12 unihexrotate reads a GNU Unifont .hex format file named on the command
13 line, or from stdin if no filename is given. If a number of quarter
14 turns is specified, it rotates each glyph clockwise by that number of
15 quarter turns, or counterclockwise if the number is negative. The re‐
16 sulting modified .hex file is written to stdout. The format of a .hex
17 file is described in the unifont(5) man page.
18
19 If the number of quarter turns is not specified, unihexrotate will ro‐
20 tate each glyph by a default value of one quarter turn (i.e., 90 de‐
21 grees) clockwise.
22
23 unihexrotate only supports Unifont .hex files with glyphs that are 8
24 columns and 16 columns wide. If an 8-column glyph is rotated, it is
25 first centered within a 16-column glyph so the rotation will be per‐
26 formed on a 16-by-16 pixel glyph. One additional use of this program
27 is that a glyph can be converted from 8 columns wide to 16 columns wide
28 by specifying a rotation of 0 quarter turns.
29
31 -n Specify an integer number of quarter turn clockwise rotations to
32 perform, typically as "-n 0" through "-n 3" (alternatively as
33 "-n=0" through "-n=3") for rotations of 0, 90, 180, or 270 de‐
34 grees, respectively. Negative values will perform counterclock‐
35 wise rotations by the specified number of quarter turns.
36
38 This example extracts the Mongolian glyphs in the "unifont-base.hex"
39 file (located in the "font/plane00" directory) and pipes them to uni‐
40 hexrotate to rotate by the default amount of one quarter turn clockwise
41 (i.e., by 90 degrees). The basic Mongolian glyphs are in the Unicode
42 range U+1800 through U+18AF. The original glyphs in "unifont-base.hex"
43 are drawn for horizontal rendering (as per the Unicode Standard). The
44 output rotated glyphs are suitable for rendering Mongolian in its tra‐
45 ditional vertical form. Because no filename is specified to unihexro‐
46 tate in this example, its input is taken from stdin.
47
48 grep "^18[0-A]" unifont-base.hex | unihexrotate > vertical.hex
49
50 The next example reverses the rotation performed above, by one quarter
51 turn counterclockwise. In this example, the input filename "verti‐
52 cal.hex" is specified.
53
54 unihexrotate -n -1 vertical.hex > horizontal.hex
55
57 Unifont .hex format input and output files.
58
60 bdfimplode(1), hex2bdf(1), hex2otf(1), hex2sfd(1), hexbraille(1), hex‐
61 draw(1), hexkinya(1), hexmerge(1), johab2ucs2(1), unibdf2hex(1),
62 unibmp2hex(1), unibmpbump(1), unicoverage(1), unidup(1), unifont(5),
63 unifont-viewer(1), unifont1per(1), unifontchojung(1), unifontksx(1),
64 unifontpic(1), unigencircles(1), unigenwidth(1), unihex2bmp(1), uni‐
65 hex2png(1), unihexfill(1), unihexgen(1), unipagecount(1), unipng2hex(1)
66
68 unihexrotate was written by David Corbett.
69
71 unihexrotate is Copyright © 2019 David Corbett.
72
73 This program is free software; you can redistribute it and/or modify it
74 under the terms of the GNU General Public License as published by the
75 Free Software Foundation; either version 2 of the License, or (at your
76 option) any later version.
77
79 No known bugs exist.
80
81
82
83 2019 Feb 23 UNIHEXROTATE(1)