Skip to content
Javascript SVG parser and renderer on Canvas
TypeScript JavaScript HTML Other
Branch: master
Clone or download
Latest commit 22ad647 Jan 28, 2020
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs 3.0.4 (#884) Jan 7, 2020
scripts eject trigen-scripts Oct 30, 2019
src use bind to undefined Jan 27, 2020
test new snapshots Jan 5, 2020
types/rgbcolor ts Oct 2, 2019
.babelrc ts Oct 2, 2019
.browserslistrc ts Oct 2, 2019
.clean-publish ts Oct 2, 2019
.editorconfig ts Oct 2, 2019
.eslintrc ts Oct 2, 2019
.gitignore ts Oct 2, 2019
.huskyrc ts Oct 2, 2019
.lintstagedrc merge in #749 Nov 2, 2019
.size-limit Bump rollup from 1.27.14 to 1.28.0 (#877) Jan 6, 2020
.travis.yml new snapshots Jan 5, 2020
CHANGELOG.md v3.0.1 Dec 4, 2019
LICENSE TrigenSoftware/flexis-canvg -> canvg/canvg Oct 22, 2019
README.md 3.0.4 (#884) Jan 7, 2020
jest.config.json ts Oct 2, 2019
lgtm.yml - Add lgtm.yml Oct 25, 2019
package.json Bump babel-jest from 24.9.0 to 25.1.0 (#920) Jan 27, 2020
rollup.config.js - npm: Switch from deprecated `rollup-plugin-node-resolve` to recomme… Dec 17, 2019
tsconfig.dev.json ts Oct 2, 2019
tsconfig.json Enhancement/9 (#10) Oct 14, 2019
tslint.json ts Oct 2, 2019
yarn.lock Bump babel-jest from 24.9.0 to 25.1.0 (#920) Jan 27, 2020

README.md

canvg

NPM version Dependencies status Build status Coverage status Dependabot badge Documentation badge

JavaScript SVG parser and renderer on Canvas. It takes the URL to the SVG file or the text of the SVG file, parses it in JavaScript and renders the result on Canvas.

Demo

Playground

Install

npm i canvg
# or
yarn add canvg

Usage

Basic module exports:

export default Canvg;
export {
    presets
};

Description of all exports you can find in Documentation.

Example

import Canvg from 'canvg';

let v = null;

window.onload = async () => {

    const canvas = document.querySelector('canvas');
    const ctx = canvas.getContext('2d');
    
    v = await Canvg.from(ctx, './svgs/1.svg');

    // Start SVG rendering with animations and mouse handling.
    v.start();
};

window.onbeforeunload = () => {
    v.stop();
};
OffscreenCanvas
import Canvg, {
    presets
} from 'canvg';

self.onmessage = async (event) => {

    const {
        width,
        height,
        svg
    } = event.data;
    const canvas = new OffscreenCanvas(width, height);
    const ctx = canvas.getContext('2d');
    const v = await Canvg.from(ctx, svg, presets.offscreen());

    // Render only first frame, ignoring animations and mouse.
    await v.render();

    const blob = await canvas.convertToBlob();
    const pngUrl = URL.createObjectURL(blob);

    self.postMessage({
        pngUrl
    });
};
NodeJS
import {
    promises as fs
} from 'fs';
import {
    DOMParser
} from 'xmldom';
import * as canvas from 'canvas';
import fetch from 'node-fetch';
import Canvg, {
    presets
} from 'canvg';

const preset = presets.node({
    DOMParser,
    canvas,
    fetch
});

(async (output, input) => {

    const svg = await fs.readFile(input, 'utf8');
    const canvas = preset.createCanvas(800, 600);
    const ctx = canvas.getContext('2d');
    const v = Canvg.fromString(ctx, svg, preset);

    // Render only first frame, ignoring animations.
    await v.render();

    const png = canvas.toBuffer();

    await fs.writeFile(output, png);

})(
    process.argv.pop(),
    process.argv.pop()
);
Resize
import Canvg, {
    presets
} from 'canvg';

self.onmessage = async (event) => {

    const {
        width,
        height,
        svg
    } = event.data;
    const canvas = new OffscreenCanvas(width, height);
    const ctx = canvas.getContext('2d');
    const v = await Canvg.from(ctx, svg, presets.offscreen());

    /**
     * Resize SVG to fit in given size.
     * @param width
     * @param height
     * @param preserveAspectRatio
     */
    v.resize(width, height, 'xMidYMid meet');

    // Render only first frame, ignoring animations and mouse.
    await v.render();

    const blob = await canvas.convertToBlob();
    const pngUrl = URL.createObjectURL(blob);

    self.postMessage({
        pngUrl
    });
};
Browser
<script type="text/javascript" src="https://unpkg.com/canvg@3.0.4/lib/umd.js"></script>
<script type="text/javascript">
window.onload = () => {

    const canvas = document.querySelector('canvas');
    const ctx = canvas.getContext('2d');
    
    v = canvg.Canvg.fromString(ctx, '<svg width="600" height="600"><text x="50" y="50">Hello World!</text></svg>');

    // Start SVG rendering with animations and mouse handling.
    v.start();

};
</script>
<canvas />

Options

The third parameter of new Canvg(...), Canvg.from(...) and Canvg.fromString(...) is options:

interface IOptions {
    /**
     * WHATWG-compatible `fetch` function.
     */
    fetch?: typeof fetch;
    /**
     * XML/HTML parser from string into DOM Document.
     */
    DOMParser?: typeof DOMParser;
    /**
     * Window object.
     */
    window?: Window;
    /**
     * Whether enable the redraw.
     */
    enableRedraw?: boolean;
    /**
     * Ignore mouse events.
     */
    ignoreMouse?: boolean;
    /**
     * Ignore animations.
     */
    ignoreAnimation?: boolean;
    /**
     * Does not try to resize canvas.
     */
    ignoreDimensions?: boolean;
    /**
     * Does not clear canvas.
     */
    ignoreClear?: boolean;
    /**
     * Scales horizontally to width.
     */
    scaleWidth?: number;
    /**
     * Scales vertically to height.
     */
    scaleHeight?: number;
    /**
     * Draws at a x offset.
     */
    offsetX?: number;
    /**
     * Draws at a y offset.
     */
    offsetY?: number;
    /**
     * Will call the function on every frame, if it returns true, will redraw.
     */
    forceRedraw?(): boolean;
    /**
     * Default `rem` size.
     */
    rootEmSize?: number;
    /**
     * Default `em` size.
     */
    emSize?: number;
    /**
     * Function to create new canvas.
     */
    createCanvas?: (width: number, height: number) => HTMLCanvasElement | OffscreenCanvas;
    /**
     * Function to create new image.
     */
    createImage?: (src: string, anonymousCrossOrigin?: boolean) => Promise<CanvasImageSource>;
    /**
     * Load images anonymously.
     */
    anonymousCrossOrigin?: boolean;
}

Options presets

There are two options presets:

  • presets.offscreen(): options for OffscreenCanvas;
  • presets.node({ DOMParser, canvas, fetch }): options for NodeJS with node-canvas.

What's implemented?

The end goal is everything from the SVG spec. The majority of the rendering and animation is working. If you would like to see a feature implemented, don't hesitate to add it to the issues list, or better is to create pull request 😎

You can’t perform that action at this time.