Hangul syllables are made by combining jamo (individual letters) inside a square block. This document is the single source of truth for the jamo list, block types, and slot defaults.
Jamo List (in Unicode index order — used in the composition formula)
19 Initial Consonants (indices 0–18): ㄱ ㄲ ㄴ ㄷ ㄸ ㄹ ㅁ ㅂ ㅃ ㅅ ㅆ ㅇ ㅈ ㅉ ㅊ ㅋ ㅌ ㅍ ㅎ
21 Medial Vowels (indices 0–20): ㅏ ㅐ ㅑ ㅒ ㅓ ㅔ ㅕ ㅖ ㅗ ㅘ ㅙ ㅚ ㅛ ㅜ ㅝ ㅞ ㅟ ㅠ ㅡ ㅢ ㅣ
27 Final Consonants (indices 1–27, 0 means no final consonant): ㄱ ㄲ ㄳ ㄴ ㄵ ㄶ ㄷ ㄹ ㄺ ㄻ ㄼ ㄽ ㄾ ㄿ ㅀ ㅁ ㅂ ㅄ ㅅ ㅆ ㅇ ㅈ ㅊ ㅋ ㅌ ㅍ ㅎ
Medial Vowel Category Classification (used for block type determination):
- Vertical vowels (column type): ㅏ ㅐ ㅑ ㅒ ㅓ ㅔ ㅕ ㅖ ㅣ
- Horizontal vowels (bowl type): ㅗ ㅛ ㅜ ㅠ ㅡ
- Compound vowels (column + bowl): ㅘ ㅙ ㅚ ㅝ ㅞ ㅟ ㅢ
Unicode Composition Formula
음절 코드 = 0xAC00 + (초성인덱스 × 21 + 중성인덱스) × 28 + 종성인덱스
Example: 한 = ㅎ(18)·ㅏ(0)·ㄴ(4) → 0xAC00 + (18×21+0)×28 + 4 = U+D55C Syllable range: U+AC00(가) ~ U+D7A3(힣), 11,172 characters total.
6 Syllable Block Types
| Type | Composition | 예 | Division |
|---|---|---|---|
| 1 | Initial + vertical vowel | 가 바 리 | Left-right |
| 2 | Initial + horizontal vowel | 소 무 그 | Top-bottom |
| 3 | Initial + compound vowel | 화 귀 의 | L-shaped |
| 4 | Type 1 + final consonant | 한 람 밀 | Left-right + bottom |
| 5 | Type 2 + final consonant | 글 물 승 | 3단 |
| 6 | Type 3 + final consonant | 관 궝 흰 | L-shaped + bottom |
Even the same jamo requires different variant glyphs for each type. Example: ㄱ requires a minimal initial-consonant version (types 1/2/3, by presence or absence of a final consonant) and a final-consonant version. Replacing variants with scaling blurs stroke thickness — always redraw them per type.
Slot Box Defaults (starting point)
Coordinate system: SVG viewBox 0 0 1000 1000, y-down, baseline y=880. The values below are starting values based on a default square shape. Concepts (especially non-square shapes) may intentionally break them, and the finalized values are _workspace/glyphs/{콘셉트}/slots.jsonbased on this.
| Type | Initial | Medial | Final |
|---|---|---|---|
| 1 | x 60–460, y 100–840 | x 480–940, y 60–880 (column center x≈790) | — |
| 2 | x 160–840, y 60–460 | x 60–940, y 480–880 (bowl center y≈600) | — |
| 3 | x 60–420, y 60–440 | Bowl part x 60–720 y 460–720 + column part x 740–940 y 60–880 | — |
| 4 | x 60–440, y 80–500 | x 460–940, y 40–560 | x 100–900, y 580–880 |
| 5 | x 180–820, y 60–360 | x 60–940, y 380–540 | x 100–900, y 580–880 |
| 6 | x 60–400, y 60–360 | Bowl part + column part (type 3 compressed) | x 100–860, y 580–880 |
Coverage Stage Strategy
| Stage | Range | Purpose |
|---|---|---|
| Sample | 6–30 representative syllables | Concept validation, feedback collection |
| Complete type set | Ba so hwa han geul gwan (1 character each for types 1–6) | Early detection of block structure defects |
| Draft expansion | Frequently used syllables ~512 characters + Latin, numerals, punctuation | Typesetting of real-world sentences |
| Standard | KS X 1001 2,350자 | Distribution-ready level |
| Full | 11,172 characters (automatically generated by combination) | Complete coverage |
Do not select based on frequency alone — types 3 and 6 (compound vowels) have low frequency and are easily pushed to the back, but their slot structure is the most complex, so verifying them late increases structural rework. All six types must be included at every stage.
Jamo combination system (a concept in which the system is built)
If the concept is rule-based, instead of manually working per syllable, jamo definitions × combination enginegenerate the whole thing. Cheonjiin implementation: _workspace/glyphs/천지인/system/
jamo_cho.json— 19 initial consonants: within the context box ratio skeleton (automatic instantiation of 8 contexts = 4 vowel series × presence/absence of final consonant; weight 80 is not scaled)jamo_jung.json— 21 medial vowels × {J0, J1} absolute coordinates (override the initial consonant box with choBox when needed)jamo_jong.json— 27 final consonants absolute coordinates /contexts.json— context box and constants
python3 _workspace/glyphs/천지인/system/compose.py --text "한글" --out-dir out/ # 지정 음절
python3 _workspace/glyphs/천지인/system/compose.py --ks2350 --out-dir out/ # 전체 11,172자
Modification principles: If a specific character looks awkward, do not fix that character's SVG; fix the definition of the causative jamo and regenerate — it applies uniformly to all characters using that jamo, and individual SVG modifications are lost on the next regeneration. After regeneration, always render a sample (syllables containing the modified jamo + extreme combinations) and visually verify it.
Standard sample text
- Round 1 representative set: han geul ba ram so ri (types 1, 2, 4, 5 — since 3 and 6 are not included, add hwa and gwan in round 2)
- Pangram: "daramjwi heon chetbakwie tagopa"
- Mixed-script sentence: "Hangul font Hangul 2026"