How oraveczandrew/ksvg works
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: SVG.kt SVG API · SVGParserImpl.kt SVG parser · SVGImpl.kt SVG document · SvgDecoder.kt Glide integration
Components 21
Public API
- SVG API
ksvg/src/main/kotlin/hu/oandras/ksvg/SVG.kt - Render options
ksvg/src/main/kotlin/hu/oandras/ksvg/RenderOptions.kt
Document Processing
- SVG parser
ksvg/src/main/kotlin/hu/oandras/ksvg/parser/SVGParserImpl.kt - XML parsing
ksvg/src/main/kotlin/hu/oandras/ksvg/parser/KXmlParser.kt - CSS parsing
ksvg/src/main/kotlin/hu/oandras/ksvg/css/CSSParser.kt - SVG document
ksvg/src/main/kotlin/hu/oandras/ksvg/dom/SVGImpl.kt - SVG DOM
ksvg/src/main/kotlin/hu/oandras/ksvg/dom/core/SvgObject.kt - DOM containers
ksvg/src/main/kotlin/hu/oandras/ksvg/dom/core/Container.kt - Style model
ksvg/src/main/kotlin/hu/oandras/ksvg/dom/style/Style.kt - SMIL animation
ksvg/src/main/kotlin/hu/oandras/ksvg/dom/animation/Animation.kt - External resolver
ksvg/src/main/kotlin/hu/oandras/ksvg/ExternalFileResolver.kt
Rendering
- Canvas renderer
ksvg/src/main/kotlin/hu/oandras/ksvg/render/Canvas.kt - Drawable output
ksvg/src/main/kotlin/hu/oandras/ksvg/KSVGDrawable.kt - Hit testing
ksvg/src/main/kotlin/hu/oandras/ksvg/render/HitTest.kt - GPU filters
ksvg/src/main/kotlin/hu/oandras/ksvg/render/filters/pipeline/GpuFilterBackendApi33.kt - CPU and SIMD kernels
filtering/src/main/kotlin/hu/oandras/ksvg/filtering/NativeBackend.kt
UI Integrations
- Compose UI
compose/src/main/kotlin/hu/oandras/ksvg/compose/KsvgImage.kt - Compose canvas
compose/src/main/kotlin/hu/oandras/ksvg/compose/KsvgCanvas.kt - Glide integration
glide/src/main/kotlin/hu/oandras/ksvg/glide/SvgDecoder.kt - Drawable transcoder
glide/src/main/kotlin/hu/oandras/ksvg/glide/KSVGSvgDrawableTranscoder.kt
Other components
- Android app
Connections 21
- Android app → SVG API: loads SVG
README.md - SVG API → SVG parser: parses input
README.md - SVG parser → XML parsing: reads XML
- SVG parser → CSS parsing: parses styles
ksvg/src/main/kotlin/hu/oandras/ksvg/parser/SVGParserImpl.kt - SVG parser → SVG document: builds document
ksvg/src/main/kotlin/hu/oandras/ksvg/parser/SVGParserImpl.kt - SVG document → SVG DOM: holds tree
ksvg/src/main/kotlin/hu/oandras/ksvg/dom/core/SvgObject.kt - SVG DOM → DOM containers: contains children
ksvg/src/main/kotlin/hu/oandras/ksvg/dom/core/SvgObject.kt - Android app → Render options: configures rendering
README.md - SVG API → Canvas renderer: renders to canvas
README.md - SVG API → Drawable output: creates drawable
ksvg/src/main/kotlin/hu/oandras/ksvg/SVG.kt - SVG document → Hit testing: supports hit testing
ksvg/src/main/kotlin/hu/oandras/ksvg/dom/SVGImpl.kt - SVG API → SMIL animation: exposes animation
README.md - SVG parser → External resolver: requests resources
ksvg/src/main/kotlin/hu/oandras/ksvg/parser/SVGParserImpl.kt - Canvas renderer → GPU filters: uses GPU filters
README.md - GPU filters → CPU and SIMD kernels: falls back to CPU
README.md - Android app → Compose UI: shows image
README.md - Compose UI → SVG API: loads document
compose/src/main/kotlin/hu/oandras/ksvg/compose/KsvgImage.kt - Android app → Compose canvas: draws SVG
README.md - Android app → Glide integration: loads image
README.md - Glide integration → SVG API: decodes SVG
glide/src/main/kotlin/hu/oandras/ksvg/glide/SvgDecoder.kt - Glide integration → Drawable transcoder: transcodes resource