unigen-hangul - Generate Hangul syllables from a Johab 6/3/1 Unifont hex file

NAME SYNOPSIS DESCRIPTION OPTIONS EXAMPLES FILES SEE ALSO AUTHOR LICENSE BUGS

NAME

unigen-hangul − Generate Hangul syllables from a Johab 6/3/1 Unifont hex file

SYNOPSIS

unigen-hangul −i hangul-base.hex −o hangul-syllables.hex

unigen-hangul generates Hangul syllables from an input Unifont .hex file encoded in Johab 6/3/1 format. By default, the output is the Unicode Hangul Syllables range, U+AC00..U+D7A3. Options allow the user to specify a starting code point for the output Unifont .hex file, and ranges in hexadecimal of the starting and ending Hangul Jamo code points:

	Range		Hangul
	1100−115E		Hangul Jamo initial consonants (choseong)
	A960−A97C		Hangul Jamo Extended-A initial consonants (choseong)
	1161−11A7		Hangul Jamo medial vowels and diphthongs (jungseong)
	D7B0−D7C6		Hangul Jamo Extended-B medial vowels and diphthongs (jungseong)
	11A8−11FF		Hangul Jamo final consonants (jongseong).
	D7CB−D7FB		Hangul Jamo Extended-B final consonants (jongseong).

A single code point or 0 to omit can be specified instead of a range. A starting code point of one position before a valid starting range for a Hangul jamo series (choseong, jungseong, and/or jongseong) will first use a blank glyph for that jamo, and then cycle through remaining valid code points for the respective choseong, jungseong, or jongseong. A range can span modern and ancient, and even Hangul Jamo Extended-A and Hangul Jamo Extended-B ranges.

For example,

-j3 11A7−D7FB

Will first use no jongseong (because U+11A7 is one before the start of Hangul Jamo jongseong code points), then loop through jongseong in the Hangul Jamo range of U+11A8 through U+11FF, and then loop through jongseong in the Hangul Jamo Extended-B range of U+D7CB through U+D7FB.

OPTIONS

	Option		Function
	−h, −−help		Print a help message and exit.
	−all		Generate all Hangul syllables, using all modern and ancient Hangul in the Unicode range U+1100..U+11FF, assigned code points in the Extended-A range of U+A960..U+A97C, and assigned code points in the Extended-B range of U+D7B0..U+D7FF. WARNING: this will generate over 1,600,000 syllables in a 115 megabyte Unifont .hex format file. The default is to only output the 11,172 modern Hangul syllables.
	-c code_point		Starting code point in hexadecimal for output file.
	−j1 start-end		Choseong (jamo 1) start-end range in hexadecimal.
	−j2 start-end		Jungseong (jamo 2) start-end range in hexadecimal.
	−j3 start-end		Jongseong (jamo 3) start-end range in hexadecimal.
	−i input_file		Unifont hangul-base.hex formatted input file.
	−o output_file		Unifont .hex format output file.

EXAMPLES

unigen-hangul -c 1 -j3 11AB-11AB \

-i hangul-base.hex -o nieun-only.hex

This command generates Hangul syllables using all modern choseong and jungseong, and only the jongseong nieun (Unicode code point U+11AB). The output Unifont .hex file will contain code points starting at 1. Instead of specifying "-j3 11AB-11AB", simply using "-j3 11AB" will also suffice.

This next example is a series of syllable sets suggested by Ho-Seok Ee for preliminary syllable alignment checking of modern Hangul.

	•		The first command generates all modern syllables containing no jongseong (final consonant), starting at Unifont hexadecimal glyph location 0x1000; selecting a jongseong value that is out of range (U+1160 in this case) will use a blank filler in place of the jongseong.
	•		The second command generates all modern syllables containing jongseong Kiyeok (U+11AB), which has a horizontal line extending across the lower portion of a syllable, starting at Unifont hexadecimal glyph location 0x2000.
	•		The third command generates all modern Hangul syllables containing jongseong Rieul (U+11AF), starting at Unifont hexadecimal glyph location 0x3000.
	•		The fourth command generates all modern Hangul syllables containing choseong (initial consonant) Rieul (U+1105), starting at Unifont hexadecimal glyph location 0x4000.

Here is the command sequence:

unigen-hangul -c 1000 -j1 1100-1112 -j2 1161-1175 -j3 1160 \

-i hangul-base.hex > hangul-prep.hex

unigen-hangul -c 2000 -j1 1100-1112 -j2 1161-1175 -j3 11AB \

-i hangul-base.hex >> hangul-prep.hex

unigen-hangul -c 3000 -j1 1100-1112 -j2 1161-1175 -j3 11AF \

-i hangul-base.hex >> hangul-prep.hex

unigen-hangul -c 4000 -j1 1105 -j2 1161-1175 -j3 11A8-11C2 \

-i hangul-base.hex >> hangul-prep.hex

The resulting .hex file can then be examined with hexdraw, unihex2bmp, etc.