README.md

Glyph Converter

A library for converting between MdC (Manuel de Codage) and GlyphX (Hieroglpyh XML). Both are used for displaying egyptian hieroglyphs.

This library is part of the Egyptian Writer Android App.

Tip

If you want to render Hieroglyphs in Android try the Egyptian Writer Android App or these libraries:
THOTH and MAAT

Implementation with jitpack

Add this to your settings.gradle.kts at the end of repositories:

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    mavenCentral()
    maven { url = uri("https://jitpack.io") }
  }
}

Then add this dependency to your build.gradle.kts file:

dependencies {
  implementation("com.github.ThothDroid:GlyphConverter:1.8.0")
}

Note

For the implementation for other build systems like Groovy see here

Implementation with .jar file

Download the GlyphConverter_versionname.jar file from the latest release, create a libs folder in your project directory and paste the file there. Then add this dependency to your build.gradle.kts file:

dependencies {
  implementation(files("../libs/GlyphConverter_versionname.jar"))
}

Important

If you renamed the .jar file you also have to change the name in the dependencies

Supported Codes

The GlyphConverter library supports the following codes:

• On GlyphX input the following tags are supported:
  • <sign id="X"/> A single sign. The id is the code of the hieroglyph. The library supports both Gardiner's Sign List and their phonetic alternates.
  • <v></v> Items inside are arranged vertically
  • <h></h> Items inside are arranged horizontally
  • <br/> A line break
  • <pbr/> A page break
  • <space/> Acts as a space between signs with half of the size of a whole group.
  • <gap/> The same as <space/> but with a width and height equal to the size of a whole group.
• On MdC input the following signs are supported:
  • X A single sign. The library supports both Gardiner's Sign List and their phonetic alternates.
  • : Items separated by it are arranged vertically
  • * Items separated by it are arranged horizontally
  • ( and ) Items inside are grouped and the whole group is treated as a single sign. This is useful for complex groups. (In GlyphX the groups are implied by the XML structure, so they are not needed there)
  • ! A line break
  • !! A page break
  • . Acts as a space between signs with half of the size of a whole group.
  • .. The same as . but with a width and height equal to the size of a whole group.

Version Catalog

Important

Since version 13.08.2026@1.8.0 the version catalog uses the new versioning system see here.

25.10.2025@1.0.0

This is the first release of the GlyphConverter library.

07.11.2025@1.5.0

Support for brackets in MdC added. Now you can type in:

N17:(i*(p:t)*(t:p)*i):N17

08.11.2025@1.6.0

Minor bug fixes. Now you can successfully convert this:

N17:i*(p:t)*(t:p)*i:N17

07.12.2025@1.7.0

• updated dependencies
• Custom exception for glyphX parsing added: GlyphXParserException.java
• Support for \n and \t added
• Support for page break and line break added:
  • <br/>: !
  • <pbr/>: !!

13.08.2026@1.8.0

• Support for space between signs added:
  • <space/>: .
  • <gap/>: ..

latest Version

13.08.2026@1.8.0