SVG Kit for Android

SVG Kit for Android is a flexible and quite fast library supporting SVG Tiny specs.

Every time you need to paint some icons, backgrounds, charts, document pages, diagrams in vector format, you need a way to do this easily and possibly without NDK, cross-compilation issues, reducing performance, etc. The amazing library developed by our company just do it: no extra code, no extra libraries, no tuning.

Why SVG Kit for Android

We have evaluated a lot of libraries, many of which were either too slow but over-featured (like the legendary Apache Batik) or too complicated in maintenance (like NDK, librsvg and issues with the proper compilation for all supported platforms and architectures). We just wanted to show the vector background.

So, we have decided to make our own library. And even more, we have added a few abilities that are not supported by “huge” libraries. Even, radial gradients are supported in our library.

We tried to make it as small as possible; no advanced features from SVG 1.2 Full specs are supported. We suppose we don’t need animations, compositions, JavaScript or user input, we want to use just vector background or icon.

 

 

Main features

To summarize, now we have:

  • Pretty small.
  • Pure Java.
  • Reliable and fast.
  • CSS support.
  • Gradients (including radial), transformations and paints.
  • Fonts, texts and text spans.
  • Drawing primitives, paths and polygons.
  • Strokes and fills, including alpha, dashes, joins and other.
  • XLink support included.
  • Raster images in SVG support (external, from assets or embedded).
  • SVG filters initial support.
  • SVG and SVGZ support.

Moreover, we have tested huge SVG files with dozens of megabytes each. Depending on the SVG files and transport (local or from Internet) it might be “pretty fast” or “acceptable”, but it really works in all cases.

The following features are not supported:

  • Declarative animation for SVG.
  • Interactive and dynamic SVG documents.
  • JavaScript.
  • Raster images in strange formats.
  • HTML tags around.

It is just a small, fast and easy-to-use library which was designed to support “pure vector” icons, backgrounds and etc. No overloading on this stage. In case anybody requests it – our team will expand the library according their needs. It’s not a big problem for our team.

Screenshots

Tutorial

Getting started

The core of the library is “libsvg.aar”. It does everything from fast SAX-based parsing, rendering .svg files for Android at the bitmaps and surfaces, computers corresponding CSS styles defined in .svg and more.
It provides an API (primarily SVGHelper class) to operate with files in a typical stream-like manner.

Libsvg.aar supports many graphical features defined in SVG 1.1 and SVG 1.2. But it is intended to render only static images without animation, filters and custom SVG fonts.

The feature list includes:

  • Drawing shapes (ellipse, circle, polyline, polygone, rect, line etc.),
  • Drawing gradients (except focus points in radial gradients),
  • Drawing path elements, but without markers,
  • Drawing text elements, currently working only with standard android fonts,
  • Supported such elements as: <g>, <defs>, <use>.

The list of implemented features is not so big, but it is more than enough to paint most of typical SVG files.

SVGHelper: parse and get suitable result

To use this helper, just follow through the list below in top-down order.

  1. Add “libsvg.aar” in your project.
  2. Choose SVG source:
    • From file:
      SVGHelper.noContext().open(new File(...));
    • From resources (works only with context, useContext(…) is necessary):
      SVGHelper.useContext(context).open(R.raw.svg_file);
    • From web:
      SVGHelper.noContext().open(new URL(...));
    • Set SVG code directly: SVGHelper.noContext().open(“<svg> any svg source code </svg>”);
  3. Determine SVG document size (if necessary). This option is required if original SVG image has no width/height and viewport attributes.
    • SVGHelper.noContext().open(...).setBaseBounds(300, 400);

      define sizes

    • Or let library compute itself (if SVG has width/height definition),
    • SVGHelper.noContext().open(...).checkSVGSize();

      Note: might add extra performance penalty.

  4. Choosing svg transform (if necessary).
    • Set scale directly: SVGHelper.noContext().open(...).setScale(1.7f);
    • Or set result bounds:
      SVGHelper.noContext().open(...).setRequestBounds(1024, 768);
  5. Additional SVG transform options.
    • Set keep aspect ratio option (by default true).
    • SVGHelper.noContext().open(...).setKeepAspectRatio(false);
    • Set crop image option (by default false)
      SVGHelper.noContext().open(...).setCropImage(true);
  6. Choose result type.
    • Bitmap:
      SVGHelper.noContext().open(...).getBitmap();
    • BitmapDrawable:
      SVGHelper.useContext(context).open(...).getBitmapDrawable();
    • Bitmap as background of any View:
      SVGHelper.useContext(context).open(...).bitmapAsBackground(view);
    • Picture:
      SVGHelper.noContext().open(...).getPicture();
    • PictureDrawable:
      SVGHelper..noContext().open(...).getPictureDrawable();
    • Picture as stretch background of any View:
      SVGHelper.noContext().open(...).pictureAsBackground(view);

A few examples:

  • SVG from resource as button background:
    SVGHelper.useContext(context).open(R.raw.svg).bitmapAsBackground(button);
  • Scaled SVG file as Bitmap:
    SVGHelper.noContext().open(file).setScale(2f).getBitmap();
  • SVG from URL, determine its size and get it as 100×100 Bitmap:
    SVGHelper.noContext().open(url).checkSVGSize().setRequestBounds(100,100).getBitmap();

Downloads

This library is provided “AS IS” under terms of the GPLv3. In case you need it under another (for example, commercial) license, please contact us using the contact form. Commercial support is available as well.

1. SVG Kit for Android library (libsvg.aar and sources libsvg.zip).
2. Demo application indicating how long the image is handled at your device (showsvg.apk).
3. Sample describing how to load SVG files from different resources (svg_from_different_sources_sample.apk ) and source (svg_from_different_sources_sample.zip).
4. Sample describing how to use SVG as the background (svgresize_and_background_sample.apk ) and source (svgresize_and_background_sample.zip).
5. JavaDocs (libsvg-JavaDoc.zip).

Customization

You can request any specific features you need — and order the development of your own custom solution, fast and cost-effective

Require a similar product development?

Support

Browse
Attachment: filename ×

Thank you for your interest in our products! We have received your message and will reply to you as soon as possible. Please check your mailbox for a confirmation letter from us.