# q-i-e/texon architecture

> Architecture diagram of the GitHub repository q-i-e/texon, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/q-i-e/texon
- Repository: https://github.com/q-i-e/texon

## Overview

Texon is a pure-Java LaTeX math-rendering library. A caller loads font assets, submits formula text to the Texon facade, and receives measurements, SVG, raster pixels, or PNG. The documented core stages are parsing, box-tree layout, and rendering through vector or raster backends; runtime font data is loaded in shards. The graph also shows configuration and rendering caches. Several connections are supported by the README or SOURCE INDEX rather than complete source excerpts, so unsampled implementation details are not expanded.

Main entry points: [`java/texon/latex/engine/core/Texon.java`](https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/Texon.java) (Texon Facade), [`java/texon/latex/engine/core/layout/Layout.java`](https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/layout/Layout.java) (Box Layout), [`java/texon/latex/engine/core/render/RasterSink.java`](https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/render/RasterSink.java) (Raster Backend), [`java/texon/latex/engine/core/FontMetrics.java`](https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/FontMetrics.java) (Font Metrics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Public API"]
  node_texon["Texon Facade<br/>[Texon.java]"]
  node_measure["Layout Metrics<br/>[LayoutMetrics.java]"]
end

subgraph group_parse["Formula Parsing"]
  node_lexer["Lexer<br/>[Lexer.java]"]
  node_parser["LaTeX Parser<br/>[Parser.java]"]
  node_ast["Formula AST<br/>[Ast.java]"]
end

subgraph group_layout["Layout Engine"]
  node_layout_engine["Box Layout<br/>[Layout.java]"]
  node_box_tree["Layout Boxes<br/>[Box.java]"]
  node_layout_cache["Layout Cache<br/>[LayoutCache.java]"]
  node_runtime_config["Runtime Tables"]
end

subgraph group_assets["Font Assets"]
  node_asset_access["Asset Access<br/>[Assets.java]"]
  node_metric_data[("Font Metrics<br/>[FontMetrics.java]")]
  node_outline_data[("Glyph Outlines<br/>[GlyphOutlines.java]")]
  node_asset_parts["Shard Index<br/>[Parts.java]"]
end

subgraph group_render["Rendering"]
  node_renderer["Tree Renderer<br/>[Renderer.java]"]
  node_svg["SVG Backend<br/>[SvgRenderer.java]"]
  node_raster_sink["Raster Backend<br/>[RasterSink.java]"]
  node_glyph_paths["Glyph Path Cache<br/>[GlyphPaths.java]"]
  node_mask_cache["Coverage Cache<br/>[MaskCache.java]"]
  node_raster_result["Raster Pixels<br/>[Raster.java]"]
  node_png_encoder["PNG Encoder<br/>[Png.java]"]
  node_svg_result["SVG Output"]
end

node_caller(("Library Caller"))
node_png_result["PNG Output"]

node_caller -->|"submits formula"| node_texon
node_texon -->|"loads assets"| node_asset_access
node_texon -->|"loads metrics"| node_metric_data
node_texon -->|"loads outlines"| node_outline_data
node_metric_data -->|"loads shards"| node_asset_parts
node_outline_data -->|"loads shards"| node_asset_parts
node_metric_data -->|"installs tables"| node_runtime_config
node_texon -->|"tokenizes input"| node_lexer
node_texon -->|"parses formula"| node_parser
node_parser -->|"reads tokens"| node_lexer
node_parser -->|"builds tree"| node_ast
node_texon -->|"lays out formula"| node_layout_engine
node_layout_engine -->|"reads tree"| node_ast
node_layout_engine -->|"reads metrics"| node_metric_data
node_layout_engine -->|"reads settings"| node_runtime_config
node_layout_engine -->|"builds boxes"| node_box_tree
node_texon -->|"reuses layouts"| node_layout_cache
node_texon -->|"returns measures"| node_measure
node_texon -->|"renders boxes"| node_renderer
node_renderer -->|"traverses boxes"| node_box_tree
node_texon -->|"selects vector"| node_svg
node_texon -->|"selects raster"| node_raster_sink
node_svg -->|"draws tree"| node_renderer
node_raster_sink -->|"uses paths"| node_glyph_paths
node_raster_sink -->|"reuses masks"| node_mask_cache
node_glyph_paths -->|"reads outlines"| node_outline_data
node_raster_sink -->|"produces pixels"| node_raster_result
node_texon -->|"encodes raster"| node_png_encoder
node_png_encoder -->|"encodes pixels"| node_raster_result
node_svg -->|"returns SVG"| node_svg_result
node_png_encoder -->|"returns PNG"| node_png_result

click node_texon "https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/Texon.java"
click node_measure "https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/LayoutMetrics.java"
click node_lexer "https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/lex/Lexer.java"
click node_parser "https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/parse/Parser.java"
click node_ast "https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/parse/Ast.java"
click node_layout_engine "https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/layout/Layout.java"
click node_box_tree "https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/box/Box.java"
click node_layout_cache "https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/layout/LayoutCache.java"
click node_runtime_config "https://github.com/q-i-e/texon/tree/main/java/texon/latex/engine/config"
click node_asset_access "https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/Assets.java"
click node_metric_data "https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/FontMetrics.java"
click node_outline_data "https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/GlyphOutlines.java"
click node_asset_parts "https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/Parts.java"
click node_renderer "https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/render/Renderer.java"
click node_svg "https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/render/SvgRenderer.java"
click node_raster_sink "https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/render/RasterSink.java"
click node_glyph_paths "https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/render/GlyphPaths.java"
click node_mask_cache "https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/render/MaskCache.java"
click node_raster_result "https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/render/Raster.java"
click node_png_encoder "https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/render/Png.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_texon,node_measure toneBlue
class node_lexer,node_parser,node_ast toneAmber
class node_layout_engine,node_box_tree,node_layout_cache,node_runtime_config toneMint
class node_asset_access,node_metric_data,node_outline_data,node_asset_parts toneRose
class node_renderer,node_svg,node_raster_sink,node_glyph_paths,node_mask_cache,node_raster_result,node_png_encoder,node_svg_result,node_caller,node_png_result toneIndigo
```

## Components

### Public API

- [Texon Facade](https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/Texon.java): `java/texon/latex/engine/core/Texon.java`
- [Layout Metrics](https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/LayoutMetrics.java): `java/texon/latex/engine/core/LayoutMetrics.java`

### Formula Parsing

- [Lexer](https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/lex/Lexer.java): `java/texon/latex/engine/core/lex/Lexer.java`
- [LaTeX Parser](https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/parse/Parser.java): `java/texon/latex/engine/core/parse/Parser.java`
- [Formula AST](https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/parse/Ast.java): `java/texon/latex/engine/core/parse/Ast.java`

### Layout Engine

- [Box Layout](https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/layout/Layout.java): `java/texon/latex/engine/core/layout/Layout.java`
- [Layout Boxes](https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/box/Box.java): `java/texon/latex/engine/core/box/Box.java`
- [Layout Cache](https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/layout/LayoutCache.java): `java/texon/latex/engine/core/layout/LayoutCache.java`
- [Runtime Tables](https://github.com/q-i-e/texon/tree/main/java/texon/latex/engine/config): `java/texon/latex/engine/config`

### Font Assets

- [Asset Access](https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/Assets.java): `java/texon/latex/engine/core/Assets.java`
- [Font Metrics](https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/FontMetrics.java): `java/texon/latex/engine/core/FontMetrics.java`
- [Glyph Outlines](https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/GlyphOutlines.java): `java/texon/latex/engine/core/GlyphOutlines.java`
- [Shard Index](https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/Parts.java): `java/texon/latex/engine/core/Parts.java`

### Rendering

- [Tree Renderer](https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/render/Renderer.java): `java/texon/latex/engine/core/render/Renderer.java`
- [SVG Backend](https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/render/SvgRenderer.java): `java/texon/latex/engine/core/render/SvgRenderer.java`
- [Raster Backend](https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/render/RasterSink.java): `java/texon/latex/engine/core/render/RasterSink.java`
- [Glyph Path Cache](https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/render/GlyphPaths.java): `java/texon/latex/engine/core/render/GlyphPaths.java`
- [Coverage Cache](https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/render/MaskCache.java): `java/texon/latex/engine/core/render/MaskCache.java`
- [Raster Pixels](https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/render/Raster.java): `java/texon/latex/engine/core/render/Raster.java`
- [PNG Encoder](https://github.com/q-i-e/texon/blob/main/java/texon/latex/engine/core/render/Png.java): `java/texon/latex/engine/core/render/Png.java`
- **SVG Output**

### Other components

- **Library Caller**
- **PNG Output**

## Connections

- Library Caller → Texon Facade: submits formula
- Texon Facade → Asset Access: loads assets (evidence: `java/texon/latex/engine/core/Texon.java`)
- Texon Facade → Font Metrics: loads metrics (evidence: `java/texon/latex/engine/core/Texon.java`)
- Texon Facade → Glyph Outlines: loads outlines (evidence: `java/texon/latex/engine/core/Texon.java`)
- Font Metrics → Shard Index: loads shards (evidence: `java/texon/latex/engine/core/FontMetrics.java`)
- Glyph Outlines → Shard Index: loads shards (evidence: `java/texon/latex/engine/core/GlyphOutlines.java`)
- Font Metrics → Runtime Tables: installs tables (evidence: `java/texon/latex/engine/core/FontMetrics.java`)
- Texon Facade → Lexer: tokenizes input (evidence: `java/texon/latex/engine/core/Texon.java`)
- Texon Facade → LaTeX Parser: parses formula (evidence: `java/texon/latex/engine/core/Texon.java`)
- LaTeX Parser → Lexer: reads tokens (evidence: `java/texon/latex/engine/core/parse/Parser.java`)
- LaTeX Parser → Formula AST: builds tree (evidence: `java/texon/latex/engine/core/parse/Parser.java`)
- Texon Facade → Box Layout: lays out formula (evidence: `java/texon/latex/engine/core/Texon.java`)
- Box Layout → Formula AST: reads tree (evidence: `java/texon/latex/engine/core/layout/Layout.java`)
- Box Layout → Font Metrics: reads metrics (evidence: `java/texon/latex/engine/core/layout/Layout.java`)
- Box Layout → Runtime Tables: reads settings (evidence: `java/texon/latex/engine/core/layout/Layout.java`)
- Box Layout → Layout Boxes: builds boxes (evidence: `java/texon/latex/engine/core/layout/Layout.java`)
- Texon Facade → Layout Cache: reuses layouts (evidence: `java/texon/latex/engine/core/Texon.java`)
- Texon Facade → Layout Metrics: returns measures (evidence: `java/texon/latex/engine/core/Texon.java`)
- Texon Facade → Tree Renderer: renders boxes (evidence: `java/texon/latex/engine/core/Texon.java`)
- Tree Renderer → Layout Boxes: traverses boxes (evidence: `java/texon/latex/engine/core/render/Renderer.java`)
- Texon Facade → SVG Backend: selects vector (evidence: `java/texon/latex/engine/core/Texon.java`)
- Texon Facade → Raster Backend: selects raster (evidence: `java/texon/latex/engine/core/Texon.java`)
- SVG Backend → Tree Renderer: draws tree (evidence: `java/texon/latex/engine/core/render/SvgRenderer.java`)
- Raster Backend → Glyph Path Cache: uses paths (evidence: `java/texon/latex/engine/core/render/RasterSink.java`)
- Raster Backend → Coverage Cache: reuses masks (evidence: `java/texon/latex/engine/core/render/RasterSink.java`)
- Glyph Path Cache → Glyph Outlines: reads outlines (evidence: `java/texon/latex/engine/core/render/GlyphPaths.java`)
- Raster Backend → Raster Pixels: produces pixels (evidence: `java/texon/latex/engine/core/render/RasterSink.java`)
- Texon Facade → PNG Encoder: encodes raster (evidence: `java/texon/latex/engine/core/Texon.java`)
- PNG Encoder → Raster Pixels: encodes pixels (evidence: `java/texon/latex/engine/core/render/Png.java`)
- SVG Backend → SVG Output: returns SVG
- PNG Encoder → PNG Output: returns PNG
