SuperAPI AI Directory

hangul-composition

General & other

View repository

Updated 10-16 07:58

About this skill

Hangul Syllable Block Composition Structure

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"