Merge pull request gliffy#2 from gliffy/master

Merge v1.0.19

.gitignore

@@ -1 +1,3 @@
-.idea/
+.idea/
+.node_modules/
+node_modules/

.travis.yml

@@ -0,0 +1,6 @@
+language: node_js
+node_js:
+  - "0.10"
+before_script:
+  - export DISPLAY=:99.0
+  - sh -e /etc/init.d/xvfb start

README.md

@@ -1,6 +1,7 @@
-Canvas2Svg
+Canvas2Svg [![Build Status](https://travis-ci.org/gliffy/canvas2svg.svg?branch=master)](https://travis-ci.org/gliffy/canvas2svg)
 ==========
-This library turns your Canvas into SVG using javascript. In other words, this library lets you build an SVG document using the canvas api. Why use it?
+This library turns your Canvas into SVG using javascript. In other words, this library lets you build an SVG document 
+using the canvas api. Why use it?
 * You have a canvas drawing you want to persist as an SVG file.
 * You like exporting things.
 * Because you didn't want to transform your custom file format to SVG.
@@ -11,7 +12,8 @@ http://gliffy.github.io/canvas2svg/
 
 How it works
 ==========
-We create a mock 2d canvas context. Use the canvas context like you would on a normal canvas. As you call methods, we build up a scene graph in SVG. Yay!
+We create a mock 2d canvas context. Use the canvas context like you would on a normal canvas. As you call methods, we 
+build up a scene graph in SVG. Yay!
 
 Usage
 ==========
@@ -31,8 +33,83 @@ var mySerializedSVG = ctx.getSerializedSvg(); //true here, if you need to conver
 var svg = ctx.getSvg();
 ```
 
+Tests
+==========
+To run tests:
+```
+npm install
+npm test
+```
+
+To run tests against Chrome and Firefox, call karma directly. This is not the default npm test due to the limited 
+browser selection in travis.
+```
+npm install karma-cli -g
+karma start
+```
+
+Debug
+=========
+Play with canvas2svg in the provided test/playground.html or run test locally in your browser in test/testrunner.html
+
+
+Add An Example Case
+=========
+Add a test file to the test/example folder. In your file make sure to add the drawing function to the global `C2S_EXAMPLES`,
+with your filename as a key. For example `test\example\linewidth.js` should look something like:
+```javascript
+window.C2S_EXAMPLES['linewidth'] = function(ctx) {
+    for (var i = 0; i < 10; i++){
+        ctx.lineWidth = 1+i;
+        ctx.beginPath();
+        ctx.moveTo(5+i*14,5);
+        ctx.lineTo(5+i*14,140);
+        ctx.stroke();
+    }
+};
+```
+install gulp globally if you haven't done so already
+```
+npm install -g gulp
+```
+Then run the following to update playground.html and testrunner.html 
+```
+gulp
+```
+You should now be able to select your new example from playground.html or see it run in testrunner.html 
+
+If you find a bug, or want to add functionality, please add a new test case and include it with your pull request.
+
+Using with node.js
+==================
+
+You can use `canvas2svg` with node.js using [jsdom](https://github.com/tmpvar/jsdom) with [node-canvas](https://github.com/Automattic/node-canvas). To do this first create a new document object, and then create a new instance of `C2S` based on that document:
+
+```javascript
+var canvas = require('canvas'),
+    jsdom = require('jsdom'),
+    C2S = require('canvas2svg');
+
+var document = jsdom.jsdom();
+var ctx = new C2S({document: document});
+
+// ... drawing code goes here ...
+```
+
+N.B. You may not need node-canvas for some simple operations when using jsdom >= 6.3.0, but it's still recommended that you install it.
+
 Updates
 ==========
+- v1.0.19 Fix __parseFont to not crash
+- v1.0.18 clip was not working, the path never made it to the clip area
+- v1.0.17 Fix bug with drawing in an empty context. Fix image translation problem. Fix globalAlpha issue.
+- v1.0.16 Add npm publishing support, bower file and optimize for arcs with no angles.
+- v1.0.15 Setup travis, add testharness and debug playground, and fix regression for __createElement refactor
+- v1.0.14 bugfix for gradients, move __createElement to scoped createElement function, so all classes have access. 
+- v1.0.13 set paint order before stroke and fill to make them behavior like canvas
+- v1.0.12 Implementation of ctx.prototype.arcTo.
+- v1.0.11 call lineTo instead moveTo in ctx.arc, fixes closePath issue and straight line issue
+- v1.0.10 when lineTo called, use M instead of L unless subpath exists
 - v1.0.9 use currentDefaultPath instead of <path>'s d attribute, fixes stroke's different behavior in SVG and canvas.
 - v1.0.8 reusing __createElement and adding a properties undefined check
 - v1.0.7 fixes for multiple transforms and fills and better text support from stafyniaksacha
@@ -48,6 +125,17 @@ Misc
 ==========
 Some canvas 2d context methods are not implemented yet. Watch out for setTransform and arcTo.
 
+Releasing
+=========
+
+To release a new version:
+
+* Run `gulp bump` to update the version number
+* Add a new entry to the [Updates](#Updates) table
+* `git commit -am v1.0.xx`
+* `git push`
+* `npm publish`
+
 License
 ==========
 This library is licensed under the MIT license.

bower.json

@@ -0,0 +1,5 @@
+{
+    "name": "canvas2svg",
+    "version": "1.0.19",
+    "main": "./canvas2svg.js"
+}