more work files that is not a goal of v1.11 release

getWidth() is heavier than ever now, at least it's cached

.gitattributes

@@ -0,0 +1,10 @@
+*.psd filter=lfs diff=lfs merge=lfs -text
+*.ogg filter=lfs diff=lfs merge=lfs -text
+*.tga filter=lfs diff=lfs merge=lfs -text
+*.gz filter=lfs diff=lfs merge=lfs -text
+*.opus filter=lfs diff=lfs merge=lfs -text
+*.pdf filter=lfs diff=lfs merge=lfs -text
+*.zip filter=lfs diff=lfs merge=lfs -text
+*.kra filter=lfs diff=lfs merge=lfs -text
+*.png filter=lfs diff=lfs merge=lfs -text
+*.wav filter=lfs diff=lfs merge=lfs -text

.gitignore

@@ -4,3 +4,12 @@ demo/assets/*
 out/*
 lib/*
 Terrarum-sans-bitmap*.zip
+TerrarumSansBitmap*.jar
+Font*.jar
+tmp_*
+*~
+.tmp*
+tmp_*
+*.bak
+*-autosave.kra
+.directory

.idea/artifacts/FontDemoGDX.xml

@@ -6,6 +6,82 @@
       <element id="directory" name="META-INF">
         <element id="file-copy" path="$PROJECT_DIR$/FontTestGDX/META-INF/MANIFEST.MF" />
       </element>
+      <element id="artifact" artifact-name="TerrarumSansBitmap" />
+      <element id="extracted-dir" path="$KOTLIN_BUNDLED$/lib/kotlin-stdlib.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$KOTLIN_BUNDLED$/lib/kotlin-reflect.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$KOTLIN_BUNDLED$/lib/kotlin-test.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$KOTLIN_BUNDLED$/lib/kotlin-stdlib-jdk7.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$KOTLIN_BUNDLED$/lib/kotlin-stdlib-jdk8.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/jnlp.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/gdx-1.10.0.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-3.2.3.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/jinput-2.0.5.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/jutils-1.0.0.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/jorbis-0.0.17.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/jlayer-1.0.1-gdx.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-glfw-3.2.3.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/TerrarumSansBitmap.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/gdx-1.10.0-javadoc.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/gdx-1.10.0-sources.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-openal-3.2.3.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-opengl-3.2.3.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/gdx-platform-1.10.0.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-3.2.3-javadoc.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-3.2.3-sources.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/jinput-2.0.5-javadoc.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/jinput-2.0.5-sources.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/jutils-1.0.0-javadoc.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/jutils-1.0.0-sources.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-jemalloc-3.2.3.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/jorbis-0.0.17-javadoc.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/jorbis-0.0.17-sources.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/jlayer-1.0.1-gdx-javadoc.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/jlayer-1.0.1-gdx-sources.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-glfw-3.2.3-javadoc.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-glfw-3.2.3-sources.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/gdx-backend-lwjgl3-1.10.0.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-3.2.3-natives-linux.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-3.2.3-natives-macos.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-openal-3.2.3-javadoc.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-openal-3.2.3-sources.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-opengl-3.2.3-javadoc.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-opengl-3.2.3-sources.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-3.2.3-natives-windows.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-jemalloc-3.2.3-javadoc.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-jemalloc-3.2.3-sources.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-glfw-3.2.3-natives-linux.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-glfw-3.2.3-natives-macos.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-3.2.3-natives-linux-arm32.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-3.2.3-natives-linux-arm64.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-3.2.3-natives-windows-x86.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-glfw-3.2.3-natives-windows.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-openal-3.2.3-natives-linux.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-openal-3.2.3-natives-macos.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-opengl-3.2.3-natives-linux.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-opengl-3.2.3-natives-macos.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/gdx-backend-lwjgl3-1.10.0-javadoc.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/gdx-backend-lwjgl3-1.10.0-sources.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/jinput-platform-2.0.5-natives-osx.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-jemalloc-3.2.3-natives-linux.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-jemalloc-3.2.3-natives-macos.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-openal-3.2.3-natives-windows.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-opengl-3.2.3-natives-windows.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/gdx-platform-1.10.0-natives-desktop.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/jinput-platform-2.0.5-natives-linux.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-glfw-3.2.3-natives-linux-arm32.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-glfw-3.2.3-natives-linux-arm64.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-glfw-3.2.3-natives-windows-x86.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-jemalloc-3.2.3-natives-windows.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/jinput-platform-2.0.5-natives-windows.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-openal-3.2.3-natives-linux-arm32.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-openal-3.2.3-natives-linux-arm64.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-openal-3.2.3-natives-windows-x86.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-opengl-3.2.3-natives-linux-arm32.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-opengl-3.2.3-natives-linux-arm64.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-opengl-3.2.3-natives-windows-x86.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-jemalloc-3.2.3-natives-linux-arm32.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-jemalloc-3.2.3-natives-linux-arm64.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$PROJECT_DIR$/lib/lwjgl-jemalloc-3.2.3-natives-windows-x86.jar" path-in-jar="/" />
     </root>
   </artifact>
 </component>

.idea/artifacts/TerrarumSansBitmap.xml

@@ -1,6 +1,6 @@
 <component name="ArtifactManager">
   <artifact type="jar" name="TerrarumSansBitmap">
-    <output-path>$PROJECT_DIR$/FontTestGDX/lib</output-path>
+    <output-path>$PROJECT_DIR$/lib</output-path>
     <root id="archive" name="TerrarumSansBitmap.jar">
       <element id="module-output" name="BuildJAR_TerrarumSansBitmap" />
       <element id="directory" name="META-INF">

.idea/kotlinc.xml

@@ -1,10 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
-  <component name="Kotlin2JvmCompilerArguments">
-    <option name="jvmTarget" value="1.8" />
-  </component>
   <component name="KotlinCommonCompilerArguments">
-    <option name="apiVersion" value="1.2" />
+    <option name="apiVersion" value="1.4" />
-    <option name="languageVersion" value="1.2" />
+    <option name="languageVersion" value="1.4" />
   </component>
 </project>

.idea/libraries/KotlinJavaRuntime.xml

@@ -1,12 +1,19 @@
 <component name="libraryTable">
   <library name="KotlinJavaRuntime">
     <CLASSES>
-      <root url="jar://$KOTLIN_BUNDLED$/lib/kotlin-runtime.jar!/" />
+      <root url="jar://$KOTLIN_BUNDLED$/lib/kotlin-stdlib.jar!/" />
       <root url="jar://$KOTLIN_BUNDLED$/lib/kotlin-reflect.jar!/" />
+      <root url="jar://$KOTLIN_BUNDLED$/lib/kotlin-test.jar!/" />
+      <root url="jar://$KOTLIN_BUNDLED$/lib/kotlin-stdlib-jdk7.jar!/" />
+      <root url="jar://$KOTLIN_BUNDLED$/lib/kotlin-stdlib-jdk8.jar!/" />
     </CLASSES>
     <JAVADOC />
     <SOURCES>
-      <root url="jar://$KOTLIN_BUNDLED$/lib/kotlin-runtime-sources.jar!/" />
+      <root url="jar://$KOTLIN_BUNDLED$/lib/kotlin-stdlib-sources.jar!/" />
+      <root url="jar://$KOTLIN_BUNDLED$/lib/kotlin-reflect-sources.jar!/" />
+      <root url="jar://$KOTLIN_BUNDLED$/lib/kotlin-test-sources.jar!/" />
+      <root url="jar://$KOTLIN_BUNDLED$/lib/kotlin-stdlib-jdk7-sources.jar!/" />
+      <root url="jar://$KOTLIN_BUNDLED$/lib/kotlin-stdlib-jdk8-sources.jar!/" />
     </SOURCES>
   </library>
 </component>

.idea/libraries/TesterLib.xml

@@ -1,10 +0,0 @@
-<component name="libraryTable">
-  <library name="TesterLib">
-    <CLASSES>
-      <root url="file://$PROJECT_DIR$/FontTestGDX/lib" />
-    </CLASSES>
-    <JAVADOC />
-    <SOURCES />
-    <jarDirectory url="file://$PROJECT_DIR$/FontTestGDX/lib" recursive="false" />
-  </library>
-</component>

.idea/libraries/lib.xml

@@ -1,5 +1,5 @@
 <component name="libraryTable">
-  <library name="GdxLib">
+  <library name="lib">
     <CLASSES>
       <root url="file://$PROJECT_DIR$/lib" />
     </CLASSES>

.idea/misc.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
-  <component name="ProjectRootManager" version="2" languageLevel="JDK_1_8" default="true" project-jdk-name="1.8" project-jdk-type="JavaSDK">
+  <component name="ProjectRootManager" version="2" languageLevel="JDK_1_8" default="true" project-jdk-name="1.8.0_242" project-jdk-type="JavaSDK">
     <output url="file://$PROJECT_DIR$/out" />
   </component>
 </project>

BuildJAR_TerrarumSansBitmap.iml

@@ -8,6 +8,6 @@
     <orderEntry type="inheritedJdk" />
     <orderEntry type="sourceFolder" forTests="false" />
     <orderEntry type="library" name="KotlinJavaRuntime" level="project" />
-    <orderEntry type="library" name="GdxLib" level="project" />
+    <orderEntry type="library" name="lib" level="project" />
   </component>
 </module>

CONTRIBUTING.md

@@ -1,3 +1,5 @@
+#### Pixel Artists Wanted: for Arabic (all four forms) and other Indian scripts (all the ligatures). Must willing to follow the styles and have a knowledge in Unicode. Your name will be inscribed in the list of contributors.
+
 You can contribute to the font by fixing wrong glyphs, suggesting better ones, extending character set (letters for other writing systems or filling in the blanks on the existing ones), or code for other game frameworks (not limited to Java). Please leave pull request for that.
 
 Font Spritesheets are stored in ```assets/graphics/fonts``` directory. Image format must be TGA with Alpha — no PNG. If someone needs PNG, they can batch-convert the font using utils like ImageMagick.
@@ -5,7 +7,7 @@ Font Spritesheets are stored in ```assets/graphics/fonts``` directory. Image for
 
 #### Before getting started, you did read our design goals, right? Good. Now you may continue your awesome work.
 
-### Ascenders, descenders, width informations
+## Ascenders, descenders, width informations (aka Glyph Tags)
 
 ![Alas, use more modern browser or get better internet connexion!](glyph_height_pos_annotation.png)
 
@@ -24,56 +26,169 @@ Each cell is 16 px wide, and any glyph you draw **must be contained within lefts
 
 
 
-### Font Metrics
+## Font Metrics for variable-width font sheets
 
 Although the font is basically a Spritesheet, some of the sheet expects variable widths to be supported. Any sheets with ```_variable``` means it expects variable widths. Anything else expects fixed width (regular Spritesheet behaviour). ```cjkpunct``` has width of 10, ```kana``` and ```hangul_johab``` has width of 12, ```wenquanyi``` has width of 16.
 
-### Parsing glyph widths for variable font sheets
+### Parsing Glyph Tags
 
 ![Sample of Font Spritesheet with annotation](width_bit_encoding_annotated.png)
 
 Width is encoded in binary bits, on pixels. On the font spritesheet, every glyph has vertical dots on their top-right side (to be exact, every (16k - 1)th pixel on x axis). Above image is a sample of the font, with width information coloured in magenta. From top to bottom, each dot represents 1, 2, 4 and 8. For example, in the above image, ! (exclamation mark) has width of 5, " (double quote) has width of 6, # (octothorp) has width of 8, $ (dollar sign) has width of 9.
 
-### Glyph Tagging System
+### Glyph Tags
 
-Green-tinted area (should be 10 px tall) contains the tags. Tags are defined as following:
+Rightmost vertical column (should be 20 px tall) contains the tags. Tags are defined as following:
 
 ```
-(LSB) 0 == RTL
+(LSB) W -,
-      1 -+ 1 | Align to this X pos of prev char,
+      W  |
-      1  | 2 | only valid if write-on-top is 1
+      W  |= Width of the character
-      1  | 4 | and is centre-aligned and non-zero
+      W  |
-      1 -+ 8 | (if this is zero, floorOf(width/2) will be used instead)
+      W -'
-      0 -+ 0 Align  1 Align  0 Align   1 Align before
+      m --Is this character lowheight?
-      1 -+ 0 left   0 right  1 centre  1 the glyph
+      K -,
-      0 == Write on top of prev chars (e.g. diacritics)
+      K  |= Tags used by the "Keming Machine"
-      1 == Diacritics stack 0:upward/1:downward
+      K -'
-(MSB) X == undefined, should be 0
+      Q ---Compiler Directive (see below)
+      n --,
+      Y -, `-Nudging Bits (see below)
+      X  |
+      Y  |= Diacritics Anchor Points (see below)
+      X -'  
+      A -,_ 0 Align  1 Align  0 Align   1 Align before
+      A -'  0 Left   0 Right  1 Centre  1 the glyph
+      D --Diacritics Type Bit (see below; not all diacritics are actually marked as a diacritics on the spritesheet)
+      S -,_ 0 Stack  1 Stack  0 Before  1 Up &
+(MSB) S -'  0 up     0 down   1 &After   1 Down* (e.g. U+0C48)
+
+Align Centre and Align Right will respect the diacritics anchor points.
+The Align Right AND Custom anchor point is being used for Thai diacritics.
+When a width AND diacritics type bit is set, the entire glyph is shifted to the right as specified and the space of same width will be inserted.
+(See SUNDANESE PAMINGKAL U+1BA1)
+
+Up&Down:
+1. when two pixels are both #00FF00 it's "don't stack"
+2. otherwise, it's actually up&down
 
-NOTE: If glyphs are right or centre aligned, they must be aligned in the
-      same way inside of the bitmap; the program assumes every variable-
-      width glyphs to have a width of 15, regardless of the tagged width.
-      If the diacritic is aligned before the glyph, the diacritic itself
-      is always assumed as left-aligned, as this font will swap position
-      of said diacritic and the glyph right before it.
 ```
 
+#### Nudging Bits Encoding
+
+    <MSB,Red> SXXXXXXX SYYYYYYY 00000000 <LSB,Blue>
+
+Each X and Y numbers are Signed 8-Bit Integer.
+
+X-positive: nudges towards left  
+Y-positive: nudges towards up  
+
+#### Diacritics Anchor Point Encoding
+
+4 Pixels are further divided as follows:
+
+| LSB |   | Red | Green | Blue |
+| ------------ | ------------ | ------------ | ------------ | ------------ |
+| Y | Anchor point Y for: | undefined | undefined | undefined |
+| X | Anchor point X for: | undefined | undefined | undefined |
+| Y | Anchor point Y for: | (unused) | (unused) | (unused) |
+| X | Anchor point X for: | Type-0 | Type-1 | Type-2 |
+| **MSB** |   |   |   |   |
+
+    <MSB,Red> 1Y1Y1Y1Y 1Y2Y2Y2Y 1Y3Y3Y3Y <LSB,Blue>
+    <MSB,Red> 1X1X1X1X 1X2X2X2X 1X3X3X3X <LSB,Blue>
+
+where Red is first, Green is second, Blue is the third diacritics.
+MSB for each word must be set so that the pixel would appear brighter on the image editor.
+(the font program will only read low 7 bits for each RGB channel)
+
+#### Diacritics Type Bit Encoding
+
+    <MSB,Red> FFFFFFFF FFFFFFFF FFFFFFFF <LSB,Blue> (For Type-0)
+    <MSB,Red> TTTT0000 00000000 00000000 <LSB,Blue> (For Type-1 to Type-15)
+
+Certain types of diacritics have predefined meanings (but some writing systems define their own meaning e.g. Devanagari):
+
+* Type-0: Above
+* Type-1: Below (when it should be separated from being above)
+* Type-2: Overlaid (will shift down 2 pixels for lowheight glyphs instead of the default of 4 pixels)
+
+
+#### Compiler Directives
+
+    <MSB,Red> [Opcode] [arg1] [arg2] <LSB,Blue>
+
+Currently supported opcodes:
+
+*00000000: No-operation; does not use the Compiler Directive system.
+    
+*10000111: Replace a character with maximum 7 subchars.
+  Replacement characters are encoded vertically from X-zero, bit by bit
+  (colour of the pixel doesn't matter) with LSB sitting on Y-zero.
+
+*11111111: Tagging Used by the Subsystems. e.g. #FF0000 marks invalid combination.
+
+#### Stack Up/Down
+
+When the tag is stack-up, it'll be drawn 4 px lower if the underlying
+character is lowercase.
+
+#### Align-To-This-X-Pos
+
+Since this tag does not make sense for diacritics, they will use the value for compeletely different purpose:
+
+    0 : Nothing special
+    1 : Covers previous character; it's neither stack-up nor down.
+        Will be drawn 2 px lower if the underlying character is lowercase
+    2 : Joiner.
+    3..15: undefined
+
+#### Diacritics That Comes Before and After
+
+When this tag is set, the font compiler will replace this glyph with two extra code points given in the bitmap.
+
+To implement those, this two extra code points are needed, which are provided in the Unicode's Reference Chart (www.unicode.org/charts/PDF/Uxxxx.pdf) The code points must be "drawn" in the bitmap, in the same manor as a tagging system. The zeroth column (x = 0) has the "before" character, the first column (x = 1) has the "after". All nineteen pixels (bits) are read by the font, which encompasses U+0000..U+EFFFF
+
+For working examples, take a note at the bengali sprite sheet.
+
+This tag can be used as a general "replace this with these" directive, as long as you're replacing it into two letters. This directive is exploited to construct dutch ligature "IJ" (U+0132 and U+0133), in the sheet LatinExtA.
+
+Also note that the font compiler will not "stack" these diacritics.
+
+#### The Keming Machine Tags
+
+Keming Machine Tags define the rough shape of the glyph. Please read `keming_machine.txt` for further information.
+
+
+#### NOTES
+- If glyphs are right or centre aligned, they must be aligned in the same way inside of the bitmap; the font compiler assumes every variable-width glyphs to have a width of 15, regardless of the tagged width.
+- If the diacritic is aligned before the glyph, the diacritic itself is always assumed as left-aligned, as the font compiler will exchange position of said diacritic and the glyph right before it.
+
 ![Visual representation of left/right/centre align](alignment_illustration.jpg)
 
 (fun fact: it was drawn on Rhodia memopad with Lamy 2000, then photographed and edited on my iPhone. Letter used is a Cherokee WE Ꮺ)
 
-### Implementing the Korean writing system
+## Technical Limitations
+
+- Each spritesheet is 4096x4096 maximum, which is a size of 4K Texture. However it is recommended to be smaller or equal to 1024x1024.
+- Glyphs exceeding 15px of width needs to be broken down with 2 or more characters. Wider sheets WILL NOT BE IMPLEMENTED, can't waste much pixels just for few superwide glyphs.
+- Due to how the compiler is coded, actual glyph must have alpha value of 255, the tags must have alpha values LESS THAN 255 (and obviously greater than zero). RGB plane of the TGA image doesn't do anything, keep it as #FFFFFF white.
+
+## Implementation of the Korean writing system
 
 On this font, Hangul letters are printed by assemblying two or three letter pieces. There are 10 sets of Hangul letter pieces on the font. Top 6 are initials, middle 2 are medials, and bottom 2 are finals. On the rightmost side, there's eight assembled glyphs to help you with (assuming you have basic knowledge on the writing system). Top 6 tells you how to use 6 initials, and bottom 2 tells you how to use 2 finals.
 
 This is a Kotlin-like pseudocode for assembling the glyph:
 
+    // NOTE: this code implements modern Hangul only, in the unicode range of 0xAC00..0xD7A3.
+    // the spritesheet is made to accomodate Johab encoding scheme, but can still be used with the following code.
+    // for the code for full Johab encoding (U+1100.. that includes Old Korean), please refer to the actual code in the repo.
+    
     function getHanChosung(hanIndex: Int) = hanIndex / (21 * 28)
     function getHanJungseong(hanIndex: Int) = hanIndex / 28 % 21
     function getHanJongseong(hanIndex: Int) = hanIndex % 28
 
-    jungseongWide = arrayOf(8, 12, 13, 17, 18, 21)
+    jungseongWide = arrayOf(9,13,14,18,19)
-    jungseongComplex = arrayOf(9, 10, 11, 14, 15, 16, 22)
+    jungseongComplex = arrayOf(10,11,12,15,16,17,20,23)
 
     function getHanInitialRow(hanIndex: Int): Int {
         val ret: Int

CONTRIBUTORS.txt

@@ -0,0 +1,9 @@
+Project Maintainer and Programmer
+
+- minjaesong (Torvald)
+
+
+This font was not possible without following artists:
+
+- minjaesong (Torvald)
+<< Append your name here. If you're getting consistent merge conflicts, push without this and leave a Issue on the GitHub page >>

FontTestGDX/FontTestGDX.iml

@@ -7,8 +7,8 @@
     </content>
     <orderEntry type="inheritedJdk" />
     <orderEntry type="sourceFolder" forTests="false" />
+    <orderEntry type="module" module-name="BuildJAR_TerrarumSansBitmap" />
     <orderEntry type="library" name="KotlinJavaRuntime" level="project" />
-    <orderEntry type="library" name="GdxLib" level="project" />
+    <orderEntry type="library" name="lib" level="project" />
-    <orderEntry type="library" name="TesterLib" level="project" />
   </component>
 </module>

FontTestGDX/META-INF/MANIFEST.MF

@@ -1,6 +1,3 @@
 Manifest-Version: 1.0
-Class-Path: lib/gdx.jar lib/gdx-backend-lwjgl.jar lib/gdx-backend-lwjg
- l-natives.jar lib/gdx-natives.jar lib/kotlin-stdlib.jar TerrarumSansB
- itmap.jar
 Main-Class: FontTestGDXKt
 

FontTestGDX/src/FontTestGDX.kt

@@ -1,18 +1,23 @@
 import com.badlogic.gdx.*
-import com.badlogic.gdx.backends.lwjgl.LwjglApplication
+import com.badlogic.gdx.backends.lwjgl3.Lwjgl3Application
-import com.badlogic.gdx.backends.lwjgl.LwjglApplicationConfiguration
+import com.badlogic.gdx.backends.lwjgl3.Lwjgl3ApplicationConfiguration
+import com.badlogic.gdx.files.FileHandle
 import com.badlogic.gdx.graphics.*
 import com.badlogic.gdx.graphics.g2d.SpriteBatch
 import com.badlogic.gdx.graphics.glutils.FrameBuffer
 import com.badlogic.gdx.utils.ScreenUtils
-import net.torvald.terrarumsansbitmap.gdx.GameFontBase
+import com.badlogic.gdx.utils.StreamUtils
+import net.torvald.terrarumsansbitmap.gdx.TerrarumSansBitmap
+import java.io.File
+import java.io.IOException
+import java.io.OutputStream
 
 /**
  * Created by minjaesong on 2018-07-26.
  */
 class FontTestGDX : Game() {
 
-    lateinit var font: GameFontBase
+    lateinit var font: TerrarumSansBitmap
 
     lateinit var inputText: List<String>
 
@@ -22,119 +27,31 @@ class FontTestGDX : Game() {
 
     lateinit var camera: OrthographicCamera
 
-    override fun create() {
+    private val testing = false
-        font = GameFontBase("./assets", flipY = false, errorOnUnknownChar = true) // must test for two flipY cases
 
-        val inTextFile = Gdx.files.internal("./FontTestGDX/demotext.txt")
+    private val demotextName = if (testing) "testtext.txt" else "demotext.txt"
-        val reader = inTextFile.reader()
+    private val outimageName = if (testing) "testing.PNG" else "demo.PNG"
+
+    private lateinit var faketex: Texture
+
+    private val lineHeight = 24
+
+    override fun create() {
+        font = TerrarumSansBitmap("./assets", debug = true, flipY = false, errorOnUnknownChar = false, shadowAlpha = 0.5f) // must test for two flipY cases
+
+        val inTextFile = Gdx.files.internal("./$demotextName")
+        val reader = inTextFile.reader("UTF-8")
         inputText = reader.readLines()
         reader.close()
 
         batch = SpriteBatch()
 
 
-
+        // create faketex
-
+        val fakepix = Pixmap(1,1,Pixmap.Format.RGBA8888)
-        println("START")
+        fakepix.drawPixel(0,0,-1)
-
+        faketex = Texture(fakepix)
-        val l = intArrayOf(0xFF00,
+        fakepix.dispose()
-                0xFF10,
-                0xFF20,
-                0xFF30,
-                0xFF40,
-                0xFF50,
-                0xFF60,
-                0xFF70,
-                0xFF80,
-                0xFF90,
-                0xFFA0,
-                0xFFB0,
-                0xFFC0,
-                0xFFD0,
-                0xFFE0,
-                0xFFF0,
-                0xFEF0,
-                0xFDF0,
-                0xFCF0,
-                0xFBF0,
-                0xFAF0,
-                0xF9F0,
-                0xF8F0,
-                0xF7F0,
-                0xF6F0,
-                0xF5F0,
-                0xF4F0,
-                0xF3F0,
-                0xF2F0,
-                0xF1F0,
-                0xF0F0,
-                0xF0F1,
-                0xF0F2,
-                0xF0F3,
-                0xF0F4,
-                0xF0F5,
-                0xF0F6,
-                0xF0F7,
-                0xF0F8,
-                0xF0F9,
-                0xF0FA,
-                0xF0FB,
-                0xF0FC,
-                0xF0FD,
-                0xF0FE,
-                0xF0FF,
-                0xF0EF,
-                0xF0DF,
-                0xF0CF,
-                0xF0BF,
-                0xF0AF,
-                0xF09F,
-                0xF08F,
-                0xF07F,
-                0xF06F,
-                0xF05F,
-                0xF04F,
-                0xF03F,
-                0xF02F,
-                0xF01F,
-                0xF00F,
-                0xF10F,
-                0xF20F,
-                0xF30F,
-                0xF40F,
-                0xF50F,
-                0xF60F,
-                0xF70F,
-                0xF80F,
-                0xF90F,
-                0xFA0F,
-                0xFB0F,
-                0xFC0F,
-                0xFD0F,
-                0xFE0F,
-                0xFF0F)
-        val s = "ᚱᛂᚴᛋᛂᛋᛏᛋᚮᚾᛔᚢᛏᛚᚮᛋ᛬ᚱᛂᚴᛋᛋᚢᚼᚾᚢᛘᚢᛚᚾᛏᚮ᛬ᛏᚮᛋᛁᚮᚵᛂᚢᛏᚮᚱᛘᛔᚱᛂᚴᛋᛏ᛭ᛋᚢᚼᚾᚢᛋᛘᚮᛁᚵᚾᛁᛂᛏᚮᛑ᛭ᚵᛂᚢᛏᚮᚱ"
-        var lc = 0
-        var sc = 0
-
-        while (lc < l.size) {
-            print(font.toColorCode(l[lc]))
-            print(s[sc])
-
-            lc++
-            sc++
-
-            if (sc == s.length) break
-
-            if (s[sc] == ' ') {
-                print(" ")
-                sc++
-            }
-        }
-
-        println("${font.noColorCode}\nEND")
-
-        println(font.toColorCode(0xF_EEC))
 
         frameBuffer = FrameBuffer(Pixmap.Format.RGBA8888, TEXW, TEXH, true)
 
@@ -159,6 +76,8 @@ class FontTestGDX : Game() {
     var tex: Texture? = null
     var screenshotExported = false
 
+    private val backcol = Color(.141f, .141f, .141f, 1f)
+
     override fun render() {
 
         if (tex == null) {
@@ -168,14 +87,18 @@ class FontTestGDX : Game() {
             Gdx.gl.glClear(GL20.GL_COLOR_BUFFER_BIT)
             Gdx.gl.glEnable(GL20.GL_TEXTURE_2D)
             Gdx.gl.glEnable(GL20.GL_BLEND)
-            Gdx.gl.glBlendFunc(GL20.GL_SRC_ALPHA, GL20.GL_ONE_MINUS_SRC_ALPHA)
+            batch.setBlendFunctionSeparate(GL20.GL_SRC_ALPHA, GL20.GL_ONE_MINUS_SRC_ALPHA, GL20.GL_ONE, GL20.GL_ONE_MINUS_SRC_ALPHA) // for not premultiplied textures
 
             batch.projectionMatrix = camera.combined
             batch.begin()
 
-            batch.color = Color(0xeeeeeeff.toInt())
+            batch.color = backcol
+            batch.draw(faketex, 0f, 0f, TEXW.toFloat(), TEXH.toFloat())
+            batch.flush()
+
+            batch.color = Color.WHITE
             inputText.forEachIndexed { index, s ->
-                font.draw(batch, s, 10f, TEXH - 30f - index * font.lineHeight)
+                font.draw(batch, s, 10f, TEXH - 30f - index * lineHeight)
             }
 
             batch.end()
@@ -185,7 +108,8 @@ class FontTestGDX : Game() {
             if (!screenshotExported) {
                 val pixmap = ScreenUtils.getFrameBufferPixmap(0, 0, frameBuffer.width, frameBuffer.height)
 
-                PixmapIO.writePNG(Gdx.files.local("demo.PNG"), pixmap)
+                PixmapIO.writePNG(Gdx.files.local(outimageName), pixmap)
+//                writeTGA(Gdx.files.local(outimageName), pixmap, false)
                 pixmap.dispose()
 
                 screenshotExported = true
@@ -199,9 +123,17 @@ class FontTestGDX : Game() {
             tex = frameBuffer.colorBufferTexture
         }
 
+
+        Gdx.gl.glClearColor(.141f, .141f, .141f, 1f)
+        Gdx.gl.glClear(GL20.GL_COLOR_BUFFER_BIT)
+        Gdx.gl.glEnable(GL20.GL_TEXTURE_2D)
+        Gdx.gl.glEnable(GL20.GL_BLEND)
+        batch.setBlendFunctionSeparate(GL20.GL_SRC_ALPHA, GL20.GL_ONE_MINUS_SRC_ALPHA, GL20.GL_ONE, GL20.GL_ONE_MINUS_SRC_ALPHA) // for not premultiplied textures
+
+
         batch.begin()
         batch.color = Color.WHITE
-        batch.draw(tex, 0f, (TEXH.toFloat()/appConfig.height)*TEXH - scrollOffsetY, TEXW.toFloat(), -(TEXH.toFloat() / appConfig.height) * TEXH.toFloat())
+        batch.draw(tex, 0f, (TEXH.toFloat()/HEIGHT)*TEXH - scrollOffsetY, TEXW.toFloat(), -(TEXH.toFloat() / HEIGHT) * TEXH.toFloat())
 
 
         batch.end()
@@ -218,22 +150,23 @@ class FontTestGDX : Game() {
 
     override fun dispose() {
         font.dispose()
+        faketex.dispose()
     }
 
     fun scrollAdd(x: Int = 1) {
-        scrollOffsetY -= (TEXH.toFloat() / appConfig.height) * 20f * x
+        scrollOffsetY -= (TEXH.toFloat() / HEIGHT) * lineHeight * x
     }
 
     fun scrollSub(x: Int = 1) {
-        scrollOffsetY += (TEXH.toFloat() / appConfig.height) * 20f * x
+        scrollOffsetY += (TEXH.toFloat() / HEIGHT) * lineHeight * x
     }
 
     class Navigator(val main: FontTestGDX) : InputAdapter() {
-        override fun scrolled(amount: Int): Boolean {
+        override fun scrolled(amountX: Float, amountY: Float): Boolean {
-            if (amount >= 0)
+            if (amountY >= 0)
-                main.scrollSub(amount)
+                main.scrollSub(amountY.toInt())
             else
-                main.scrollAdd(-amount)
+                main.scrollAdd(-amountY.toInt())
 
             return true
         }
@@ -247,19 +180,106 @@ class FontTestGDX : Game() {
             return true
         }
     }
+
+
+    @Throws(IOException::class)
+    private fun writeTGA(file: FileHandle, pixmap: Pixmap, flipY: Boolean) {
+        val output = file.write(false)
+        try {
+            _writeTGA(output, pixmap, true, flipY)
+        } finally {
+            StreamUtils.closeQuietly(output)
+        }
+    }
+
+    @Throws(IOException::class)
+    private fun _writeTGA(out: OutputStream, pixmap: Pixmap, verbatim: Boolean, flipY: Boolean) {
+        val width: ByteArray =  toShortLittle(pixmap.width)
+        val height: ByteArray = toShortLittle(pixmap.height)
+        val zero: ByteArray =   toShortLittle(0)
+        out.write(0) // ID field: empty
+        out.write(0) // no colour map, but should be ignored anyway as it being unmapped RGB
+        out.write(2) // 2 means unmapped RGB
+        out.write(byteArrayOf(0, 0, 0, 0, 0)) // color map spec: empty
+        out.write(zero) // x origin: 0
+        out.write(zero) // y origin: 0
+        out.write(width) // width
+        out.write(height) // height
+        out.write(32) // image pixel size: we're writing 32-bit image (8bpp BGRA)
+        out.write(8) // image descriptor: dunno, Photoshop writes 8 in there
+
+        // write actual image data
+        // since we're following Photoshop's conventional header, we also follows Photoshop's
+        // TGA saving scheme, that is:
+        //     1. BGRA order
+        //     2. Y-Flipped but not X-Flipped
+        if (!flipY) {
+            for (y in pixmap.height - 1 downTo 0) {
+                for (x in 0 until pixmap.width) {
+                    writeTga(x, y, verbatim, pixmap, out)
+                }
+            }
+        } else {
+            for (y in 0 until pixmap.height) {
+                for (x in 0 until pixmap.width) {
+                    writeTga(x, y, verbatim, pixmap, out)
+                }
+            }
+        }
+
+
+        // write footer
+        // 00 00 00 00 00 00 00 00 TRUEVISION-XFILE 2E 00
+        out.write(byteArrayOf(0, 0, 0, 0, 0, 0, 0, 0))
+        if (verbatim) out.write("TRUEVISION-XFILE".toByteArray()) else out.write("TerrarumHappyTGA".toByteArray())
+        out.write(byteArrayOf(0x2E, 0))
+        out.flush()
+        out.close()
+    }
+
+    private val zeroalpha = byteArrayOf(0, 0, 0, 0)
+    @Throws(IOException::class)
+    private fun writeTga(x: Int, y: Int, verbatim: Boolean, pixmap: Pixmap, out: OutputStream) {
+        val color = pixmap.getPixel(x, y)
+
+        // if alpha == 0, write special value instead
+        if (verbatim && color and 0xFF == 0) {
+            out.write(zeroalpha)
+        } else {
+            out.write(RGBAtoBGRA(color))
+        }
+    }
+
+    private fun toShortLittle(i: Int): ByteArray {
+        return byteArrayOf(
+            (i and 0xFF).toByte(),
+            (i ushr 8 and 0xFF).toByte()
+        )
+    }
+
+    private fun RGBAtoBGRA(rgba: Int): ByteArray {
+        return byteArrayOf(
+            (rgba ushr 8 and 0xFF).toByte(),
+            (rgba ushr 16 and 0xFF).toByte(),
+            (rgba ushr 24 and 0xFF).toByte(),
+            (rgba and 0xFF).toByte()
+        )
+    }
 }
 
-lateinit var appConfig: LwjglApplicationConfiguration
+lateinit var appConfig: Lwjgl3ApplicationConfiguration
 const val TEXW = 874
-const val TEXH = 2060
+const val TEXH = 24 * 130
+
+const val WIDTH = TEXW
+const val HEIGHT = 768
 
 fun main(args: Array<String>) {
-    appConfig = LwjglApplicationConfiguration()
+    appConfig = Lwjgl3ApplicationConfiguration()
-    appConfig.vSyncEnabled = false
+    appConfig.useVsync(false)
-    appConfig.resizable = false//true;
+    appConfig.setResizable(false)
-    appConfig.width = TEXW
+    appConfig.setWindowedMode(WIDTH, HEIGHT)
-    appConfig.height = 768
+    appConfig.setTitle("Terrarum Sans Bitmap Test")
-    appConfig.title = "Terrarum Sans Bitmap Test (GDX)"
     
-    LwjglApplication(FontTestGDX(), appConfig)
+    Lwjgl3Application(FontTestGDX(), appConfig)
 }

FontTestGDX/src/TypewriterGDX.kt

@@ -0,0 +1,247 @@
+import com.badlogic.gdx.Game
+import com.badlogic.gdx.Gdx
+import com.badlogic.gdx.Input
+import com.badlogic.gdx.InputAdapter
+import com.badlogic.gdx.audio.AudioDevice
+import com.badlogic.gdx.audio.Sound
+import com.badlogic.gdx.backends.lwjgl3.Lwjgl3Application
+import com.badlogic.gdx.backends.lwjgl3.Lwjgl3ApplicationConfiguration
+import com.badlogic.gdx.graphics.Color
+import com.badlogic.gdx.graphics.GL20
+import com.badlogic.gdx.graphics.OrthographicCamera
+import com.badlogic.gdx.graphics.g2d.SpriteBatch
+import com.badlogic.gdx.utils.GdxRuntimeException
+import net.torvald.terrarum.gamecontroller.InputStrober
+import net.torvald.terrarumsansbitmap.gdx.CodepointSequence
+import net.torvald.terrarumtypewriterbitmap.gdx.TerrarumTypewriterBitmap
+import java.io.StringReader
+import kotlin.math.roundToInt
+
+/**
+ * Created by minjaesong on 2021-11-05.
+ */
+class TypewriterGDX(val width: Int, val height: Int, val cols: Int, val hmargin: Int, val vmargin: Int) : Game() {
+
+    lateinit var font: TerrarumTypewriterBitmap
+    lateinit var batch: SpriteBatch
+//    lateinit var frameBuffer: FrameBuffer
+    lateinit var camera: OrthographicCamera
+
+    lateinit var inputStrober: InputStrober
+
+    lateinit var sndMovingkey: Sound
+    lateinit var sndDeadkey: Sound
+    lateinit var sndShiftin: Sound
+    lateinit var sndShiftout: Sound
+    lateinit var sndSpace: Sound
+    lateinit var sndCRs: Array<Sound>
+    lateinit var sndLF: Sound
+
+    override fun create() {
+        font = TerrarumTypewriterBitmap(
+            "./assets/typewriter",
+            StringReader(
+                """ko_kr_3set-390_typewriter,typewriter_ko_3set-390.tga,16
+                |en_intl_qwerty_typewriter,typewriter_intl_qwerty.tga,0
+            """.trimMargin()
+            ),
+            true, false, 256, true
+        )
+
+        batch = SpriteBatch()
+
+//        frameBuffer = FrameBuffer(Pixmap.Format.RGBA8888, TEXW, TEXH, true)
+
+        camera = OrthographicCamera(width.toFloat(), height.toFloat())
+        camera.translate(width.div(2f), 0f)
+        camera.setToOrtho(true, width.toFloat(), height.toFloat())
+        camera.update()
+
+
+        inputStrober = InputStrober(this)
+
+        try {
+            sndMovingkey = Gdx.audio.newSound(Gdx.files.internal("assets/typewriter/audio/movingkey.wav"))
+            sndDeadkey = Gdx.audio.newSound(Gdx.files.internal("assets/typewriter/audio/deadkey.wav"))
+            sndShiftin = Gdx.audio.newSound(Gdx.files.internal("assets/typewriter/audio/shiftin.wav"))
+            sndShiftout = Gdx.audio.newSound(Gdx.files.internal("assets/typewriter/audio/shiftout.wav"))
+            sndSpace = Gdx.audio.newSound(Gdx.files.internal("assets/typewriter/audio/space.wav"))
+
+            sndCRs = Array(6) {
+                Gdx.audio.newSound(Gdx.files.internal("assets/typewriter/audio/cr$it.wav"))
+            }
+
+            sndLF = Gdx.audio.newSound(Gdx.files.internal("assets/typewriter/audio/crlf.wav"))
+        }
+        catch (e: GdxRuntimeException) {
+            e.printStackTrace()
+        }
+    }
+
+    private val intro = listOf(
+        39,50,29, // kva (HANG_GONG)
+        42,31, // nc (HANG_SE)
+        74,48,51, // ;tw (HANG_BEOL)
+        62, // space
+        0x561F71, // shiftin
+        184,164,171,170, // >HON (ASC_3-90)
+        0x561F70, // shiftout
+        62, // space
+        74,48, // ;t (HANG_BEO)
+        43,12, // o5 (HANG_CYU)
+        38,48,51, // jtw (HANG_EOL)
+        0x561F71, // shiftin
+        164, // H (ASC_-)
+        0x561F70, // shiftout
+        75,34, // 'f (HANG_TA)
+        40,34, // lf (HANG_JA)
+        39,32,  // kd (HANG_GI)
+        Input.Keys.ENTER,Input.Keys.ENTER
+    )
+
+    private val textbuf: ArrayList<CodepointSequence> = arrayListOf(
+        CodepointSequence()
+    )
+
+    var keylayoutbase = 0xFA000
+    private val printableKeys = ((Input.Keys.NUM_0..Input.Keys.NUM_9) + (Input.Keys.A..Input.Keys.PERIOD) + 62 + (Input.Keys.BACKSPACE..Input.Keys.SLASH)).toHashSet()
+
+    var initDone = false
+    var initTimer = 0f
+    var initTypingCursor = 0
+    var keystrokeDelay = 0.08f
+
+    fun acceptKey(keycode: Int, force: Boolean = false) {
+        if (initDone || force) {
+//        println("[TypewriterGDX] Accepting key: $keycode")
+
+            val lowkeycode = keycode and 127
+
+            if (keycode == Input.Keys.ENTER) {
+                val tbufsize = textbuf.last().size.div(cols.toFloat()).times(6f).coerceIn(0f, 6f).roundToInt() // 0..6
+                textbuf.add(CodepointSequence())
+                if (tbufsize == 0) sndLF.play()
+                else sndCRs[tbufsize - 1].play()
+            } else if (printableKeys.contains(lowkeycode)) {
+                val cp = keycode + keylayoutbase
+                textbuf.last().add(cp)
+//            println("[TypewriterGDX] width: ${font.glyphProps[cp]}")
+
+                // play audio
+                val isDeadkey = font.glyphProps[cp]?.width == 0
+                if (isDeadkey) {
+                    sndDeadkey.play()
+                } else if (lowkeycode == Input.Keys.SPACE || lowkeycode == Input.Keys.BACKSPACE) {
+                    sndSpace.play()
+                } else {
+                    sndMovingkey.play()
+                }
+            } else if (lowkeycode == Input.Keys.SHIFT_LEFT || lowkeycode == Input.Keys.SHIFT_RIGHT) {
+                sndShiftin.play()
+            }
+        }
+    }
+
+    /**
+     * For Shift-out only
+     */
+    fun shiftOut() {
+        sndShiftout.play()
+    }
+
+
+    private val textCol = Color(0.1f,0.1f,0.1f,1f)
+    override fun render() {
+        Gdx.gl.glClearColor(0.97f,0.96f,0.95f,1f)
+        Gdx.gl.glClear(GL20.GL_COLOR_BUFFER_BIT)
+        Gdx.gl.glEnable(GL20.GL_TEXTURE_2D)
+        Gdx.gl.glEnable(GL20.GL_BLEND)
+        Gdx.gl.glBlendFuncSeparate(GL20.GL_SRC_ALPHA, GL20.GL_ONE_MINUS_SRC_ALPHA, GL20.GL_ONE, GL20.GL_ONE)
+
+        batch.projectionMatrix = camera.combined
+        batch.begin()
+
+        batch.color = textCol
+
+        try {
+            textbuf.forEachIndexed { index, s ->
+                font.draw(batch, s, hmargin.toFloat(), vmargin.toFloat() + 20 * index)
+            }
+        }
+        catch (e: ConcurrentModificationException) {}
+
+        batch.end()
+
+        if (!initDone) {
+            while (initTimer > keystrokeDelay) {
+                val keyToType = intro[initTypingCursor]
+
+                if (keyToType < 256) {
+                    acceptKey(keyToType, true)
+                }
+                else if (keyToType == 0x561F71) {
+                    acceptKey(Input.Keys.SHIFT_LEFT + 128, true)
+                }
+                else if (keyToType == 0x561F70) {
+                    shiftOut()
+                }
+                initTypingCursor += 1
+                initTimer -= keystrokeDelay
+
+                if (keyToType == Input.Keys.ENTER)
+                    initTimer -= 0.35f
+                else if (keyToType == 0x561F71)
+                    initTimer -= 0.15f
+                else if (keyToType == 0x561F70)
+                    initTimer -= 0.1f
+                else
+                    initTimer -= Math.random().toFloat() * 0.04f
+            }
+
+            initTimer += Gdx.graphics.deltaTime
+
+            if (initTypingCursor >= intro.size) {
+                initDone = true
+            }
+        }
+    }
+
+    override fun dispose() {
+        font.dispose()
+        batch.dispose()
+        inputStrober.dispose()
+        sndMovingkey.dispose()
+        sndDeadkey.dispose()
+        sndShiftin.dispose()
+        sndShiftout.dispose()
+        sndSpace.dispose()
+        sndCRs.forEach { it.dispose() }
+        sndLF.dispose()
+    }
+}
+
+class TypewriterInput(val main: TypewriterGDX) : InputAdapter() {
+
+    private var shiftIn = false
+
+    override fun keyDown(keycode: Int): Boolean {
+        // FIXME this shiftIn would not work at all...
+        shiftIn = (keycode == Input.Keys.SHIFT_LEFT || keycode == Input.Keys.SHIFT_RIGHT)
+        if (keycode < 128 && keycode != Input.Keys.SHIFT_LEFT && keycode != Input.Keys.SHIFT_RIGHT) {
+            main.acceptKey(shiftIn.toInt() * 128 + keycode)
+        }
+        return true
+    }
+
+    private fun Boolean.toInt() = if (this) 1 else 0
+}
+
+fun main(args: Array<String>) {
+    appConfig = Lwjgl3ApplicationConfiguration()
+    appConfig.useVsync(false)
+    appConfig.setResizable(false)
+    appConfig.setWindowedMode(534, 668)
+    appConfig.setTitle("Terrarum Typewriter Bitmap Test")
+
+    Lwjgl3Application(TypewriterGDX(534, 668, 64, 32, 24), appConfig)
+}

FontTestGDX/src/net/torvald/terrarum/gamecontroller/InputStrober.kt

@@ -0,0 +1,401 @@
+package net.torvald.terrarum.gamecontroller
+
+import TypewriterGDX
+import com.badlogic.gdx.Gdx
+import com.badlogic.gdx.Input
+
+/**
+ * Created by minjaesong on 2021-11-06.
+ */
+class InputStrober(val typewriter: TypewriterGDX) {
+
+    companion object {
+        const val KEY_DOWN = 0
+        const val KEY_CHANGE = 1
+        const val N_KEY_ROLLOVER = 8
+    }
+
+    var KEYBOARD_DELAYS = longArrayOf(0L,250000000L,0L,25000000L,0L)
+    private var stroboTime = 0L
+    private var stroboStatus = 0
+    private var repeatCount = 0
+    private var oldKeys = IntArray(N_KEY_ROLLOVER) { 0 }
+    /** always Low Layer */
+//        private var keymap = IME.getLowLayerByName(App.getConfigString("basekeyboardlayout"))
+
+    private val thread = Thread { while (!Thread.interrupted()) {
+        if (Gdx.input != null) withKeyboardEvent()
+    } }
+
+    init {
+//        println("InputStrobe start")
+        thread.start()
+    }
+
+    fun dispose() {
+        thread.interrupt()
+    }
+
+    fun resetKeyboardStrobo() {
+        stroboStatus = 0
+        repeatCount = 0
+    }
+
+    // code proudly stolen from tsvm's TVDOS.SYS
+    private fun withKeyboardEvent() {
+        val keys = strobeKeys()
+        var keyChanged = !arrayEq(keys, oldKeys)
+        val keyDiff = arrayDiff(keys, oldKeys)
+
+//        println("Key strobed: ${keys.joinToString()}")
+
+        if (stroboStatus % 2 == 0 && (keys[0] != 0 || oldKeys[0] != 0)) {
+            stroboStatus += 1
+            stroboTime = System.nanoTime()
+            repeatCount += 1
+
+            val shiftin = keys.contains(Input.Keys.SHIFT_LEFT) || keys.contains(Input.Keys.SHIFT_RIGHT)
+            val newKeysym0 = keysToStr(keyDiff)
+
+            val newKeysym = if (newKeysym0 == null) null
+            else if (shiftin && newKeysym0.size > 1 && newKeysym0[1]?.isNotBlank() == true) newKeysym0[1]
+            else newKeysym0[0]
+
+            val headKeyCode = (if (keyDiff.size < 1) keys[0] else keyDiff[0]).and(127) or (if (shiftin) 128 else 0)
+
+            if (repeatCount == 1) {
+                if (!keyChanged) {
+//                    println("KEY_DOWN '$keysym' ($headKeyCode) $repeatCount; ${keys.joinToString()}")
+//                App.inputStrobed(TerrarumKeyboardEvent(KEY_DOWN, keysym, headKeyCode, repeatCount, keys))
+                    typewriter.acceptKey(headKeyCode)
+                } else if (newKeysym != null) {
+//                    println("KEY_DOWC '$newKeysym' ($headKeyCode) $repeatCount; ${keys.joinToString()}")
+//                App.inputStrobed(TerrarumKeyboardEvent(KEY_DOWN, newKeysym, headKeyCode, repeatCount, keys))
+                    typewriter.acceptKey(headKeyCode)
+                }
+
+
+//                println("shiftin=${shiftin} oldkeys=${oldKeys.joinToString()}")
+
+                if (!shiftin && (oldKeys.contains(Input.Keys.SHIFT_LEFT) || oldKeys.contains(Input.Keys.SHIFT_RIGHT))) {
+                    typewriter.shiftOut()
+                }
+            }
+
+            oldKeys = keys // don't put this outside of if-cascade
+        }
+        else if (keyChanged || keys[0] == 0) {
+            stroboStatus = 0
+            repeatCount = 0
+
+            if (keys[0] == 0) keyChanged = false
+        }
+        else if (stroboStatus % 2 == 1 && System.nanoTime() - stroboTime < KEYBOARD_DELAYS[stroboStatus]) {
+            Thread.sleep(1L)
+        }
+        else {
+            stroboStatus += 1
+            if (stroboStatus >= 4)
+                stroboStatus = 2
+        }
+    }
+
+    private fun keysToStr(keys: IntArray): Array<String?>? {
+        if (keys.isEmpty()) return null
+        val headkey = keys[0]
+        return keymap[headkey]
+    }
+
+    private fun strobeKeys(): IntArray {
+        var keysPushed = 0
+        val keyEventBuffers = IntArray(N_KEY_ROLLOVER) { 0 }
+        for (k in 1..254) {
+            if (Gdx.input.isKeyPressed(k)) {
+                keyEventBuffers[keysPushed] = k
+                keysPushed += 1
+            }
+
+            if (keysPushed >= N_KEY_ROLLOVER) break
+        }
+        return keyEventBuffers
+    }
+
+    private fun arrayEq(a: IntArray, b: IntArray): Boolean {
+        for (i in a.indices) {
+            if (a[i] != b.getOrNull(i)) return false
+        }
+        return true
+    }
+
+    private fun arrayDiff(a: IntArray, b: IntArray): IntArray {
+        return a.filter { !b.contains(it) }.toIntArray()
+    }
+
+
+    private val keymap = arrayOf(arrayOf<String?>(""),arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>("<HOME>"),
+        arrayOf<String?>(null),
+        arrayOf<String?>("<CALL>"),
+        arrayOf<String?>("<ENDCALL>"),
+        arrayOf<String?>("0",")"),
+        arrayOf<String?>("1","!"),
+        arrayOf<String?>("2","@"),
+        arrayOf<String?>("3","#"),
+        arrayOf<String?>("4","$"),
+        arrayOf<String?>("5","%"),
+        arrayOf<String?>("6","^"),
+        arrayOf<String?>("7","&"),
+        arrayOf<String?>("8","*"),
+        arrayOf<String?>("9","("),
+        arrayOf<String?>("*"),
+        arrayOf<String?>("#"),
+        arrayOf<String?>("<UP>"),
+        arrayOf<String?>("<DOWN>"),
+        arrayOf<String?>("<LEFT>"),
+        arrayOf<String?>("<RIGHT>"),
+        arrayOf<String?>("<CENTER>"),
+        arrayOf<String?>("<VOL_UP>"),
+        arrayOf<String?>("<VOL_DOWN>"),
+        arrayOf<String?>("<POWER>"),
+        arrayOf<String?>("<CAMERA>"),
+        arrayOf<String?>("<CLEAR>"),
+        arrayOf<String?>("a","A"),
+        arrayOf<String?>("b","B"),
+        arrayOf<String?>("c","C"),
+        arrayOf<String?>("d","D"),
+        arrayOf<String?>("e","E"),
+        arrayOf<String?>("f","F"),
+        arrayOf<String?>("g","G"),
+        arrayOf<String?>("h","H"),
+        arrayOf<String?>("i","I"),
+        arrayOf<String?>("j","J"),
+        arrayOf<String?>("k","K"),
+        arrayOf<String?>("l","L"),
+        arrayOf<String?>("m","M"),
+        arrayOf<String?>("n","N"),
+        arrayOf<String?>("o","O"),
+        arrayOf<String?>("p","P"),
+        arrayOf<String?>("q","Q"),
+        arrayOf<String?>("r","R"),
+        arrayOf<String?>("s","S"),
+        arrayOf<String?>("t","T"),
+        arrayOf<String?>("u","U"),
+        arrayOf<String?>("v","V"),
+        arrayOf<String?>("w","W"),
+        arrayOf<String?>("x","X"),
+        arrayOf<String?>("y","Y"),
+        arrayOf<String?>("z","Z"),
+        arrayOf<String?>(",","<"),
+        arrayOf<String?>(".",">"),
+        arrayOf<String?>("<ALT_L>"),
+        arrayOf<String?>("<ALT_R>"),
+        arrayOf<String?>("<SHIFT_L>"),
+        arrayOf<String?>("<SHIFT_R>"),
+        arrayOf<String?>("<TAB>"),
+        arrayOf<String?>(" "),
+        arrayOf<String?>("<SYM>"),
+        arrayOf<String?>("<EXPLORER>"),
+        arrayOf<String?>("<ENVELOPE>"),
+        arrayOf<String?>("\n"),
+        arrayOf<String?>("\u0008"),
+        arrayOf<String?>("`","~"),
+        arrayOf<String?>("-","_"),
+        arrayOf<String?>("=","+"),
+        arrayOf<String?>("arrayOf<String?>(","{"),
+        arrayOf<String?>(")","}"),
+        arrayOf<String?>("\\","|"),
+        arrayOf<String?>(";",":"),
+        arrayOf<String?>("'","\""),
+        arrayOf<String?>("/","?"),
+        arrayOf<String?>("<AT>"),
+        arrayOf<String?>("<NUM_LOCK>"),
+        arrayOf<String?>("<HEADSETHOOK>"),
+        arrayOf<String?>("<FOCUS>"),
+        arrayOf<String?>("+"),
+        arrayOf<String?>("<MENU>"),
+        arrayOf<String?>("<NOTIFICATION>"),
+        arrayOf<String?>("<SEARCH>"),
+        arrayOf<String?>("<PLAY_PAUSE>"),
+        arrayOf<String?>("<STOP>"),
+        arrayOf<String?>("<NEXT>"),
+        arrayOf<String?>("<PREV>"),
+        arrayOf<String?>("<REW>"),
+        arrayOf<String?>("<FFWD>"),
+        arrayOf<String?>("<MUTE>"),
+        arrayOf<String?>("<PAGE_UP>"),
+        arrayOf<String?>("<PAGE_DOWN>"),
+        arrayOf<String?>("<PICTSYMBOLS>"),
+        arrayOf<String?>("<SW:>TCH_CHARSET>"),
+        arrayOf<String?>("<:A:>"),
+        arrayOf<String?>("<:B:>"),
+        arrayOf<String?>("<:C:>"),
+        arrayOf<String?>("<:X:>"),
+        arrayOf<String?>("<:Y:>"),
+        arrayOf<String?>("<:Z:>"),
+        arrayOf<String?>("<:L1:>"),
+        arrayOf<String?>("<:R1:>"),
+        arrayOf<String?>("<:L2:>"),
+        arrayOf<String?>("<:R2:>"),
+        arrayOf<String?>("<:TL:>"),
+        arrayOf<String?>("<:TR:>"),
+        arrayOf<String?>("<:START:>"),
+        arrayOf<String?>("<:SELECT:>"),
+        arrayOf<String?>("<:MODE:>"),
+        arrayOf<String?>("<ESC>"),
+        arrayOf<String?>("<DEL>"),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>("<CAPS_LOCK>"),
+        arrayOf<String?>("<SCROLL_LOCK>"),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>("<PRINT_SCREEN_SYS_RQ>"),
+        arrayOf<String?>("<PAUSE_BREAK>"),
+        arrayOf<String?>(null),
+        arrayOf<String?>("<END>"),
+        arrayOf<String?>("<INSERT>"),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>("<CTRL_L>"),
+        arrayOf<String?>("<CTRL_R>"),
+        arrayOf<String?>("<F1>"),
+        arrayOf<String?>("<F2>"),
+        arrayOf<String?>("<F3>"),
+        arrayOf<String?>("<F4>"),
+        arrayOf<String?>("<F5>"),
+        arrayOf<String?>("<F6>"),
+        arrayOf<String?>("<F7>"),
+        arrayOf<String?>("<F8>"),
+        arrayOf<String?>("<F9>"),
+        arrayOf<String?>("<F10>"),
+        arrayOf<String?>("<F11>"),
+        arrayOf<String?>("<F12>"),
+        arrayOf<String?>("<NUM_LOCK>"),
+        arrayOf<String?>("0"),
+        arrayOf<String?>("1"),
+        arrayOf<String?>("2"),
+        arrayOf<String?>("3"),
+        arrayOf<String?>("4"),
+        arrayOf<String?>("5"),
+        arrayOf<String?>("6"),
+        arrayOf<String?>("7"),
+        arrayOf<String?>("8"),
+        arrayOf<String?>("9"),
+        arrayOf<String?>("/"),
+        arrayOf<String?>("*"),
+        arrayOf<String?>("-"),
+        arrayOf<String?>("+"),
+        arrayOf<String?>("."),
+        arrayOf<String?>("."),
+        arrayOf<String?>("\n"),
+        arrayOf<String?>("="),
+        arrayOf<String?>("("),
+        arrayOf<String?>(")"),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>(null),
+        arrayOf<String?>("<:CIRCLE:>")
+    )
+
+}
+
+
+data class TerrarumKeyboardEvent(
+    val type: Int,
+    val character: String?, // representative key symbol
+    val headkey: Int, // representative keycode
+    val repeatCount: Int,
+    val keycodes: IntArray
+)

LICENSE.md

@@ -1,6 +1,4 @@
-Terrarum Sans Bitmap
+Copyright (c) 2017-2022 see CONTRIBUTORS.txt
-
-Copyright (c) 2017-2018 Minjae Song (Torvald) and the contributors
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -1,17 +1,18 @@
 # Terrarum Sans Bitmap
 
-![Font sample](demo.PNG)
+![Font sample — necessary information in this image is also provided below.](demo.PNG)
 
-This font is a bitmap font used in [my game project called Terrarum](https://gitlab.com/minjaesong/terrarum) (hence the name). The font supports more than 90 % of european languages, as well as Chinese, Japanese and Korean. More technical side, it supports Latin-1 Supplement, Latin Ext-A, Latin Ext-B, IPA Extension (required by some languages), Greek, Cyrillic (+ Bulgarian, Serbian variants) and the supplement, Armenian, Thai (beta version), Georgian, Unicode Punctuations, CJK Punctuations, Kana, Chinese (limited to Unihan and Ext-A), Hangul (all 11 172 possible syllables) and Fullwidth forms.
+This font is a bitmap font used in [my game project called Terrarum](https://github.com/minjaesong/Terrarum) (hence the name). The font supports more than 90 % of european languages, as well as Chinese, Japanese and Korean. More technical side, it supports Latin-1 Supplement, Latin Ext-A/B/C, IPA Extension, Greek, Cyrillic (+ Bulgarian, Serbian variants) and the supplement, Armenian, Devanagari, Bengali, Thai, Georgian (Mkhedruli and Mtavruli), General Punctuations, Super/Subscrips, CJK Punctuations, All of the Kana (minus the Hentaigana), Chinese (limited to Unihan and Ext-A), Hangul (every possible syllables) and Fullwidth forms.
 
-The JAR package is meant to be used with Slick2d (extends ```Font``` class) and LibGDX (extends ```BitmapFont``` class). If you are not using the framework, please refer to the __Font metrics__ section to implement the font metrics correctly on your system.
+The JAR package is meant to be used with LibGDX (extends ```BitmapFont``` class). If you are not using the framework, please refer to the __Font metrics__ section to implement the font metrics correctly on your system.
 
 The issue page is open. If you have some issues to submit, or have a question, please leave it on the page.
 
 #### Little notes
-- To display Bulgarian/Serbian variants, you need special Control Characters. (GameFontBase.charsetOverrideBulgarian -- U+FFFF9; GameFontBase.charsetOverrideSerbian -- U+FFFFA)
+- To display Bulgarian/Serbian variants, you need special Control Characters. (GameFontBase.charsetOverrideBulgarian -- U+FFFC1; GameFontBase.charsetOverrideSerbian -- U+FFFC2)
-- All Han characters are in Chinese variant, no other variants are to be supported as most Chinese, Japanese and Korean can understand other's variant and to be honest, we don't bother anyway.
+- All Han characters are in Chinese variant, no other variants are to be supported as most Chinese, Japanese and Korean people can understand other's variant and as long as I can, we don't bother anyway.
-- Indian script in general is not perfect: this font will never do the proper ligatures (I can't draw all the 1 224 possible combinations). Hopefully it's still be able to understand without them.
+- Indian script in general is not perfect: right now this font will never do the proper ligatures (I can't draw all the 1 224 possible combinations). Hopefully it's still be able to understand without them.
+- Slick2d versions are now unsupported. I couldn't extend myself to work on both versions, but I'm still welcome to merge your pull requests.
 
 ### Design Goals
 
@@ -20,6 +21,9 @@ The issue page is open. If you have some issues to submit, or have a question, p
     - Combininig with the sans-serif, this stands for **no over-simplification**
 - Condensed capitals for efficient space usage
 
+## Download
+
+- Go ahead to the [release tab](https://github.com/minjaesong/Terrarum-sans-bitmap/releases), and download the most recent version. It is **not** advised to use the .jar found within the repository, they're experimental builds I use during the development, and may contain bugs like leaking memory.
 
 ## Using on your game
 
@@ -68,7 +72,7 @@ On your code (Java):
     }
 
 
-### Using on Slick2d
+### Using on Slick2d (legacy version only)
 
 On your code (Kotlin):
 
@@ -126,4 +130,4 @@ Please refer to [CONTRIBUTING.md](https://github.com/minjaesong/Terrarum-sans-bi
 
 Thanks to kind people of [/r/Typography](https://www.reddit.com/r/typography/) for amazing feedbacks.
 
-CJK Ideographs are powered by [WenQuanYi Font](http://wenq.org/wqy2/index.cgi?BitmapSong). The font is distributed under the GNU GPL version 2. Although, in some countries including where I'm based on, the shapes of typefaces are not copyrightable (the program codes—e.g. TTF—do), we would like to give a credit for the font and the people behind it.
+CJK Ideographs are powered by [WenQuanYi Font](http://wenq.org/wqy2/index.cgi?BitmapSong). The font is distributed under the GNU GPL version 2. Although the shapes of typefaces are not copyrightable (the program codes—e.g. TTF—do), we would like to give a credit for the font and the people behind it.

demotext.txt

@@ -3,16 +3,17 @@
 
 There are many bitmap fonts on the internet. You care for the multilingual support, but alas!
 most of them do not support your language, vector fonts take too much time to load, and even
-then their legibility suffers because fuck built-in antialias.
+then their legibility suffers because screw built-in antialias.
 
-You somehow found a multilingual one, and it makes your game look like an old computer, and you say:
+You somehow found a multilingual one, and it makes your text as if they came straight from an old
+computer terminal, and you say:
 
 “Well, better than nothing… no, it’s ugly.”
 
-You speak japanese and you wish to support it, but then このクソなfont only goot for displaying
+You speak Japanese and wish to support it, but then このクソなfont only good for displaying
-Japanese, it's not even multilingual, and their English look uncanny and inconsistent as hell.
+Japanese, it’s not even truly multilingual, and their English look uncanny and inconsistent.
 
-Eventually you just mix different fonts together, and the results were always infuriating.
+Eventually you just mix different fonts together, and the results were always mildly infuriating.
 
 No more suffering. This font has everything you need.
 
@@ -26,40 +27,45 @@ How multilingual? Real multilingual!
     􏻬գրիչս վայր դրի, վեր կացա և պատրաստվում էի, որ քնեմ, երբ հանկարծ դռանս զանգակը հնչեց􀀀
     􏻬ՄՇԱԿԻՉ ԿԱՄ ԿԵՆՏՐՈՆԱԿԱՆ ՄՇԱԿԻՉ ՀԱՆԳՈՒՅՑԸ ՀԱՆԴԻՍԱՆՈՒՄ Է ՀԱՄԱԿԱՐԳՉԻ ՍԱՐՔԱՎՈՐՈՒՄՆԵՐԻՑ􀀀
     􏻬Zəfər, jaketini də papağını da götür, bu axşam hava çox soyuq olacaq􀀀
-    􏻬󿿹Под южно дърво, цъфтящо в синьо, бягаше малко пухкаво зайче󿿸􀀀
+    􏻬আমি কাঁচ খেতে পারি, তাতে আমার কোনো ক্ষতি হয় না। 􀀀
+    􏻬󿿁Под южно дърво, цъфтящо в синьо, бягаше малко пухкаво зайче󿿀􀀀
     􏻬ᎠᏍᎦᏯᎡᎦᎢᎾᎨᎢᎣᏍᏓᎤᎩᏍᏗᎥᎴᏓᎯᎲᎢᏔᎵᏕᎦᏟᏗᏖᎸᎳᏗᏗᎧᎵᎢᏘᎴᎩ ᏙᏱᏗᏜᏫᏗᏣᏚᎦᏫᏛᏄᏓᎦᏝᏃᎠᎾᏗᎭᏞᎦᎯᎦᏘᏓᏠᎨᏏᏕᏡᎬᏢᏓᏥᏩᏝᎡᎢᎪᎢ􀀀
     􏻬ᎠᎦᏂᏗᎮᎢᎫᎩᎬᏩᎴᎢᎠᏆᏅᏛᎫᏊᎾᎥᎠᏁᏙᎲᏐᏈᎵᎤᎩᎸᏓᏭᎷᏤᎢᏏᏉᏯᏌᏊ ᎤᏂᏋᎢᏡᎬᎢᎰᏩᎬᏤᎵᏍᏗᏱᎩᎱᎱᎤᎩᎴᎢᏦᎢᎠᏂᏧᏣᏨᎦᏥᎪᎥᏌᏊᎤᎶᏒᎢᎢᏡᎬᎢ􀀀
     􏻬ᎹᎦᎺᎵᏥᎻᎼᏏᎽᏗᏩᏂᎦᏘᎾᎿᎠᏁᎬᎢᏅᎩᎾᏂᎡᎢᏌᎶᎵᏎᎷᎠᏑᏍᏗᏪᎩ ᎠᎴ ᏬᏗᏲᏭᎾᏓᏍᏓᏴᏁᎢᎤᎦᏅᏮᏰᎵᏳᏂᎨᎢ􀀀
     􏻬Příliš žluťoučký kůň úpěl ďábelské ódy􀀀
     􏻬Quizdeltagerne spiste jordbær med fløde, mens cirkusklovnen Walther spillede på xylofon􀀀
     􏻬PACK MY BOX WITH FIVE DOZEN LIQUOR JUGS􀀀
+    􏻬hƿæt ƿe ᵹardena inᵹear ꝺaᵹum þeoꝺ cynninᵹa þꞃym ᵹeꝼꞃumon􀀀
     􏻬Victor jagt zwölf Boxkämpfer quer über den großen Sylter Deich    GROẞEN GROẞE􀀀
-    􏻬ζαφείρι δέξου πάγκαλο, βαθων ψυχης το σημα􀀀
+    􏻬ζαφείρι δέξου πάγκαλο, βαθῶν ψυχῆς τὸ σῆμα􀀀
     􏻬ΔΙΑΦΥΛΆΞΤΕ ΓΕΝΙΚΆ ΤΗ ΖΩΉ ΣΑΣ ΑΠΌ ΒΑΘΕΙΆ ΨΥΧΙΚΆ ΤΡΑΎΜΑΤΑ􀀀
     􏻬სწრაფი ყავისფერი მელა გადაახტა ზარმაც ძაღლს    ᲘᲜᲢᲔᲚ ᲞᲔᲜᲢᲘᲣᲛᲘ ᲛᲘᲙᲠᲝᲞᲠᲝᲪᲔᲡᲝᲠᲘ􀀀
     􏻬ऋषियों को सताने वाले दुष्ट राक्षसों के राजा रावण का सर्वनाश करने वाले विष्णुवतार भगवान श्रीराम अयोध्या के महाराज दशरथ के􀀀
     􏻬Kæmi ný öxi hér, ykist þjófum nú bæði víl og ádrepa􀀀
-    􏻬Ꝺꝼuaꞅcail Íoꞅa Úꞃṁac na hÓiᵹe Beannaiꞇe póꞃ Éaḃa aᵹus Áꝺaiṁ􀀀
+    􏻬Ċuaiġ bé ṁórṡáċ le dlúṫspád fíoꝛḟinn trí hata mo ḋea-ṗoꝛcáin ḃig􀀀
-    􏻬Ċuaiġ bé ṁórṡáċ le dlúṫspád fíorḟinn trí hata mo ḋea-ṗorcáin ḃig􀀀
     􏻬あめつちほしそら やまかはみねたに くもきりむろこけ ひといぬうへすゑ ゆわさるおふせよ えの𛀁をなれゐて􀀀
     􏻬トリナクコヱス ユメサマセ ミヨアケワタル ヒンカシヲ ソライロハエテ オキツヘニ ホフネムレヰヌ モヤノウチ􀀀
     􏻬田居に出で 菜摘むわれをぞ 君召すと 求食り追ひゆく 山城の 打酔へる子ら 藻葉干せよ え舟繋けぬ􀀀
-    􏻬정 참판 양반댁 규수 큰 교자 타고 혼례 치른 날    하얬다 도럄직한 퀡봹퉪헰􀀀
+    􏻬정 참판 양반댁 규수 큰 교자 타고 혼례 치른 날    하얬다 도럄직한 퀡봹퉪헰ꥸᅦퟗꥸᅦퟗᄋힳᆫㅗㅜㅑㄷ􀀀
     􏻬Četri psihi faķīri vēlu vakarā zāģēja guļbūvei durvis, fonā šņācot mežam􀀀
     􏻬Įlinkdama fechtuotojo špaga sublykčiojusi pragręžė apvalų arbūzą􀀀
     􏻬Ѕидарски пејзаж: шугав билмез со чудење џвака ќофте и кељ на туѓ цех􀀀
     􏻬Щётканы фермд пийшин цувъя. Бөгж зогсч хэльюү􀀀
     􏻬Pchnąć w tę łódź jeża lub ośm skrzyń fig􀀀
-    􏻬कः खगौघाङचिच्छौजा झाञ्ज्ञोऽटौठीडडण्ढणः। तथोदधीन् पफर्बाभीर्मयोऽरिल्वाशिषां सहः॥􀀀
     􏻬Înjurând pițigăiat, zoofobul comandă vexat whisky și tequila􀀀
     􏻬Широкая электрификация южных губерний даст мощный толчок подъёму сельского хозяйства􀀀
-    􏻬󿿺Ајшо, лепото и чежњо, за љубав срца мога дођи у Хаџиће на кафу󿿸􀀀
+    􏻬अद्वैतामृवर्षिणीं भगवतीमष्टादशाध्यायिनीम् अम्ब त्वामनुसन्दधामि भगवद्गीते भवद्वेषिणीम् ॥􀀀
+    􏻬󿿂Ајшо, лепото и чежњо, за љубав срца мога дођи у Хаџиће на кафу󿿀􀀀
+    􏻬ᮙᮛᮔᮨᮂᮔ ᮓᮤᮘᮨᮛᮨ ᮃᮊᮜ᮪ ᮏᮩᮀ ᮠᮒᮨ ᮔᮥᮛᮔᮤ, ᮎᮙ᮪ᮕᮥᮁ-ᮌᮅᮜ᮪ ᮏᮩᮀ ᮞᮞᮙᮔ ᮃᮚ ᮓᮤᮔ ᮞᮥᮙᮔᮨᮒ᮪ ᮓᮥᮓᮥᮜᮥᮛᮔ᮪􀀀
     􏻬Jovencillo emponzoñado de whisky: ¡qué figurota exhibe!􀀀
+    􏻬எழுத்து வடிவங்களுக்கு வார்த்தைகள் மற்றும் வாக்கியங்கள் போலவே தொனி, ஒலி பண்பு, தன்மை உண்டு􀀀
     􏻬นายสังฆภัณฑ์ เฮงพิทักษ์ฝั่ง ผู้เฒ่าซึ่งมีอาชีพเป็นฅนขายฃวด ถูกตำรวจปฏิบัติการจับฟ้องศาล ฐานลักนาฬิกาคุณหญิงฉัตรชฎา ฌานสมาธิ􀀀
     􏻬Pijamalı hasta yağız şoföre çabucak güvendi􀀀
     􏻬Жебракують філософи при ґанку церкви в Гадячі, ще й шатро їхнє п’яне знаємо􀀀
     􏻬Do bạch kim rất quý nên sẽ dùng để lắp vô xương􀀀
     􏻬日堀油告観観藤村抄海評業庁経賃室弁市。太撮収改売週法所何都慣次現。価紙一無三洋日話転手治稿載末替付致治。􀀀
+    􏻬[pʰnɣɬɥi.m͡ŋχɫʍɨnaɸ.cθʊɫɯ.ɹɨɫʏ͡ɛx.ɯ͡ɣaxɲaɣɫ.ɸtʰɑɣɴ]􀀀
+    􏻬⠑⠥⠊⠵⠀⠟⠫⠒⠵⠀⠓⠗⠎⠉⠂⠀⠠⠊⠗⠘⠍⠓⠎⠀⠨⠣⠩⠐⠥⠍⠑⠱⠀⠈⠪⠀⠨⠷⠎⠢⠈⠧⠀⠈⠏⠒⠐⠕⠝⠀⠕⠌⠎⠀⠊⠿⠊⠪⠶⠚⠊􀀀
 
 􏃯Features:􀀀
 
@@ -74,10 +80,10 @@ How multilingual? Real multilingual!
 
     􏼀ᚱ􏼐ᛂ􏼠ᚴ􏼰ᛋ􏽀ᛂ􏽐ᛋ􏽠ᛏ􏽰ᛋ􏾀ᚮ􏾐ᚾ􏾠ᛔ􏾰ᚢ􏿀ᛏ􏿐ᛚ􏿠ᚮ􏿰ᛋ􏻰᛬􏷰ᚱ􏳰ᛂ􏯰ᚴ􏫰ᛋ􏧰ᛋ􏣰ᚢ􏟰ᚼ􏛰ᚾ􏗰ᚢ􏓰ᛘ􏏰ᚢ􏋰ᛚ􏇰ᚾ􏃰ᛏ􏃱ᚮ􏃲᛬􏃳ᛏ􏃴ᚮ􏃵ᛋ􏃶ᛁ􏃷ᚮ􏃸ᚵ􏃹ᛂ􏃺ᚢ􏃻ᛏ􏃼ᚮ􏃽ᚱ􏃾ᛘ􏃿ᛔ􏃯ᚱ􏃟ᛂ􏃏ᚴ􏂿ᛋ􏂯ᛏ􏂟᛭􏂏ᛋ􏁿ᚢ􏁯ᚼ􏁟ᚾ􏁏ᚢ􏀿ᛋ􏀯ᛘ􏀟ᚮ􏀏ᛁ􏄏ᚵ􏈏ᚾ􏌏ᛁ􏐏ᛂ􏔏ᛏ􏘏ᚮ􏜏ᛑ􏠏᛭􏤏ᚵ􏨏ᛂ􏬏ᚢ􏰏ᛏ􏴏ᚮ􏸏ᚱ􀀀
 
-􎳌Colour-code that supports 65535 opaque or semi-transparent colours via 4 bit ARGB􀀀
+􎳌Colour-code that supports 4096 colours via 4 bit RGB􀀀
 
-    􏿿󿿹Гномът Доцьо приключи спящ в шейна за жаби󿿸 (Bulgarian)􀀀
+    􏿿󿿁Щиглецът се яде само пържен в юфка без чушки и хвойна󿿀 (Bulgarian)􀀀
-    􏿿󿿺Љубазни фењерџија чађавог лица хоће да ми покаже штос󿿸 (Serbian)􀀀
+    􏿿󿿂Љубазни фењерџија чађавог лица хоће да ми покаже штос󿿀 (Serbian)􀀀
     􏿿Разъяренный чтец эгоистично бьёт пятью жердями шустрого фехтовальщика (Russian)􀀀
 
 􎳌Control characters to support Bulgarian and Serbian letter shapes on the fly􀀀
@@ -90,13 +96,35 @@ How multilingual? Real multilingual!
 
 􎳌For all those dash-pedants, we have en-dash, em-dash, and even horizontal bars!􀀀
 
-􏃯Unicode References:􀀀
+    􏿿5¹⁹⁄₃₂ inch is 142.1 mm · (C₂F₄)ₙ is godly · Error = MoreCode²􀀀
+    􏿿NOTE: we don’t do fractions. 142¹⁄₁₀ mm is illegal!􀀀
 
-    Basic Latin   Latin-1   Latin Extension A   Latin Extionsion B   IPA Extension   Greek   Cyrillic
+􎳌Did you know Unicode supports arbitrary fractions? Actually I didn’t… as they abused super/subscripts!􀀀
-    Cyrillic Supplement   Armenian   Devanagari   Thai   Georgian   Runic   Cherokee   Georgian Extended
+
-    General Punctuations   CJK Symbols   Kana   Kana Phonetic Extension   CJK Unihan Extension A   CJK Unihan
+    􏿿ᄋᆡ급 일 ᄭᅡᄃᆞᆰ에 영국 ᄒᆞ고 불난셔 ᄒᆞ고 ᄃᆡ단이 시비가 잇슬 모양 인ᄃᆡ􀀀
-    Hangul Syllables   Fullwidth Forms   Kana Supplement
+    􏿿일본 농샹공부에셔 젼긔학 학ᄉᆞ 셋ᄉᆞᆯ 미국과 구라파로 보내셔 젼화 쓰ᄂᆞᆫ 법을 더ᄇᆡ호게 ᄒᆞ더라􀀀
+    􏿿일쳔 구ᄇᆡᆨ년에 불난셔 셔울 파리스에 만국 박남회를 버릴터 인ᄃᆡ 각국이 다 물화와 졔조품을 거긔 보낼터이더라􀀀
+
+􎳌Rejoice, now we can render Old Korean in a correct way!􀀀
+
+􏃯Supported Unicode Blocks:􀀀
+
+   Basic Latin  Latin-1 Supplement  Latin Extended-A  Latin Extended-B  IPA Extensions  Spacing Modifier Letters
+   Combining Diacritical Marks   Greek and Coptic􏿆ᴱ􀀀   Cyrillic􏿆ᴭ􀀀   Cyrillic Supplement􏿆ᴭ􀀀   Armenian   Devanagari
+   Bengali􏿆ᶠⁱ􀀀   Tamil   Thai   Georgian􏿆ჼ􀀀   Hangul Jamo   Cherokee􏿆⁷􀀀   Runic   Sundanese   Georgian Extended
+   Sundanese Supplement   Phonetic Extensions   Phonetic Extensions Supplement   Latin Extended Additional
+   Greek Extended   General Punctuations   Superscripts and Subscripts   Currency Symbols   Letterlike Symbols
+   Braile Patterns   Latin Extended-C   CJK Symbols and Punctuation   Hiragana   Katakana
+   Hangul Compatibility Jamo   Katakana Phonetic Extensions   CJK Unified Ideographs Extension A􏿆¹²·¹􀀀
+   CJK Unified Ideographs􏿆⁶􀀀   Latin Extended-D   Hangul Jamo Extended-A   Hangul Syllables
+   Hangul Jamo Extended-B  Halfwidth and Fullwidth Forms  Kana Supplement􏿆⁹􀀀  Enclosed Alphanumeric Supplement
+
+   􏿆ᴭ􀀀  No support for archæic letters    􏿆ᴱ􀀀  No support for Coptic
+   􏿆ᶠⁱ􀀀  No support for ligatures    􏿆ჼ􀀀  Mkhedruli only
+   􏿆⁶􀀀  􏿆⁷􀀀  􏿆⁹􀀀  􏿆¹²·¹􀀀  Up to the specified Unicode version
 
 GitHub’s issue page is open! You can report any 􏽕errors􀀀, or leave 􏽕suggestions􀀀.
 You can help this font to be more versatile. (for more languages, more frameworks) 􏽕Clone􀀀 this repo, make
 changes, and make a 􏽕pull request􀀀! I appreciate any and all supports.
+
+<EFBFBD> 􎳌文字化け！􀀀 <20>

keming_machine.txt

@@ -0,0 +1,108 @@
+--- Pixel 0
+- Lowheight bit
+- encoding: has pixel - it's low height
+- used by the diacritics system to quickly look up if the character is low height without parsing the Pixel 1
+
+### Legends
+#
+#  A·B < unset for lowheight miniscules, as in e
+#  |·| < space we don't care
+#  C·D < middle hole for majuscules, as in C
+#  E·F < middle hole for miniscules, as in c
+#  G·H
+#  ――― < baseline
+#  |·|
+#  J·K
+
+--- Pixel 1
+- A..K Occupied (1024)
+- Is ABGH are all Ys instead of Bars? (2)
+    - Say, A is Bar but E is wye (e.g. Ꮨ), this condition is false; this character must be encoded as ABDFGH(B).
+- encoding:
+    - <MSB> Y0000000 JK000000 ABCDEFGH <LSB>
+    - Y: Bar/Wye Mode
+    - A..K: arguments
+- B-type will contract the space by 2 pixels, while Y-type will do it by 1
+
+# Capital/lower itself is given using the pixel 0 due to the diacritics processing
+
+--- Examples
+- AB(B): T
+- ABCEGH(B): C
+- ABCEFGH(Y): K
+- ABCDEG: Ꮅ
+- ABCDEFGH: B,D,O
+- ABCDFH: Ч
+- ABCEG: Г
+- ABGH: Ꮖ
+- ACDEG: Ꮀ
+- ACDEFGH: h,Ƅ
+- ACDFH: ߆
+- ACEGH: L
+- AH(Y): \
+- BDEFGH: J
+- BDFGH: ɺ,ป
+- BG(Y): /
+- CD: Ⴕ
+- CDEF(Y): Φ
+- CDEFGH: a,c,e,i,o,φ,ϕ
+- CDEFGHJK: g
+- CDEFGHK: ƞ
+
+- AB(Y): Y
+- ABCD(Y): V
+- CDEF(Y): v
+- EFGH(Y): ʌ
+- CDGH(Y): A
+
+--- Rules
+# Legend: _ dont care
+#         @ must have a bit set
+#         ` must have a bit unset
+- ͟A͟B͟C͟D͟E͟F͟G͟H͟J͟K͟ ͟ ͟ ͟A͟B͟C͟D͟E͟F͟G͟H͟J͟K͟
+- _@_`___`__ — `_________ # Γe,TJ ; Ye,YJ,Ve,VJ,TA,ΓA,VA,Vʌ,YA,Yʌ,yA,yʌ,/a,/d
+- _@_@___`__ — `___`_@___ # Pɺ but NOT Po,PJ
+- _@_@___`__ — `___@_____ # Fo,PJ (always 1 px)
+- ___`_`____ — `___@_`___ # Cꟶ,Kꟶ,Lꟶ,Γꟶ
+- ___`_`____ — `_@___`___ # CꟵ,KꟵ,LꟵ,ΓꟵ
+-----------------------------------------------------
+- _`________ — @_`___`___ # eꞀ,LT ; eY,LY,eV,LV,AT,AꞀ,AY,Ay,λY,λy,a\,b\
+- _`___`_@__ — @_@___`___ # Lꟼ but NOT oꟼ,bꟼ
+- _`___@____ — @_@___`___ # oꟼ,bꟼ (always 1 px)
+- _`___@_`__ — __`_`_____ # ⱶƆ,ⱶJ
+- _`_@___`__ — __`_`_____ # ⱵƆ,ⱵJ
+
+
+--- Implementation
+code: |
+    val posTable = intArrayOf(7,6,5,4,3,2,1,0,9,8)
+
+    class RuleMask(s: String) {
+
+        private var careBits = 0
+        private var ruleBits = 0
+
+        init {
+            s.forEachIndexed { index, char ->
+                when (char) {
+                    '@' -> {
+                        careBits = careBits or (1 shl posTable[index])
+                        ruleBits = ruleBits or (1 shl posTable[index])
+                    }
+                    '`' -> {
+                        careBits = careBits or (1 shl posTable[index])
+                    }
+                }
+            }
+        }
+
+        fun matches(shapeBits: Int) = ((shapeBits and careBits) and ruleBits) == 0
+
+    }
+
+--- Pixel 2
+dot removal for diacritics:
+- All 24 bits are used to put replacement character
+- encoding:
+    - <MSB> RRRRRRRR GGGGGGGG BBBBBBBB <LSB>
+

src/net/torvald/terrarumsansbitmap/GlyphProps.kt

@@ -1,30 +1,132 @@
 package net.torvald.terrarumsansbitmap
 
+/**
+ * Created by minjaesong on 2021-11-25.
+ */
+data class DiacriticsAnchor(val type: Int, val x: Int, val y: Int, val xUsed: Boolean, val yUsed: Boolean)
 /**
  * Created by minjaesong on 2018-08-07.
  */
 data class GlyphProps(
         val width: Int,
-        val writeOnTop: Boolean,
+
-        val alignWhere: Int,
+        val isLowheight: Boolean = false,
-        val alignXPos: Int,
+
+        val nudgeX: Int = 0,
+        val nudgeY: Int = 0,
+
+        val diacriticsAnchors: Array<DiacriticsAnchor> = Array(6) { DiacriticsAnchor(it, 0, 0, false, false) },
+
+        val alignWhere: Int = 0, // ALIGN_LEFT..ALIGN_BEFORE
+
+        val writeOnTop: Int = -1, // -1: false, 0: Type-0, 1: Type-1, etc;
+
+        val stackWhere: Int = 0, // STACK_UP..STACK_UP_N_DOWN
+
+        val extInfo: IntArray = IntArray(15),
+
+        val hasKernData: Boolean = false,
+        val isKernYtype: Boolean = false,
+        val kerningMask: Int = 255,
+
+        val directiveOpcode: Int = 0, // 8-bits wide
+        val directiveArg1: Int = 0, // 8-bits wide
+        val directiveArg2: Int = 0, // 8-bits wide
+
         val rtl: Boolean = false,
-        val diacriticsStackDown: Boolean = false,
-        val diacriticsBeforeGlyph: Boolean = false
 ) {
     companion object {
-        const val LEFT = 0
+        const val ALIGN_LEFT = 0
-        const val RIGHT = 1
+        const val ALIGN_RIGHT = 1
-        const val CENTRE = 2
+        const val ALIGN_CENTRE = 2
+        const val ALIGN_BEFORE = 3
+
+        const val STACK_UP = 0
+        const val STACK_DOWN = 1
+        const val STACK_BEFORE_N_AFTER = 2
+        const val STACK_UP_N_DOWN = 3
+        const val STACK_DONT = 4
+
+        const val DIA_OVERLAY = 2
+//        const val DIA_JOINER = 2
+
+        private fun Boolean.toInt() = if (this) 1 else 0
     }
 
-    constructor(width: Int, tags: Int) : this(
+    /*constructor(width: Int, tags: Int) : this(
-            width,
+        width,
-            tags.ushr(7).and(1) == 1,
+        tags.ushr(7).and(1) == 1,
-            tags.ushr(5).and(3),
+        tags.ushr(5).and(3),
-            tags.ushr(1).and(15),
+        tags.ushr(1).and(15),
-            tags.and(1) == 1,
+        tags.and(1) == 1,
-            tags.ushr(8).and(1) == 1,
+        tags.ushr(8).and(3),
-            tags.ushr(5).and(3) == 3
+        tags.and(1) == 1
     )
+
+    constructor(width: Int, tags: Int, isLowheight: Boolean, isKernYtype: Boolean, kerningMask: Int) : this(
+        width,
+        tags.ushr(7).and(1) == 1,
+        tags.ushr(5).and(3),
+        tags.ushr(1).and(15),
+        tags.and(1) == 1,
+        tags.ushr(8).and(3),
+        tags.and(1) == 1,
+        null,
+
+        true,
+        isLowheight,
+        isKernYtype,
+        kerningMask
+    )*/
+
+//    fun isOverlay() = writeOnTop && alignXPos == 1
+
+    override fun hashCode(): Int {
+        val tags = rtl.toInt() or alignWhere.shl(5) or
+                   writeOnTop.toInt().shl(7) or stackWhere.shl(8)
+
+        var hash = -2128831034
+
+        extInfo.forEach {
+            hash = hash xor it
+            hash = hash * 16777619
+        }
+
+        diacriticsAnchors.forEach {
+            hash = hash xor it.type
+            hash = hash * 16777619
+            hash = hash xor (it.x or (if (it.xUsed) 128 else 0))
+            hash = hash * 16777619
+            hash = hash xor (it.y or (if (it.yUsed) 128 else 0))
+            hash = hash * 16777619
+        }
+
+        hash = hash xor tags
+        hash = hash * 167677619
+
+        return hash
+    }
+
+    override fun equals(other: Any?): Boolean {
+        // comparing hash because I'm lazy
+        return other is GlyphProps && this.hashCode() == other.hashCode()
+    }
+
+    fun requiredExtInfoCount() =
+        if (stackWhere == STACK_BEFORE_N_AFTER)
+            2
+        else if (directiveOpcode in 0b10000_000..0b10000_111)
+            7
+        else 0
+
+    fun isPragma(pragma: String) = when (pragma) {
+        "replacewith" -> directiveOpcode in 0b10000_000..0b10000_111
+        else -> false
+    }
+
+    fun forEachExtInfo(action: (Int) -> Unit) = extInfo.slice(0 until requiredExtInfoCount()).forEach(action)
+    fun forEachExtInfoIndexed(action: (Int, Int) -> Unit) = extInfo.slice(0 until requiredExtInfoCount()).forEachIndexed(action)
+
+    val isIllegal: Boolean
+        get() = directiveOpcode == 255
 }