nsvg 0.2.1

A simple SVG parser and rasterizer using NanoSVG
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

# NSVG

A friendly Rust wrapper around the excellent NanoSVG C library. Offering simple SVG parsing and rasterizing.

Does not provide all the functionality of NanoSVG yet. Just the bare minimum to create scaled rasters of SVGs.

Like NanoSVG, the rasteriser only renders flat filled shapes. It is not particularly fast or accurate, but it is a simple way to bake vector graphics into textures.

https://github.com/memononen/nanosvg

https://github.com/rezrov/libnanosvg

# Usage

Include `nsvg` in your `Cargo.toml` dependencies.

```toml
[dependencies]
nsvg = "0.2.1"
```

Now you can parse and rasterize SVGs. Use the scale argument to producer larger or smaller rasterised images. The aspect ratio will remain the same.

This can be useful to create rasters to suit high resolution displays.

```rust
extern crate nsvg;

let svg = nsvg::parse_file("my.svg", "px", 96.0);
let scale = 2.0;
let image = nsvg::rasterize(svg, scale);

```

# Developing

By default nsvg will use prebuilt FFI bindings, but you can regenerate them manually by running:

```
cargo build --features bindgen
```

Which will also copy the bindings into the `src` directory. If the bindings need to be updated (when upgrading NanoSVG, for example) they should be checked in to version control.

Make sure you have `libclang-dev` available so bindgen works.

`cargo test` to run tests.

There is one provided example, which you can run with the following command:
```
cargo run --example svg_to_png
```

This will convert the `spiral.svg` vector into a PNG. The PNG will be written to the working directory as `spiral_output.png`.

# License

NanoSVG is licensed under [zlib license](lib/LICENSE.txt)

Anything else is MIT