broccoli-rsvg

broccoli-rsvg

This Broccoli plugin renders SVG files to PNG using node-rsvg.

Installation

First, get librsvg:

• OS X: brew install librsvg
• FreeBSD: pkg install graphics/librsvg2
• Ubuntu/Debian: sudo apt-get install librsvg2-dev
• Fedora/CentOS/OpenSUSE: sudo yum install librsvg2-devel

Second, install as any other broccoli plugin:

export PKG_CONFIG_PATH=/opt/X11/lib/pkgconfig # on OS X
npm install --save-dev broccoli-rsvg

Usage

var renderSvg = require('broccoli-rsvg');

var outputTree = renderSvg(inputTree, fileOptions);

• inputTree: A tree that contains the SVG files you want to render.
• fileOptions: A hash of rsvg options and alternative versions for each file; see the following example.

Example

var renderSvg = require('broccoli-rsvg');

var png = renderSvg("svg", {
  'logo.svg': {
    width: 600,
    height: 500, // optional override, values from the svg file itself are used by default
    versions: [
      { // Retina version example
        path: '[e-mail]',
        width: 1200,
        height: 1000
      },
      { // Transformed version example
        transformer: function(svg) {
          return svg.replace('#000000', '#ffffff'); // You can use elementtree or xmldom here...
        },
        path: 'logo-black.png',
        versions: [
          { // Nested example: transformed + retina
            path: '[e-mail]',
            width: 1200,
            height: 1000
          }
        ]
      }
    ]
  }
});

return [svg, png];

Note: do not pass broccoli-svgo output to rsvg, it might get screwed up.

License

Copyright 2014 Greg V <[e-mail]>

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.