SVG path operations library


Low level toolkit for svg paths transformations. Sometime you can't use transform attributes and have to apply changes to svg paths directly. Then this package is for you :) !

Note, this package works with paths, not with svg xml sources.

npm install svgpath
var SvgPath = require('svgpath');
var transformedPath = new SvgPath(__your_path__)
  .round(1) // Here the real rounding happens
  .round(1) // Fix js floating point error/garbage after rel()

All methods are chainable (return self).

Constructor. Create SvgPath instance with chainable methods.

Converts all path commands to absolute.

Converts all path commands to relative. Useful to reduce output size.

Rescale path (the same as SVG scale transformation).

Rescale path (the same as SVG scale transformation)

Any SVG transform or their combination. For example rotate(90) scale(2,3). The same format, as described in standard.

Converts smooth curves (T, t, S, s) with missed control point to generic curves.

Returns final path string.

Round all coordinated to given decimal precision. By default round to integer. Useful to reduce resulting string size.

(!) NOTE:

  1. You should apply abs() first, because relative coordinate summarize precision errors.
  2. After .rel() call, your rounded values can be littered with tail like 0.000000000000023. So, you have to call .round(x) again. See example above.

Apply iterator to all path segments. Each iterator receives segment, index, x, y params. Where (x, y) - absolute coordinates of segment start point.

Also, you iterator can return array of new segments, that should replace current one. On empty array current segment will be deleted.

Copyright (c) 2013 Vitaly Puzrin. Released under the MIT license. See LICENSE for details.