Java binding

SVGAssets svg = < instantiate AmanithSVG >;
String xml = new String(Files.readAllBytes(Paths.get("animals.svg")));
SVGDocument doc = svg.createDocument(xml);

< do something with document >

/* release AmanithSVG */
svg.dispose();

/* 
    AmanithSVG document handle (read only); it's the handle created by the low level
    svgtDocCreate function.
*/
SVGTHandle getHandle();

/*
    SVG content itself optionally can provide information about the appropriate
    viewport region for the content via the 'width' and 'height' XML attributes
    on the outermost <svg> element.
    Use this method to get the suggested viewport width, in pixels.

    It returns a negative number (i.e. an invalid width) in the following cases:
    - outermost element is not an <svg> element
    - outermost <svg> element doesn't have a 'width' attribute specified
    - outermost <svg> element has a negative 'width' attribute specified
      (e.g. width="-50")
    - outermost <svg> element has a 'width' attribute specified in relative measure
      units (i.e. em, ex, % percentage)
*/
float getWidth();

/*
    SVG content itself optionally can provide information about the appropriate
    viewport region for the content via the 'width' and 'height' XML attributes
    on the outermost <svg> element.
    Use this method to get the suggested viewport height, in pixels.

    It returns a negative number (i.e. an invalid height) in the following cases:
    - outermost element is not an <svg> element
    - outermost <svg> element doesn't have a 'height' attribute specified
    - outermost <svg> element has a negative 'height' attribute specified
      (e.g. height="-30")
    - outermost <svg> element has a 'height' attribute specified in relative measure
      units (i.e. em, ex, % percentage)
*/
float getHeight();

/*
    The document (logical) viewport to map onto the destination (drawing surface)
    viewport.
    When an SVG document has been created through the SVGAssets.createDocument
    function, the initial value of its viewport is equal to the 'viewBox' attribute
    present in the outermost <svg> element.
*/
SVGViewport getViewport();

/*
    Viewport aspect ratio.
    The alignment parameter indicates whether to force uniform scaling and, if so,
    the alignment method to use in case the aspect ratio of the document viewport
    doesn't match the aspect ratio of the surface viewport.
*/
SVGAlignment getAspectRatio();

/* Set a new alignment for the document viewport. */
void setAspectRatio(SVGAlignment aspectRatio);

/* Set a new viewport for the document. */
void setViewport(SVGViewport viewport);

/*
    AmanithSVG surface handle (read only); it's the handle created by the low level
    svgtSurfaceCreate function.
*/
SVGTHandle getHandle();

/* Get current surface width, in pixels. */
int getWidth();

/* Get current surface height, in pixels. */
int getHeight();

/*
    The surface viewport (i.e. a drawing surface rectangular area), where to map
    the source document viewport.
    The combined use of surface and document viewport, induces a transformation
    matrix, that will be used to draw the whole SVG document. The induced matrix
    grants that the document viewport is mapped onto the surface viewport
    (respecting the specified alignment): all SVG content will be drawn accordingly.
*/
SVGViewport getViewport();

/*
    Resize the surface, specifying new dimensions in pixels; it returns
    SVGTError.None if the operation was completed successfully, else an error code.
    After resizing, the surface viewport will be reset to the whole surface.
*/
SVGTError resize(int newWidth,
                 int newHeight);

/*
    Draw an SVG document, on this drawing surface.
    First the drawing surface is cleared if a valid (i.e. not null) clear color
    is provided. Then the specified document, if valid, is drawn.
    It returns SVGTError.None if the operation was completed successfully, else
    an error code.
*/
SVGTError draw(SVGDocument document,
               SVGColor clearColor,
               SVGTRenderingQuality renderingQuality);

SVGAssets svg = < instantiate AmanithSVG >;
/* load an SVG file */
String xml = new String(Files.readAllBytes(Paths.get("animals.svg")));
SVGDocument doc = svg.createDocument(xml);

/* create a 512x512 drawing surface */
SVGSurface srf = svg.createSurface(512, 512);

/* draw the SVG */
srf.draw(doc, SVGColor.White, SVGTRenderingQuality.Better);
< do something with surface pixels (e.g. upload pixels to a GPU texture) >

/* destroy surface and document */
doc.dispose();
srf.dispose();
/* release AmanithSVG */
svg.dispose();

SVGAssets svg = < instantiate AmanithSVG >;
/* load SVG files */
SVGDocument doc1 = svg.createDocument(new String(Files.readAllBytes(Paths.get("car_coolant.svg"))));
SVGDocument doc2 = svg.createDocument(new String(Files.readAllBytes(Paths.get("car_maintenance.svg"))));
SVGDocument doc3 = svg.createDocument(new String(Files.readAllBytes(Paths.get("car_brake.svg"))));
SVGDocument doc4 = svg.createDocument(new String(Files.readAllBytes(Paths.get("car_oil.svg"))));

/* create a drawing surface */
SVGSurface srf = svg.createSurface(512, 512);

/* select an upper-left sub-region and draw the first SVG document */
srf.setViewport(new SVGViewport(0, 0, 256, 256));
srf.draw(doc1, SVGColor.White, SVGTRenderingQuality.Better);

/* select an upper-right sub-region and draw the second SVG document */
srf.setViewport(new SVGViewport(256, 0, 256, 256));
srf.draw(doc2, null, SVGTRenderingQuality.Better);

/* select the whole lower-left sub-region and draw the third SVG document */
srf.setViewport(new SVGViewport(0, 256, 256, 256));
srf.draw(doc3, null, SVGTRenderingQuality.Better);

/* select the whole lower-right sub-region and draw the fourth SVG document */
srf.setViewport(new SVGViewport(256, 256, 256, 256));
srf.draw(doc4, null, SVGTRenderingQuality.Better);

< do something with surface pixels (e.g. upload pixels to a GPU texture) >

/* destroy surface and documents */
doc1.dispose();
doc2.dispose();
doc3.dispose();
doc4.dispose();
srf.dispose();
/* release AmanithSVG */
svg.dispose();

SVGAssets svg = < instantiate AmanithSVG >;

/* create an SVG document */
SVGDocument doc = svg.createDocument(new String(Files.readAllBytes(Paths.get("orc.svg"))));

/* initialize the packing process: generate atlases with a maximum 512 pixels dimension and no additional scale */
SVGPacker packer = svg.createPacker(1.0f, 512, 1, false);

if (packer.begin()) {

    int[] info = new int[2];
    // add the document to the packer, and get back the actual number of packed bounding boxes
    packer.add(doc, true, 1.0f, info);

    // info[0] = number of collected bounding boxes
    // info[1] = the actual number of packed bounding boxes
    if ((info == null) || (info[1] != info[0])) {
        System.out.println("Some SVG elements cannot be packed!");
        System.out.println("Specified maximum texture dimensions do not allow to pack all SVG elements");
        // close the packing process without doing anything
        packer.end(false);
    }
    else {
        // finalize the packing process and get back generated bins
        SVGPacker.SVGPackedBin[] bins = packer.end(true);

        for (int i = 0; i < bins.length; ++i) {
            // extract the bin (i.e. get atlas width, height and the number of packed documents/elements)
            SVGPacker.SVGPackedBin bin = bins[i];
            /* create a drawing surface with the same atlas dimension */
            SVGSurface srf = svg.createSurface(bin.Width, bin.Height);
            /* draw all documents/elements over the drawing surface */
            srf.draw(bin, SVGColor.Clear, SVGTRenderingQuality.Better);
            /* if needed, process the drawing surface (e.g. upload its pixels on a GPU texture) and then destroy it */
            < do something with surface pixels (e.g. upload pixels to a GPU texture) >
            /* destroy the surface */
            srf.dispose();
        }
    }
}

/* destroy the document */
doc.dispose();
/* release AmanithSVG */
svg.dispose();

/* Constructor. */
abstract SVGResource(String id,
                     SVGTResourceType type,
                     final EnumSet<SVGTResourceHint> hints);

/* Get input/read stream for the resource. */
abstract InputStream getStream();

/* Resource identifier. */
String _id;

/* Resource type. */
SVGTResourceType _type;

/* Resource hints. */
EnumSet<SVGTResourceHint> _hints;

/*
    Constructor, device screen properties must be supplied
    (with/height in pixels and dpi).
*/
SVGAssetsConfig(int screenWidth,
                int screenHeight,
                float screenDpi);

/* Get screen resolution width, in pixels. */
int getScreenWidth();

/* Get screen resolution height, in pixels. */
int getScreenHeight();

/* Get screen dpi. */
float getScreenDpi();

/*
    Get curves quality, used by AmanithSVG geometric kernel to approximate curves
    with straight line segments (flattening). Valid range is [1; 100], where 100
    represents the best quality.

    A zero or negative value means "keep the default one".
*/
float getCurvesQuality();

/*
    Set curves quality, used by AmanithSVG geometric kernel to approximate curves
    with straight line segments (flattening). Valid range is [1; 100], where 100
    represents the best quality.

    A zero or negative value means "keep the default one".
*/
void setCurvesQuality(float quality);

/* Get user-agent language. */
String getLanguage();

/*
    Set the user-agent language.

    Specify the system/user-agent language; this setting will affect the
    conditional rendering of <switch> elements and elements with
    'systemLanguage' attribute specified. The given argument must be a
    non-empty list of languages separated by semicolon
    (e.g. "en-US;en-GB;it;es")
*/
void setLanguage(String languages);

/* Get log level. */
EnumSet<SVGTLogLevel> getLogLevel();

/* Get log capacity, in characters. */
int getLogCapacity();

/*
    Set log parameters (log level and log capacity).

    If the specified log level is empty, logging is disabled.
    If the specified log capacity (in characters) is less than or equal
    zero, logging is disabled.
*/
void setLogParameters(EnumSet<SVGTLogLevel> logLevel,
                      int logCapacity);

/*
    Get the number of (external) resources provided by this configuration.
    It must be implemented by all derived classes.
*/
abstract int resourcesCount();

/*
    Get a resource given an index.
    If the given index is less than zero or greater or equal to the value
    returned by 'resourcesCount', a null resource is returned.

    It must be implemented by all derived classes.
*/
abstract SVGResource getResource(int index);

/*
    Create a drawing surface, specifying its dimensions in pixels.

    Supplied dimensions should be positive numbers greater than zero, else
    a null instance will be returned.
*/
SVGSurface createSurface(int width,
                         int height);

/*
    Create and load an SVG document, specifying the whole XML string.
    If supplied XML string is null or empty, a null instance will be returned.
*/
SVGDocument createDocument(String xmlText);

/*
    Create an SVG packer, specifying a scale factor.
    
    Every collected SVG document/element will be packed into rectangular bins,
    whose dimensions won't exceed the specified 'maxTexturesDimension' in pixels.

    If true, 'pow2Textures' will force bins to have power-of-two dimensions.
    Each rectangle will be separated from the others by the specified 'border' in pixels.

    The specified 'scale' factor will be applied to all collected SVG documents/elements,
    in order to realize resolution-independent atlases.
*/
SVGPacker createPacker(float scale,
                       int maxTexturesDimension,
                       int border,
                       boolean pow2Textures);

/* Get library version. */
static String getVersion();

/* Get AmanithSVG log content as a string. */
String getLog();

/*
    Clear the AmanithSVG log buffer set for the current thread.

    If specified, make sure AmanithSVG no longer uses a log buffer for
    the current thread. In this case, logging can be reactivated (for
    the calling thread) by calling this method with a 'false' parameter.
*/
SVGTError logClear(boolean stopLogging);

/*
    Append an informational message to the AmanithSVG log buffer
    set for the current thread.
*/
boolean logInfo(String message);

/*
    Append a warning message to the AmanithSVG log buffer
    set for the current thread.
*/
boolean logWarning(String message);

/*
    Append an error message to the AmanithSVG log buffer
    set for the current thread.
*/
boolean logError(String message);

SVGAssets svg = < instantiate AmanithSVG >;

/* clear AmanithSVG log */
svg.logClear(false);

< load SVG, draw it >

/* print AmanithSVG log content, in order to get details on possible warnings/errors */
System.out.println(svg.getLog());

/* make sure AmanithSVG no longer uses a log buffer (i.e. disable logging) */
svg.logClear(true);

/* release AmanithSVG */
svg.dispose();