SVG-Kit für Android

Erste Schritte

Der Kern der Bibliothek ist „libsvg.aar“. Sie macht alles von schnellem SAX-basiertem Parsing, Rendering von .svg-Dateien für Android bei den Bitmaps und Oberflächen, Computern entsprechend in .svg definierte CSS-Stile und mehr. Das bietet eine API (in erster Linie SVGHelper Klasse), um mit Dateien in einer typischen Stream-ähnlichen Weise zu arbeiten.

Libsvg.aar unterstützt viele grafische Funktionen, die in SVG 1.1 und SVG 1.2 definiert sind. Aber es ist vorgesehen, nur statische Bilder ohne Animation, Filter und benutzerdefinierte SVG-Schriftarten zu bearbeiten.

Die Liste der Funktionen umfasst:

Zeichnen von Formen (Ellipse, Kreis, Polylinie, Viereck, Rechteck, Linie, usw.),

Zeichnen von Gradients (mit Ausnahme der Fokuspunkte in radialen Gradienten),

Zeichnen von Pfadelementen, aber ohne Markierungen,

Zeichnen von Textelementen, funktioniert derzeit nur mit Standard-Android-Schriften,

Unterstützt werden solche Elemente wie <g>, <defs>, <use>.

Die Liste der implementierten Funktionen ist nicht sehr lang, aber mehr als genug, um die meisten typischen SVG-Dateien zu malen.

SVGHelper: parse and get suitable result

Um dieses Hilfsmittel zu verwenden, gehen Sie einfach die folgende Liste von oben nach unten durch.

1. Fügen Sie „libsvg.aar“ in Ihr Projekt ein.

2. Wählen Sie die SVG-Quelle:

Aus der Datei:

SVGHelper.noContext().open(new File(...));

Aus Ressourcen (funktioniert nur mit Kontext, useContext(…) ist notwendig):

SVGHelper.useContext(context).open(R.raw.svg_file);

Aus dem Web:

SVGHelper.noContext().open(new URL(...));

SVG-Code direkt einstellen:

SVGHelper.noContext().open(“<svg> any svg source code </svg>”);

3. Bestimmen Sie die Größe des SVG-Dokuments (falls erforderlich). Diese Option ist erforderlich, wenn das ursprüngliche SVG-Bild keine Breiten-/Höhen- und Viewport-Attribute hat.

Definieren Sie Größen:

SVGHelper.noContext().open(...).setBaseBounds(300, 400);

Oder lassen Sie die Bibliothek selbst berechnen (wenn SVG eine Breiten-/Höhen-Definition hat),

SVGHelper.noContext().open(...).checkSVGSize();

Hinweis: Dies kann zu zusätzlichen Leistungseinbußen führen.

4. Auswahl der SVG-Transformation (falls erforderlich).

Skala direkt einstellen:

SVGHelper.noContext().open(...).setScale(1.7f);

Oder setzen Sie Ergebnisgrenzen:

SVGHelper.noContext().open(...).setRequestBounds(1024, 768);

5. Additional SVG transform options.

Legen Sie die Option Seitenverhältnis beibehalten fest (standardmäßig true):

SVGHelper.noContext().open(...).setKeepAspectRatio(false); 

Legen Sie die Option Bild zuschneiden fest (standardmäßig falsch):

SVGHelper.noContext().open(...).setCropImage(true);

6. Wählen Sie den Ergebnistyp.

Bitmap:

SVGHelper.noContext().open(...).getBitmap();

BitmapDrawable:

SVGHelper.useContext(context).open(...).getBitmapDrawable();

Bitmap als Hintergrund einer beliebigen Ansicht:

SVGHelper.useContext(context).open(...).bitmapAsBackground(view);

Bild:

SVGHelper.noContext().open(...).getPicture();

BildDrawable:

SVGHelper.noContext().open(...).getPictureDrawable();

Bild als Stretch-Hintergrund einer beliebigen Ansicht:

SVGHelper.noContext().open(...).pictureAsBackground(view);

Hier ein paar Beispiele:

SVG aus der Ressource als Schaltflächenhintergrund:

SVGHelper.useContext(context).open(R.raw.svg).bitmapAsBackground(button);

Skalierte SVG-Datei als Bitmap:

SVGHelper.noContext().open(file).setScale(2f).getBitmap();

SVG von der URL, bestimmen Sie seine Größe und erhalten Sie es als 100×100 Bitmap:

SVGHelper.noContext().open(url).checkSVGSize().setRequestBounds(100,100).getBitmap();