# oraveczandrew/ksvg architecture

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

- Interactive diagram: https://gitdiagram.com/oraveczandrew/ksvg
- Repository: https://github.com/oraveczandrew/ksvg

## Overview

KSVG is an Android SVG parsing and rendering library. The principal workflow is to load SVG input through the public API, parse XML and styles into an SVG document/DOM, then render the document to a Canvas or Drawable; optional Compose and Glide adapters expose that result to application UI and image-loading flows. The repository also documents animation, typography, hit testing, GPU filters with CPU/native fallbacks, and resolver-based external resources. Some subsystem links are based on README capabilities because their implementation files were not excerpted.

Main entry points: [`ksvg/src/main/kotlin/hu/oandras/ksvg/SVG.kt`](https://github.com/oraveczandrew/ksvg/blob/master/ksvg/src/main/kotlin/hu/oandras/ksvg/SVG.kt) (SVG API), [`ksvg/src/main/kotlin/hu/oandras/ksvg/parser/SVGParserImpl.kt`](https://github.com/oraveczandrew/ksvg/blob/master/ksvg/src/main/kotlin/hu/oandras/ksvg/parser/SVGParserImpl.kt) (SVG parser), [`ksvg/src/main/kotlin/hu/oandras/ksvg/dom/SVGImpl.kt`](https://github.com/oraveczandrew/ksvg/blob/master/ksvg/src/main/kotlin/hu/oandras/ksvg/dom/SVGImpl.kt) (SVG document), [`glide/src/main/kotlin/hu/oandras/ksvg/glide/SvgDecoder.kt`](https://github.com/oraveczandrew/ksvg/blob/master/glide/src/main/kotlin/hu/oandras/ksvg/glide/SvgDecoder.kt) (Glide integration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Public API"]
  node_svg_api["SVG API<br/>[SVG.kt]"]
  node_render_options["Render options<br/>[RenderOptions.kt]"]
end

subgraph group_document["Document Processing"]
  node_parser["SVG parser<br/>[SVGParserImpl.kt]"]
  node_xml_parser["XML parsing<br/>[KXmlParser.kt]"]
  node_css["CSS parsing<br/>[CSSParser.kt]"]
  node_svg_document["SVG document<br/>[SVGImpl.kt]"]
  node_svg_dom["SVG DOM<br/>[SvgObject.kt]"]
  node_dom_containers["DOM containers<br/>[Container.kt]"]
  node_styles["Style model<br/>[Style.kt]"]
  node_animations["SMIL animation<br/>[Animation.kt]"]
  node_resolver["External resolver"]
end

subgraph group_render["Rendering"]
  node_canvas_renderer["Canvas renderer<br/>[Canvas.kt]"]
  node_drawable["Drawable output<br/>[KSVGDrawable.kt]"]
  node_hit_test["Hit testing<br/>[HitTest.kt]"]
  node_filter_pipeline["GPU filters"]
  node_filter_kernels["CPU and SIMD kernels<br/>[NativeBackend.kt]"]
end

subgraph group_adapters["UI Integrations"]
  node_compose["Compose UI<br/>[KsvgImage.kt]"]
  node_compose_canvas["Compose canvas<br/>[KsvgCanvas.kt]"]
  node_glide["Glide integration<br/>[SvgDecoder.kt]"]
  node_glide_transcoder["Drawable transcoder"]
end

node_app(("Android app"))

node_app -->|"loads SVG"| node_svg_api
node_svg_api -->|"parses input"| node_parser
node_parser -.->|"reads XML"| node_xml_parser
node_parser -->|"parses styles"| node_css
node_parser -->|"builds document"| node_svg_document
node_svg_document -->|"holds tree"| node_svg_dom
node_svg_dom -->|"contains children"| node_dom_containers
node_app -->|"configures rendering"| node_render_options
node_svg_api -->|"renders to canvas"| node_canvas_renderer
node_svg_api -->|"creates drawable"| node_drawable
node_svg_document -->|"supports hit testing"| node_hit_test
node_svg_api -->|"exposes animation"| node_animations
node_parser -.->|"requests resources"| node_resolver
node_canvas_renderer -.->|"uses GPU filters"| node_filter_pipeline
node_filter_pipeline -.->|"falls back to CPU"| node_filter_kernels
node_app -->|"shows image"| node_compose
node_compose -->|"loads document"| node_svg_api
node_app -->|"draws SVG"| node_compose_canvas
node_app -->|"loads image"| node_glide
node_glide -->|"decodes SVG"| node_svg_api
node_glide -.->|"transcodes resource"| node_glide_transcoder

click node_svg_api "https://github.com/oraveczandrew/ksvg/blob/master/ksvg/src/main/kotlin/hu/oandras/ksvg/SVG.kt"
click node_render_options "https://github.com/oraveczandrew/ksvg/blob/master/ksvg/src/main/kotlin/hu/oandras/ksvg/RenderOptions.kt"
click node_parser "https://github.com/oraveczandrew/ksvg/blob/master/ksvg/src/main/kotlin/hu/oandras/ksvg/parser/SVGParserImpl.kt"
click node_xml_parser "https://github.com/oraveczandrew/ksvg/blob/master/ksvg/src/main/kotlin/hu/oandras/ksvg/parser/KXmlParser.kt"
click node_css "https://github.com/oraveczandrew/ksvg/blob/master/ksvg/src/main/kotlin/hu/oandras/ksvg/css/CSSParser.kt"
click node_svg_document "https://github.com/oraveczandrew/ksvg/blob/master/ksvg/src/main/kotlin/hu/oandras/ksvg/dom/SVGImpl.kt"
click node_svg_dom "https://github.com/oraveczandrew/ksvg/blob/master/ksvg/src/main/kotlin/hu/oandras/ksvg/dom/core/SvgObject.kt"
click node_dom_containers "https://github.com/oraveczandrew/ksvg/blob/master/ksvg/src/main/kotlin/hu/oandras/ksvg/dom/core/Container.kt"
click node_styles "https://github.com/oraveczandrew/ksvg/blob/master/ksvg/src/main/kotlin/hu/oandras/ksvg/dom/style/Style.kt"
click node_animations "https://github.com/oraveczandrew/ksvg/blob/master/ksvg/src/main/kotlin/hu/oandras/ksvg/dom/animation/Animation.kt"
click node_resolver "https://github.com/oraveczandrew/ksvg/blob/master/ksvg/src/main/kotlin/hu/oandras/ksvg/ExternalFileResolver.kt"
click node_canvas_renderer "https://github.com/oraveczandrew/ksvg/blob/master/ksvg/src/main/kotlin/hu/oandras/ksvg/render/Canvas.kt"
click node_drawable "https://github.com/oraveczandrew/ksvg/blob/master/ksvg/src/main/kotlin/hu/oandras/ksvg/KSVGDrawable.kt"
click node_hit_test "https://github.com/oraveczandrew/ksvg/blob/master/ksvg/src/main/kotlin/hu/oandras/ksvg/render/HitTest.kt"
click node_filter_pipeline "https://github.com/oraveczandrew/ksvg/blob/master/ksvg/src/main/kotlin/hu/oandras/ksvg/render/filters/pipeline/GpuFilterBackendApi33.kt"
click node_filter_kernels "https://github.com/oraveczandrew/ksvg/blob/master/filtering/src/main/kotlin/hu/oandras/ksvg/filtering/NativeBackend.kt"
click node_compose "https://github.com/oraveczandrew/ksvg/blob/master/compose/src/main/kotlin/hu/oandras/ksvg/compose/KsvgImage.kt"
click node_compose_canvas "https://github.com/oraveczandrew/ksvg/blob/master/compose/src/main/kotlin/hu/oandras/ksvg/compose/KsvgCanvas.kt"
click node_glide "https://github.com/oraveczandrew/ksvg/blob/master/glide/src/main/kotlin/hu/oandras/ksvg/glide/SvgDecoder.kt"
click node_glide_transcoder "https://github.com/oraveczandrew/ksvg/blob/master/glide/src/main/kotlin/hu/oandras/ksvg/glide/KSVGSvgDrawableTranscoder.kt"

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_svg_api,node_render_options toneBlue
class node_parser,node_xml_parser,node_css,node_svg_document,node_svg_dom,node_dom_containers,node_styles,node_animations,node_resolver toneAmber
class node_canvas_renderer,node_drawable,node_hit_test,node_filter_pipeline,node_filter_kernels toneMint
class node_compose,node_compose_canvas,node_glide,node_glide_transcoder toneRose
class node_app toneIndigo
```

## Components

### Public API

- [SVG API](https://github.com/oraveczandrew/ksvg/blob/master/ksvg/src/main/kotlin/hu/oandras/ksvg/SVG.kt): `ksvg/src/main/kotlin/hu/oandras/ksvg/SVG.kt`
- [Render options](https://github.com/oraveczandrew/ksvg/blob/master/ksvg/src/main/kotlin/hu/oandras/ksvg/RenderOptions.kt): `ksvg/src/main/kotlin/hu/oandras/ksvg/RenderOptions.kt`

### Document Processing

- [SVG parser](https://github.com/oraveczandrew/ksvg/blob/master/ksvg/src/main/kotlin/hu/oandras/ksvg/parser/SVGParserImpl.kt): `ksvg/src/main/kotlin/hu/oandras/ksvg/parser/SVGParserImpl.kt`
- [XML parsing](https://github.com/oraveczandrew/ksvg/blob/master/ksvg/src/main/kotlin/hu/oandras/ksvg/parser/KXmlParser.kt): `ksvg/src/main/kotlin/hu/oandras/ksvg/parser/KXmlParser.kt`
- [CSS parsing](https://github.com/oraveczandrew/ksvg/blob/master/ksvg/src/main/kotlin/hu/oandras/ksvg/css/CSSParser.kt): `ksvg/src/main/kotlin/hu/oandras/ksvg/css/CSSParser.kt`
- [SVG document](https://github.com/oraveczandrew/ksvg/blob/master/ksvg/src/main/kotlin/hu/oandras/ksvg/dom/SVGImpl.kt): `ksvg/src/main/kotlin/hu/oandras/ksvg/dom/SVGImpl.kt`
- [SVG DOM](https://github.com/oraveczandrew/ksvg/blob/master/ksvg/src/main/kotlin/hu/oandras/ksvg/dom/core/SvgObject.kt): `ksvg/src/main/kotlin/hu/oandras/ksvg/dom/core/SvgObject.kt`
- [DOM containers](https://github.com/oraveczandrew/ksvg/blob/master/ksvg/src/main/kotlin/hu/oandras/ksvg/dom/core/Container.kt): `ksvg/src/main/kotlin/hu/oandras/ksvg/dom/core/Container.kt`
- [Style model](https://github.com/oraveczandrew/ksvg/blob/master/ksvg/src/main/kotlin/hu/oandras/ksvg/dom/style/Style.kt): `ksvg/src/main/kotlin/hu/oandras/ksvg/dom/style/Style.kt`
- [SMIL animation](https://github.com/oraveczandrew/ksvg/blob/master/ksvg/src/main/kotlin/hu/oandras/ksvg/dom/animation/Animation.kt): `ksvg/src/main/kotlin/hu/oandras/ksvg/dom/animation/Animation.kt`
- [External resolver](https://github.com/oraveczandrew/ksvg/blob/master/ksvg/src/main/kotlin/hu/oandras/ksvg/ExternalFileResolver.kt): `ksvg/src/main/kotlin/hu/oandras/ksvg/ExternalFileResolver.kt`

### Rendering

- [Canvas renderer](https://github.com/oraveczandrew/ksvg/blob/master/ksvg/src/main/kotlin/hu/oandras/ksvg/render/Canvas.kt): `ksvg/src/main/kotlin/hu/oandras/ksvg/render/Canvas.kt`
- [Drawable output](https://github.com/oraveczandrew/ksvg/blob/master/ksvg/src/main/kotlin/hu/oandras/ksvg/KSVGDrawable.kt): `ksvg/src/main/kotlin/hu/oandras/ksvg/KSVGDrawable.kt`
- [Hit testing](https://github.com/oraveczandrew/ksvg/blob/master/ksvg/src/main/kotlin/hu/oandras/ksvg/render/HitTest.kt): `ksvg/src/main/kotlin/hu/oandras/ksvg/render/HitTest.kt`
- [GPU filters](https://github.com/oraveczandrew/ksvg/blob/master/ksvg/src/main/kotlin/hu/oandras/ksvg/render/filters/pipeline/GpuFilterBackendApi33.kt): `ksvg/src/main/kotlin/hu/oandras/ksvg/render/filters/pipeline/GpuFilterBackendApi33.kt`
- [CPU and SIMD kernels](https://github.com/oraveczandrew/ksvg/blob/master/filtering/src/main/kotlin/hu/oandras/ksvg/filtering/NativeBackend.kt): `filtering/src/main/kotlin/hu/oandras/ksvg/filtering/NativeBackend.kt`

### UI Integrations

- [Compose UI](https://github.com/oraveczandrew/ksvg/blob/master/compose/src/main/kotlin/hu/oandras/ksvg/compose/KsvgImage.kt): `compose/src/main/kotlin/hu/oandras/ksvg/compose/KsvgImage.kt`
- [Compose canvas](https://github.com/oraveczandrew/ksvg/blob/master/compose/src/main/kotlin/hu/oandras/ksvg/compose/KsvgCanvas.kt): `compose/src/main/kotlin/hu/oandras/ksvg/compose/KsvgCanvas.kt`
- [Glide integration](https://github.com/oraveczandrew/ksvg/blob/master/glide/src/main/kotlin/hu/oandras/ksvg/glide/SvgDecoder.kt): `glide/src/main/kotlin/hu/oandras/ksvg/glide/SvgDecoder.kt`
- [Drawable transcoder](https://github.com/oraveczandrew/ksvg/blob/master/glide/src/main/kotlin/hu/oandras/ksvg/glide/KSVGSvgDrawableTranscoder.kt): `glide/src/main/kotlin/hu/oandras/ksvg/glide/KSVGSvgDrawableTranscoder.kt`

### Other components

- **Android app**

## Connections

- Android app → SVG API: loads SVG (evidence: `README.md`)
- SVG API → SVG parser: parses input (evidence: `README.md`)
- SVG parser → XML parsing: reads XML
- SVG parser → CSS parsing: parses styles (evidence: `ksvg/src/main/kotlin/hu/oandras/ksvg/parser/SVGParserImpl.kt`)
- SVG parser → SVG document: builds document (evidence: `ksvg/src/main/kotlin/hu/oandras/ksvg/parser/SVGParserImpl.kt`)
- SVG document → SVG DOM: holds tree (evidence: `ksvg/src/main/kotlin/hu/oandras/ksvg/dom/core/SvgObject.kt`)
- SVG DOM → DOM containers: contains children (evidence: `ksvg/src/main/kotlin/hu/oandras/ksvg/dom/core/SvgObject.kt`)
- Android app → Render options: configures rendering (evidence: `README.md`)
- SVG API → Canvas renderer: renders to canvas (evidence: `README.md`)
- SVG API → Drawable output: creates drawable (evidence: `ksvg/src/main/kotlin/hu/oandras/ksvg/SVG.kt`)
- SVG document → Hit testing: supports hit testing (evidence: `ksvg/src/main/kotlin/hu/oandras/ksvg/dom/SVGImpl.kt`)
- SVG API → SMIL animation: exposes animation (evidence: `README.md`)
- SVG parser → External resolver: requests resources (evidence: `ksvg/src/main/kotlin/hu/oandras/ksvg/parser/SVGParserImpl.kt`)
- Canvas renderer → GPU filters: uses GPU filters (evidence: `README.md`)
- GPU filters → CPU and SIMD kernels: falls back to CPU (evidence: `README.md`)
- Android app → Compose UI: shows image (evidence: `README.md`)
- Compose UI → SVG API: loads document (evidence: `compose/src/main/kotlin/hu/oandras/ksvg/compose/KsvgImage.kt`)
- Android app → Compose canvas: draws SVG (evidence: `README.md`)
- Android app → Glide integration: loads image (evidence: `README.md`)
- Glide integration → SVG API: decodes SVG (evidence: `glide/src/main/kotlin/hu/oandras/ksvg/glide/SvgDecoder.kt`)
- Glide integration → Drawable transcoder: transcodes resource
