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

NAME

6       unihexrotate - rotate Unifont hex glyphs in quarter turn increments
7

SYNOPSIS

9       unihexrotate [-n quarter-turns] [input-font.hex] > output-font.hex
10

DESCRIPTION

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

OPTIONS

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

EXAMPLES

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

FILES

57       Unifont .hex format input and output files.
58

SEE ALSO

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

AUTHOR

68       unihexrotate was written by David Corbett.
69

LICENSE

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

BUGS

79       No known bugs exist.
80
81
82
83                                  2019 Feb 23                  UNIHEXROTATE(1)
Impressum