com.pixplicity.sharp

Class Sharp

java.lang.Object

com.pixplicity.sharp.Sharp

public abstract class Sharp
extends java.lang.Object

Entry point for parsing SVG files for Android. Use one of the various static methods for parsing SVGs by resource, asset or input stream. Optionally, a single color can be searched and replaced in the SVG while parsing. You can also parse an svg path directly.

See Also:

loadResource(android.content.res.Resources, int), loadAsset(android.content.res.AssetManager, String), loadString(String), loadInputStream(java.io.InputStream), loadPath(String)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	Sharp.DrawableCallback
static interface	Sharp.PictureCallback
static class	Sharp.SvgHandler

Method Summary

Modifier and Type	Method and Description
static void	checkAssumedUnits(java.lang.String unit)
protected abstract void	close(java.io.InputStream inputStream)
SharpDrawable	getDrawable() Processes the SVG and provides the resulting drawable.
SharpDrawable	getDrawable(android.view.View view) Deprecated. Use getDrawable() instead.
void	getDrawable(android.view.View view, Sharp.DrawableCallback callback) Processes the SVG and provides the resulting drawable.
protected abstract java.io.InputStream	getInputStream()
SharpPicture	getSharpPicture()
void	getSharpPicture(Sharp.PictureCallback callback)
void	into(android.view.View view)
static Sharp	loadAsset(android.content.res.AssetManager assetMngr, java.lang.String svgPath) Parse SVG data from an Android application asset.
static Sharp	loadFile(java.io.File imageFile) Parse SVG data from a file.
static Sharp	loadInputStream(java.io.InputStream svgData) Parse SVG data from an input stream.
static android.graphics.Path	loadPath(java.lang.String pathString) Parses a single SVG path and returns it as a android.graphics.Path object.
static Sharp	loadResource(android.content.res.Resources resources, int resId) Parse SVG data from an Android application resource.
static Sharp	loadString(java.lang.String svgData) Parse SVG data from a text.
static void	prepareTexts(java.util.HashMap<java.lang.String,java.lang.String> texts)
Sharp	setOnElementListener(OnSvgElementListener onElementListener)
Sharp	withAssets(android.content.res.AssetManager assetManager)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

prepareTexts

public static void prepareTexts(java.util.HashMap<java.lang.String,java.lang.String> texts)

loadInputStream

public static Sharp loadInputStream(java.io.InputStream svgData)

Parse SVG data from an input stream.

Parameters:

svgData - the input stream, with SVG XML data in UTF-8 character encoding.

Returns:

this Sharp object

loadString

public static Sharp loadString(java.lang.String svgData)

Parse SVG data from a text.

Parameters:

svgData - the text containing SVG XML data.

Returns:

this Sharp object

loadResource

public static Sharp loadResource(android.content.res.Resources resources,
                                 int resId)

Parse SVG data from an Android application resource.

Parameters:

resources - the Android context resources.

resId - the ID of the raw resource SVG.

Returns:

this Sharp object

loadAsset

public static Sharp loadAsset(android.content.res.AssetManager assetMngr,
                              java.lang.String svgPath)

Parse SVG data from an Android application asset.

Parameters:

assetMngr - the Android asset manager.

svgPath - the path to the SVG file in the application's assets.

Returns:

this Sharp object

loadFile

public static Sharp loadFile(java.io.File imageFile)

Parse SVG data from a file.

Parameters:

imageFile - the input stream, with SVG XML data in UTF-8 character encoding.

Returns:

this Sharp object

loadPath

public static android.graphics.Path loadPath(java.lang.String pathString)

Parses a single SVG path and returns it as a android.graphics.Path object. An example path is M250,150L150,350L350,350Z, which draws a triangle.

Parameters:

pathString - the SVG path, see the specification here.

setOnElementListener

public Sharp setOnElementListener(OnSvgElementListener onElementListener)

getInputStream

protected abstract java.io.InputStream getInputStream()
                                               throws java.io.IOException

Throws:

java.io.IOException

close

protected abstract void close(java.io.InputStream inputStream)
                       throws java.io.IOException

Throws:

java.io.IOException

withAssets

public Sharp withAssets(android.content.res.AssetManager assetManager)

into

public void into(android.view.View view)

getDrawable

public SharpDrawable getDrawable()

Processes the SVG and provides the resulting drawable. Runs on the main thread.

getDrawable

@Deprecated
public SharpDrawable getDrawable(android.view.View view)

Deprecated. Use getDrawable() instead.

Processes the SVG and provides the resulting drawable. Runs on the main thread.

getDrawable

public void getDrawable(android.view.View view,
                        Sharp.DrawableCallback callback)

Processes the SVG and provides the resulting drawable. Runs in a background thread.

getSharpPicture

public SharpPicture getSharpPicture()
                             throws SvgParseException

Throws:

SvgParseException

getSharpPicture

public void getSharpPicture(Sharp.PictureCallback callback)

checkAssumedUnits

public static void checkAssumedUnits(java.lang.String unit)