Skip to content

Logopher/UnitySVG

 
 

Repository files navigation

OVERVIEW

UnitySVG is a library for reading SVG files and producing Texture2D objects from them at runtime. The intent is to allow some of one’s art assets to be reduced considerably in terms of the net time needed before the user can begin playing the game.

In order for this to be viable, three things must be true:

  1. The net download size of the SVG code + SVG assets (or whatever preprocessed format we want to use) + the time needed to render the SVGs and compress them must be smaller than the download time using DXT textures directly when happening at some “average-user bandwidth” (undefined here, of course).
  2. The resultant visual quality must be acceptable for a significant set of visual styles. (Both with regard to the complexity of SVG image that can be used and the result of runtime texture compression.)
  3. The net user experience must be positive. (Long pauses == bad, swap thrashing == bad, etc.)

COMPATIBILITY

A very limited subset of SVG is supported, specifically excluding:

  • Animation
  • Text
  • Fonts
  • ICC color profiles
  • Bindings
  • Compound documents
  • CSS
  • foreignObjects

Essentially, only things involved in rendering static images are supported, with no regard to clarity of the XML, “reuse”, or whatnot. The principle workflow I had envisioned for this centered around (semi-)auto-generated conversions from raster to vector format, so some of the more high-level features of SVG were simply not relevant.

PERFORMANCE

Pretty awful right now. See benchmarks.txt for specifics.

I strongly suggest installing and using SVGO to optimize SVG files before use.

HISTORY

The initial version of the code is a modified version of SavageSVG

Subsequent versions offer major improvements in memory usage (as much as 500:1 in some extreme cases), though I have yet to appreciably improve either parsing or rendering times on hardware that isn’t heavily memory-bound.

LICENSE

I’m having trouble tracking down a copy of the original code, but I specifically sought out a solution that was usable in binary-only distributions and had been conversing with SavageSVG’s author at the time this code was originally put together; it is almost certain that it is usable commercially, but I will sort out the specifics ASAP.

TODO

Please note that it is unlikely I will have time to do much of this, these are merely the things I see as necessary to achieving the goals above. I post this with my minor improvements for the daring to dabble with, and am willing to accept pull requests.

  • Serious performance optimizations, and further work on memory reduction. Some operations seem disproportionately slow, such as rendering of arc segments.
  • See about reusing relevant Unity classes (Vector2, Rect) where appropriate.
  • Document which variant/version of the SVG spec we most closely match, and significant deviations from it.
  • Rigorous regression/compatibility/performance testing (automated, of course). See:
  • Refactor the document model code to be cleanly / easily usable independent of an actual XML document.
  • Separate XML (and attribute!) parser that uses the SVG DOM API we construct.
  • Some support for foreignObjects to allow blending in noise textures and whatnot. (Definitely want to use GPU compositing for this…)
  • Use coroutines or threads (or a combination thereof) to make the rendering process be non-blocking.

PIE-IN-THE-SKY-TODO

  • See about using GPU for some operations? (Compositing, etc…)
  • See about implementing primitives like rendering of path segments and such on the GPU?

About

SVG renderer for Unity3D.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C# 100.0%