{"_id":"caman","_rev":"55-96023603c6ad180be55d29b3ddfa4cef","name":"caman","description":"Javascript (Ca)nvas (Man)ipulation for NodeJS and the browser","dist-tags":{"latest":"4.1.2"},"versions":{"1.0.0":{"name":"caman","version":"1.0.0","description":"Pure Javascript (Ca)nvas (Man)ipulation. Easy to use, but powerful, image manipulation library.","keywords":["canvas","image","manipulate","filter","image manipulation"],"homepage":"http://camanjs.com","author":{"name":"Ryan LeFevre","email":"meltingice8917@gmail.com","url":"http://meltingice.net"},"contributors":[{"name":"Rick Waldron","url":"http://github.com/rwldrn"},{"name":"Cezar Sa Espinola","url":"http://github.com/cezarsa"}],"main":"./dist/caman.full","repository":{"type":"git","url":"http://github.com/meltingice/CamanJS.git"},"dependencies":{"canvas":"*"},"_id":"caman@1.0.0","engines":{"node":"*"},"_engineSupported":true,"_npmVersion":"0.2.18","_nodeVersion":"v0.4.1","directories":{},"files":[""],"_defaultsLoaded":true,"dist":{"shasum":"ce95bef11c5843239bc4346f2c5c8a233ad397da","tarball":"https://registry.npmjs.org/caman/-/caman-1.0.0.tgz","integrity":"sha512-4IR+jmRu1XnD/0psmp/dS/0Ja/+J11fm07nK1bz6sHubC0VkkgaHMfGQUhmThbvtjqiGCrKe0wZaasFJv1xnRg==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIHwxNwEhovzqAZ3EDpTOz2gLIVDl5qs2hzIcPS49Op7pAiEA5AZoNNjgpNGmrsXrpBxIyB5l2/hc0/POUql0dfu4Ztc="}]}},"1.1.0":{"name":"caman","version":"1.1.0","description":"Pure Javascript (Ca)nvas (Man)ipulation. Easy to use, but powerful, image manipulation library.","keywords":["canvas","image","manipulate","filter","image manipulation"],"homepage":"http://camanjs.com","author":{"name":"Ryan LeFevre","email":"meltingice8917@gmail.com","url":"http://meltingice.net"},"contributors":[{"name":"Rick Waldron","url":"http://github.com/rwldrn"},{"name":"Cezar Sa Espinola","url":"http://github.com/cezarsa"}],"main":"./dist/caman.full","repository":{"type":"git","url":"http://github.com/meltingice/CamanJS.git"},"dependencies":{"canvas":"*"},"_id":"caman@1.1.0","engines":{"node":"*"},"_engineSupported":true,"_npmVersion":"0.2.18","_nodeVersion":"v0.4.1","directories":{},"files":[""],"_defaultsLoaded":true,"dist":{"shasum":"c136db32d771c453f83ed88282e72a5329650dd5","tarball":"https://registry.npmjs.org/caman/-/caman-1.1.0.tgz","integrity":"sha512-GktJgegpKLC7f/8sT15QteB1+B86K9wOg6ehZaastd7qPZbFJi8G9jfMX4K/cDDZrYVZjdY/kSS9iZIrvGem7Q==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCLIxSdHjoxh+wJtxR6YBPz2jA9IEx8momVQZBeKg8yJAIhAOz8WCClwnzBslazBNmNPc4+hStcx8Hpho+MU+zlMGGX"}]}},"1.2.0":{"name":"caman","version":"1.2.0","description":"Pure Javascript (Ca)nvas (Man)ipulation. Easy to use, but powerful, image manipulation library.","keywords":["canvas","image","manipulate","filter","image manipulation"],"homepage":"http://camanjs.com","author":{"name":"Ryan LeFevre","email":"meltingice8917@gmail.com","url":"http://meltingice.net"},"contributors":[{"name":"Rick Waldron","url":"http://github.com/rwldrn"},{"name":"Cezar Sa Espinola","url":"http://github.com/cezarsa"}],"main":"./dist/caman.full","repository":{"type":"git","url":"http://github.com/meltingice/CamanJS.git"},"dependencies":{"canvas":"*"},"_id":"caman@1.2.0","engines":{"node":"*"},"_engineSupported":true,"_npmVersion":"0.2.18","_nodeVersion":"v0.4.1","directories":{},"files":[""],"_defaultsLoaded":true,"dist":{"shasum":"7dce0f267be29cb5dc6874e32b82bcb3b8820fb9","tarball":"https://registry.npmjs.org/caman/-/caman-1.2.0.tgz","integrity":"sha512-bMmbWVuTVNPEtx/AHKZvj71c8lhGOorZwTV4aE2tIwFBnhmHBMIBPet0oId8pZOGPT4UkLah+m9X9VrLZXDbeg==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCBSpPRLUKgULamxJhtvIF92FUUKZFV9oBalgBaLyJRYAIgVHsKfs4M9Cne5Z1BrEbKR/45cWLBLO3zi0mJu00arUI="}]}},"1.2.1":{"name":"caman","version":"1.2.1","description":"Pure Javascript (Ca)nvas (Man)ipulation. Easy to use, but powerful, image manipulation library.","keywords":["canvas","image","manipulate","filter","image manipulation"],"homepage":"http://camanjs.com","author":{"name":"Ryan LeFevre","email":"meltingice8917@gmail.com","url":"http://meltingice.net"},"contributors":[{"name":"Rick Waldron","url":"http://github.com/rwldrn"},{"name":"Cezar Sa Espinola","url":"http://github.com/cezarsa"}],"main":"./dist/caman.full","repository":{"type":"git","url":"http://github.com/meltingice/CamanJS.git"},"dependencies":{"canvas":"*"},"_id":"caman@1.2.1","engines":{"node":"*"},"_engineSupported":true,"_npmVersion":"0.2.18","_nodeVersion":"v0.4.1","directories":{},"files":[""],"_defaultsLoaded":true,"dist":{"shasum":"c3d9f063fd654752855cf6f4b71c34c67d8a3c4b","tarball":"https://registry.npmjs.org/caman/-/caman-1.2.1.tgz","integrity":"sha512-1EbGb4w0r5vtj5VEkksw3BkobBeqDf9KzprSxSH/+qTmS9MGbmjiMkacvRwTqd1fF/eMtHa7hfPVz8rvyRhZ9A==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIF8z0gLC554EN/WD2fRL0eryEMxB3W2pQrI8Pu07TXvRAiAQa5DmwjLkAeHt7Bh56B1NAcv2ldEdjF+bUQu96NbKwQ=="}]}},"2.0.0":{"name":"caman","version":"2.0.0","description":"Pure Javascript (Ca)nvas (Man)ipulation. Easy to use, but powerful, image manipulation library.","keywords":["canvas","image","manipulate","filter","image manipulation"],"homepage":"http://camanjs.com","author":{"name":"Ryan LeFevre","email":"meltingice8917@gmail.com","url":"http://meltingice.net"},"contributors":[{"name":"Rick Waldron","url":"http://github.com/rwldrn"},{"name":"Cezar Sa Espinola","url":"http://github.com/cezarsa"}],"main":"./dist/caman.full","repository":{"type":"git","url":"http://github.com/meltingice/CamanJS.git"},"dependencies":{"canvas":"*"},"_id":"caman@2.0.0","engines":{"node":"*"},"_engineSupported":true,"_npmVersion":"0.2.18","_nodeVersion":"v0.4.1","directories":{},"files":[""],"_defaultsLoaded":true,"dist":{"shasum":"f19becc6078b2fdb51e3262c9433b6f8faf28d9e","tarball":"https://registry.npmjs.org/caman/-/caman-2.0.0.tgz","integrity":"sha512-4VWRKB6SbNIbNDwlFFsAJ/pWEM/OHpSsW7ueebavw6K2l5u7gl+gN0O9v0oOzMxs8vMtJWOQCX6ngsqoY8bN9Q==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCG58OiWJDFFsPrGQo0/0i4SbvbYgdypKq28C9FIrAgugIhAMvK+pUml2UT+plxySo6nMUXqwX2PyMZCNUxrd+PVIV/"}]}},"3.1.0":{"name":"caman","version":"3.1.0","description":"Pure Javascript (Ca)nvas (Man)ipulation. Easy, but powerful, image manipulation library.","keywords":["canvas","image","manipulate","filter","image manipulation"],"homepage":"http://camanjs.com","author":{"name":"Ryan LeFevre","email":"meltingice8917@gmail.com","url":"http://meltingice.net"},"contributors":[{"name":"Rick Waldron","url":"http://github.com/rwldrn"},{"name":"Cezar Sa Espinola","url":"http://github.com/cezarsa"}],"main":"./dist/caman.full.js","repository":{"type":"git","url":"git://github.com/meltingice/CamanJS.git"},"dependencies":{"canvas":"*"},"_npmUser":{"name":"meltingice","email":"meltingice8917@gmail.com"},"_id":"caman@3.1.0","devDependencies":{},"optionalDependencies":{},"engines":{"node":"*"},"_engineSupported":true,"_npmVersion":"1.1.0","_nodeVersion":"v0.6.6","_defaultsLoaded":true,"dist":{"shasum":"dbb9061a0cb80e73876f6b77902cad4a8907b5cb","tarball":"https://registry.npmjs.org/caman/-/caman-3.1.0.tgz","integrity":"sha512-W9tW8/QUnan+KPJK4F5iBNGGvh7zMgG16tLp+9B/uZKEZfrIEBBorTugmCJj3/UAWdrlSKcwngmqKthv1mPx9w==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIAseWYpW97Ajx75maoCW1VffMsCT0kRZDUUVkM6VNfI7AiEA97Ro0u1vDNSBdsrsNhx25gLLFFIE9DFJ4JgE/o0OCk0="}]},"readme":"<img src=\"http://camanjs.com/imgs/logo.png\" />\n\n# About the Project\n\nThe main focus of CamanJS is manipulating images using the HTML5 canvas and Javascript. It's a combination of a simple-to-use interface with advanced and efficient image/canvas editing techniques. It is also completely library independent and can be safely used next to jQuery, YUI, Scriptaculous, MooTools, etc.\n\nCamanJS is very easy to extend with new filters and plugins, and it comes with a wide array of image editing functionality, which is only growing as the community makes more plugins.\n\nFor more information, I highly recommend taking a look at the [official website](http://camanjs.com) where there is more comprehensive documentation and interactive demos. You can also [read the wiki](https://github.com/meltingice/CamanJS/wiki) for some basic information about the project and how to use it.\n\nCamanJS is written in [Coffeescript](http://coffeescript.org) as of version 3.0. **It works both in-browser and in NodeJS.**\n\n## Example Usage\n\nInclude one of the versions in the `dist/` folder, then you can run:\n\n```js\nCaman(\"#image-id\", function () {\n  this.brightness(10);\n  this.contrast(20);\n  this.render(function () {\n    alert(\"Done!\");\n  });\n});\n```\n\n## Upgrading from 2.x to 3.x\n\nFor the end-user, there are no changes to CamanJS that will affect your code. Everything works exactly the same as before.\n\nFor developers, there are some major changes regarding how filters and plugins are added to CamanJS. Previously, you would explicitly extend the Caman.manip interface. This object no longer exists. Now, the way you add filters is:\n\n``` coffeescript\nCaman.Filter.register \"filterName\", ->\n  # Variables that exist here will be available in the process function\n  # because of JS closure.\n  amt = 20\n\n  @process \"filterName\", (rgba) ->\n    # Alter rgba pixel object here\n    return rgba\n```\n\nPlugins are similarly added:\n\n``` coffeescript\nCaman.Plugin.register \"pluginName\", ->\n  return @\n```\n\n**Building CamanJS**\n\nIf you are a developer who is contributing directly to the project, there are some tools to help you out.\n\nThe requirements for building CamanJS are:\n\n* node\n* coffeescript\n* jsmin (for node)\n\nIf you're running OSX and have Growl installed, it's also recommended you have:\n\n* coffeescript-growl\n\nTo build, simply run:\n\n```\ncake build\n```\n\nThe resulting files will be placed in the dist/ folder. Plugins will be automatically discovered and added to caman.full.js after the core library.\n\nIf you add any files to the core library, you will need to add them to the `coffeeFiles` array in the Cakefile. The point of this is so that order is preserved when generating the file JS file. Plugins do not need to be added to the Cakefile.\n\nYou will probably want to generate documentation if you make any changes or add a plugin. In addition to the normal requirements, you will also need:\n\n* docco\n* Pygments (Python library)\n\nTo generate the documentation, run:\n\n```\ncake docs\n```\n\n## CDN JS Hosting\n\nCamanJS is hosted on CDN JS if you're looking for a CDN hosting solution. It is the full and minified version of the library, which means all plugins are included. Simply load CamanJS directly from [this URL](http://ajax.cdnjs.com/ajax/libs/camanjs/2.2/caman.full.min.js) for usage on your site.\n\n## NodeJS Compatibility\n\nCamanJS is fully compatible with NodeJS. The easiest way to install and use it is:\n\n```\nnpm install caman -g\n```\n\nIf you wish to do things a bit manually, the required libraries are:\n\n* cairo >= 1.10.0\n* libjpeg\n* libpng\n* [node-canvas](https://github.com/LearnBoost/node-canvas)\n  * Can also use: npm install canvas -g\n\n**Saving from NodeJS**\n\nTo save your modified image in NodeJS, simply call the save() function **after** rendering is finished. Trying to save before rendering is finished will cause issues.\n\n``` coffeescript\nCaman \"./path/to/file.jpg\", ->\n  @brightness 40\n  @render -> @save \"./output.jpg\"\n```\n\n# Testing\n\nCamanJS has both QUnit unit testing and a custom benchmarking page to monitor render times on a per-filter basis.  Simply open test/index.html for the QUnit tests, and test/benchmark.html for the benchmarking tests.\n\n# Project Contributors\n\n* [Ryan LeFevre](http://twitter.com/meltingice) - Project Creator, Maintainer, and Lead Developer\n* [Rick Waldron](http://twitter.com/rwaldron) - Plugin Architect and Developer\n* [Cezar Sá Espinola](http://twitter.com/cezarsa) - Developer\n* [Jarques Pretorius](http://twitter.com/jarques) - Logo Designer\n\n# Plugin Contributors\n\n* [Hosselaer](https://github.com/Hosselaer)\n* [Mario Klingemann](http://www.quasimondo.com)\n","maintainers":[{"name":"meltingice","email":"meltingice8917@gmail.com"}],"directories":{}},"3.1.2":{"name":"caman","version":"3.1.2","description":"Pure Javascript (Ca)nvas (Man)ipulation. Easy, but powerful, image manipulation library.","keywords":["canvas","image","manipulate","filter","image manipulation"],"homepage":"http://camanjs.com","author":{"name":"Ryan LeFevre","email":"meltingice8917@gmail.com","url":"http://meltingice.net"},"contributors":[{"name":"Rick Waldron","url":"http://github.com/rwldrn"},{"name":"Cezar Sa Espinola","url":"http://github.com/cezarsa"}],"main":"./dist/caman.full.js","repository":{"type":"git","url":"git://github.com/meltingice/CamanJS.git"},"dependencies":{"canvas":"*"},"_npmUser":{"name":"meltingice","email":"meltingice8917@gmail.com"},"_id":"caman@3.1.2","devDependencies":{},"optionalDependencies":{},"engines":{"node":"*"},"_engineSupported":true,"_npmVersion":"1.1.13","_nodeVersion":"v0.6.7","_defaultsLoaded":true,"dist":{"shasum":"7119ac96d95af8c5b486cd473fd26026d759a563","tarball":"https://registry.npmjs.org/caman/-/caman-3.1.2.tgz","integrity":"sha512-PbvMjJuRchFvaoONqOlhveo2QNGmSFdxxYluqRK6VBlyKma9z4d3QzSjXXE2r+gy+rLqFEjltfFKHWYzqAqxfA==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDbTR4voJAGbK6ekk2JvHBFPX+u0SZdsU7SB2YAnYBwfAIgYCaqdFivcMqhoCZptTZA6CLPrO6ybTDg40pXoLe2gLs="}]},"readme":"<img src=\"http://camanjs.com/imgs/logo.png\" />\n\n# About the Project\n\nThe main focus of CamanJS is manipulating images using the HTML5 canvas and Javascript. It's a combination of a simple-to-use interface with advanced and efficient image/canvas editing techniques. It is also completely library independent and can be safely used next to jQuery, YUI, Scriptaculous, MooTools, etc.\n\nCamanJS is very easy to extend with new filters and plugins, and it comes with a wide array of image editing functionality, which is only growing as the community makes more plugins.\n\nFor more information, I highly recommend taking a look at the [official website](http://camanjs.com) where there is more comprehensive documentation and interactive demos. You can also [read the wiki](https://github.com/meltingice/CamanJS/wiki) for some basic information about the project and how to use it.\n\nCamanJS is written in [Coffeescript](http://coffeescript.org) as of version 3.0. **It works both in-browser and in NodeJS.**\n\n## Example Usage\n\nInclude one of the versions in the `dist/` folder, then you can run:\n\n```js\nCaman(\"#image-id\", function () {\n  this.brightness(10);\n  this.contrast(20);\n  this.render(function () {\n    alert(\"Done!\");\n  });\n});\n```\n\n## Upgrading from 2.x to 3.x\n\nFor the end-user, there are no changes to CamanJS that will affect your code. Everything works exactly the same as before.\n\nFor developers, there are some major changes regarding how filters and plugins are added to CamanJS. Previously, you would explicitly extend the Caman.manip interface. This object no longer exists. Now, the way you add filters is:\n\n``` coffeescript\nCaman.Filter.register \"filterName\", ->\n  # Variables that exist here will be available in the process function\n  # because of JS closure.\n  amt = 20\n\n  @process \"filterName\", (rgba) ->\n    # Alter rgba pixel object here\n    return rgba\n```\n\nPlugins are similarly added:\n\n``` coffeescript\nCaman.Plugin.register \"pluginName\", ->\n  return @\n```\n\n**Building CamanJS**\n\nIf you are a developer who is contributing directly to the project, there are some tools to help you out.\n\nThe requirements for building CamanJS are:\n\n* node\n* coffeescript\n* jsmin (for node)\n\nIf you're running OSX and have Growl installed, it's also recommended you have:\n\n* coffeescript-growl\n\nTo build, simply run:\n\n```\ncake build\n```\n\nThe resulting files will be placed in the dist/ folder. Plugins will be automatically discovered and added to caman.full.js after the core library.\n\nIf you add any files to the core library, you will need to add them to the `coffeeFiles` array in the Cakefile. The point of this is so that order is preserved when generating the file JS file. Plugins do not need to be added to the Cakefile.\n\nYou will probably want to generate documentation if you make any changes or add a plugin. In addition to the normal requirements, you will also need:\n\n* docco\n* Pygments (Python library)\n\nTo generate the documentation, run:\n\n```\ncake docs\n```\n\n## CDN JS Hosting\n\nCamanJS is hosted on CDN JS if you're looking for a CDN hosting solution. It is the full and minified version of the library, which means all plugins are included. Simply load CamanJS directly from [this URL](http://cdnjs.cloudflare.com/ajax/libs/camanjs/3.1.1/caman.full.min.js) for usage on your site.\n\n## NodeJS Compatibility\n\nCamanJS is fully compatible with NodeJS. The easiest way to install and use it is:\n\n```\nnpm install caman -g\n```\n\nIf you wish to do things a bit manually, the required libraries are:\n\n* cairo >= 1.10.0\n* libjpeg\n* libpng\n* [node-canvas](https://github.com/LearnBoost/node-canvas)\n  * Can also use: npm install canvas -g\n\n**Saving from NodeJS**\n\nTo save your modified image in NodeJS, simply call the save() function **after** rendering is finished. Trying to save before rendering is finished will cause issues.\n\n``` coffeescript\nCaman \"./path/to/file.jpg\", ->\n  @brightness 40\n  @render -> @save \"./output.jpg\"\n```\n\n# Testing\n\nCamanJS has both QUnit unit testing and a custom benchmarking page to monitor render times on a per-filter basis.  Simply open test/index.html for the QUnit tests, and test/benchmark.html for the benchmarking tests.\n\n# Project Contributors\n\n* [Ryan LeFevre](http://twitter.com/meltingice) - Project Creator, Maintainer, and Lead Developer\n* [Rick Waldron](http://twitter.com/rwaldron) - Plugin Architect and Developer\n* [Cezar Sá Espinola](http://twitter.com/cezarsa) - Developer\n* [Jarques Pretorius](http://twitter.com/jarques) - Logo Designer\n\n# Plugin Contributors\n\n* [Hosselaer](https://github.com/Hosselaer)\n* [Mario Klingemann](http://www.quasimondo.com)\n","maintainers":[{"name":"meltingice","email":"meltingice8917@gmail.com"}],"directories":{}},"3.2.0":{"name":"caman","version":"3.2.0","description":"Pure Javascript (Ca)nvas (Man)ipulation. Easy, but powerful, image manipulation library.","keywords":["canvas","image","manipulate","filter","image manipulation"],"homepage":"http://camanjs.com","author":{"name":"Ryan LeFevre","email":"meltingice8917@gmail.com","url":"http://meltingice.net"},"contributors":[{"name":"Rick Waldron","url":"http://github.com/rwldrn"},{"name":"Cezar Sa Espinola","url":"http://github.com/cezarsa"}],"main":"./dist/caman.full.js","repository":{"type":"git","url":"http://github.com/meltingice/CamanJS.git"},"dependencies":{"canvas":"*"},"devDependencies":{"coffee-script":">= 1.3.1","jsmin":"*"},"readme":"<img src=\"http://camanjs.com/imgs/logo.png\" />\n\n# About the Project\n\nThe main focus of CamanJS is manipulating images using the HTML5 canvas and Javascript. It's a combination of a simple-to-use interface with advanced and efficient image/canvas editing techniques. It is also completely library independent and can be safely used next to jQuery, YUI, Scriptaculous, MooTools, etc.\n\nCamanJS is very easy to extend with new filters and plugins, and it comes with a wide array of image editing functionality, which is only growing as the community makes more plugins.\n\nFor more information, I highly recommend taking a look at the [official website](http://camanjs.com) where there is more comprehensive documentation and interactive demos. You can also [read the wiki](https://github.com/meltingice/CamanJS/wiki) for some basic information about the project and how to use it.\n\nCamanJS is written in [Coffeescript](http://coffeescript.org) as of version 3.0. **It works both in-browser and in NodeJS.**\n\n## Example Usage\n\nInclude one of the versions in the `dist/` folder, then you can run:\n\n```js\nCaman(\"#image-id\", function () {\n  this.brightness(10);\n  this.contrast(20);\n  this.render(function () {\n    alert(\"Done!\");\n  });\n});\n```\n\nCaman also supports modifying images via the `data-caman` HTML attribute. Simply separate each instruction with a space. Images with the `data-caman` attribute will automatically be modified at page load.\n\n```html\n<img data-caman=\"saturation(-10) brightness(20) vignette('10%')\" src=\"path/to/image.jpg\">\n```\n\n## Upgrading from 2.x to 3.x\n\nFor the end-user, there are no changes to CamanJS that will affect your code. Everything works exactly the same as before.\n\nFor developers, there are some major changes regarding how filters and plugins are added to CamanJS. Previously, you would explicitly extend the Caman.manip interface. This object no longer exists. Now, the way you add filters is:\n\n``` coffeescript\nCaman.Filter.register \"filterName\", ->\n  # Variables that exist here will be available in the process function\n  # because of JS closure.\n  amt = 20\n\n  @process \"filterName\", (rgba) ->\n    # Alter rgba pixel object here\n    return rgba\n```\n\nPlugins are similarly added:\n\n``` coffeescript\nCaman.Plugin.register \"pluginName\", ->\n  return @\n```\n\n**Building CamanJS**\n\nIf you are a developer who is contributing directly to the project, there are some tools to help you out.\n\nThe requirements for building CamanJS are:\n\n* node\n* coffeescript\n* jsmin (for node)\n\nIf you're running OSX and have Growl installed, it's also recommended you have:\n\n* coffeescript-growl\n\nTo build, simply run:\n\n```\ncake build\n```\n\nThe resulting files will be placed in the dist/ folder. Plugins will be automatically discovered and added to caman.full.js after the core library.\n\nIf you add any files to the core library, you will need to add them to the `coffeeFiles` array in the Cakefile. The point of this is so that order is preserved when generating the file JS file. Plugins do not need to be added to the Cakefile.\n\nYou will probably want to generate documentation if you make any changes or add a plugin. In addition to the normal requirements, you will also need:\n\n* docco\n* Pygments (Python library)\n\nTo generate the documentation, run:\n\n```\ncake docs\n```\n\n## CDN JS Hosting\n\nCamanJS is hosted on CDN JS if you're looking for a CDN hosting solution. It is the full and minified version of the library, which means all plugins are included. Simply load CamanJS directly from [this URL](http://cdnjs.cloudflare.com/ajax/libs/camanjs/3.1.1/caman.full.min.js) for usage on your site.\n\n## NodeJS Compatibility\n\nCamanJS is fully compatible with NodeJS. The easiest way to install and use it is:\n\n```\nnpm install caman -g\n```\n\nIf you wish to do things a bit manually, the required libraries are:\n\n* cairo >= 1.10.0\n* libjpeg\n* libpng\n* [node-canvas](https://github.com/LearnBoost/node-canvas)\n  * Can also use: npm install canvas -g\n\n**Saving from NodeJS**\n\nTo save your modified image in NodeJS, simply call the save() function **after** rendering is finished by passing a callback function to `render()`. Trying to save before rendering is finished will cause issues.\n\n``` coffeescript\nCaman \"./path/to/file.jpg\", ->\n  @brightness 40\n  @render -> @save \"./output.jpg\"\n```\n\n# Testing\n\nCamanJS has both QUnit unit testing and a custom benchmarking page to monitor render times on a per-filter basis.  Simply open test/index.html for the QUnit tests, and test/benchmark.html for the benchmarking tests.\n\n# Project Contributors\n\n* [Ryan LeFevre](http://twitter.com/meltingice) - Project Creator, Maintainer, and Lead Developer\n* [Rick Waldron](http://twitter.com/rwaldron) - Plugin Architect and Developer\n* [Cezar Sá Espinola](http://twitter.com/cezarsa) - Developer\n* [Jarques Pretorius](http://twitter.com/jarques) - Logo Designer\n\n# Plugin Contributors\n\n* [Hosselaer](https://github.com/Hosselaer)\n* [Mario Klingemann](http://www.quasimondo.com)\n","_id":"caman@3.2.0","dist":{"shasum":"21cb67b34bbd83c90aa17863a2e8f36ac1b5aa0f","tarball":"https://registry.npmjs.org/caman/-/caman-3.2.0.tgz","integrity":"sha512-rli2+xamF9UAlpSeJHI/YtXTs0d+bWXS10MT3idjGsvkvSTaPnhswu2z0kf73u2IrOWaQoo18HpTPbj9xinPsQ==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIG/nlfBUP9+kQlUnY3tgiCW6KDwbSHAhi9fOkBdyLJaaAiAsW5/KRXK9vwjm9sQSLZvdZi4QM99rKt22iANmc0wpjQ=="}]},"_npmVersion":"1.1.59","_npmUser":{"name":"meltingice","email":"meltingice8917@gmail.com"},"maintainers":[{"name":"meltingice","email":"meltingice8917@gmail.com"}],"directories":{}},"3.2.1":{"name":"caman","version":"3.2.1","description":"Pure Javascript (Ca)nvas (Man)ipulation. Easy, but powerful, image manipulation library.","keywords":["canvas","image","manipulate","filter","image manipulation"],"homepage":"http://camanjs.com","author":{"name":"Ryan LeFevre","email":"meltingice8917@gmail.com","url":"http://meltingice.net"},"contributors":[{"name":"Rick Waldron","url":"http://github.com/rwldrn"},{"name":"Cezar Sa Espinola","url":"http://github.com/cezarsa"}],"main":"./dist/caman.full.js","repository":{"type":"git","url":"http://github.com/meltingice/CamanJS.git"},"dependencies":{"canvas":"*"},"devDependencies":{"coffee-script":">= 1.3.1","jsmin":"*"},"readme":"<img src=\"http://camanjs.com/imgs/logo.png\" />\n\n# About the Project\n\nThe main focus of CamanJS is manipulating images using the HTML5 canvas and Javascript. It's a combination of a simple-to-use interface with advanced and efficient image/canvas editing techniques. It is also completely library independent and can be safely used next to jQuery, YUI, Scriptaculous, MooTools, etc.\n\nCamanJS is very easy to extend with new filters and plugins, and it comes with a wide array of image editing functionality, which is only growing as the community makes more plugins.\n\nFor more information, I highly recommend taking a look at the [official website](http://camanjs.com) where there is more comprehensive documentation and interactive demos. You can also [read the wiki](https://github.com/meltingice/CamanJS/wiki) for some basic information about the project and how to use it.\n\nCamanJS is written in [Coffeescript](http://coffeescript.org) as of version 3.0. **It works both in-browser and in NodeJS.**\n\n## Example Usage\n\nInclude one of the versions in the `dist/` folder, then you can run:\n\n```js\nCaman(\"#image-id\", function () {\n  this.brightness(10);\n  this.contrast(20);\n  this.render(function () {\n    alert(\"Done!\");\n  });\n});\n```\n\nCaman also supports modifying images via the `data-caman` HTML attribute. Simply separate each instruction with a space. Images with the `data-caman` attribute will automatically be modified at page load.\n\n```html\n<img data-caman=\"saturation(-10) brightness(20) vignette('10%')\" src=\"path/to/image.jpg\">\n```\n\n## Upgrading from 2.x to 3.x\n\nFor the end-user, there are no changes to CamanJS that will affect your code. Everything works exactly the same as before.\n\nFor developers, there are some major changes regarding how filters and plugins are added to CamanJS. Previously, you would explicitly extend the Caman.manip interface. This object no longer exists. Now, the way you add filters is:\n\n``` coffeescript\nCaman.Filter.register \"filterName\", ->\n  # Variables that exist here will be available in the process function\n  # because of JS closure.\n  amt = 20\n\n  @process \"filterName\", (rgba) ->\n    # Alter rgba pixel object here\n    return rgba\n```\n\nPlugins are similarly added:\n\n``` coffeescript\nCaman.Plugin.register \"pluginName\", ->\n  return @\n```\n\n**Building CamanJS**\n\nIf you are a developer who is contributing directly to the project, there are some tools to help you out.\n\nThe requirements for building CamanJS are:\n\n* node\n* coffeescript\n* jsmin (for node)\n\nIf you're running OSX and have Growl installed, it's also recommended you have:\n\n* coffeescript-growl\n\nTo build, simply run:\n\n```\ncake build\n```\n\nThe resulting files will be placed in the dist/ folder. Plugins will be automatically discovered and added to caman.full.js after the core library.\n\nIf you add any files to the core library, you will need to add them to the `coffeeFiles` array in the Cakefile. The point of this is so that order is preserved when generating the file JS file. Plugins do not need to be added to the Cakefile.\n\nYou will probably want to generate documentation if you make any changes or add a plugin. In addition to the normal requirements, you will also need:\n\n* docco\n* Pygments (Python library)\n\nTo generate the documentation, run:\n\n```\ncake docs\n```\n\n## CDN JS Hosting\n\nCamanJS is hosted on CDN JS if you're looking for a CDN hosting solution. It is the full and minified version of the library, which means all plugins are included. Simply load CamanJS directly from [this URL](http://cdnjs.cloudflare.com/ajax/libs/camanjs/3.1.1/caman.full.min.js) for usage on your site.\n\n## NodeJS Compatibility\n\nCamanJS is fully compatible with NodeJS. The easiest way to install and use it is:\n\n```\nnpm install caman -g\n```\n\nIf you wish to do things a bit manually, the required libraries are:\n\n* cairo >= 1.10.0\n* libjpeg\n* libpng\n* [node-canvas](https://github.com/LearnBoost/node-canvas)\n  * Can also use: npm install canvas -g\n\n**Saving from NodeJS**\n\nTo save your modified image in NodeJS, simply call the save() function **after** rendering is finished by passing a callback function to `render()`. Trying to save before rendering is finished will cause issues.\n\n``` coffeescript\nCaman \"./path/to/file.jpg\", ->\n  @brightness 40\n  @render -> @save \"./output.jpg\"\n```\n\n# Testing\n\nCamanJS has both QUnit unit testing and a custom benchmarking page to monitor render times on a per-filter basis.  Simply open test/index.html for the QUnit tests, and test/benchmark.html for the benchmarking tests.\n\n# Project Contributors\n\n* [Ryan LeFevre](http://twitter.com/meltingice) - Project Creator, Maintainer, and Lead Developer\n* [Rick Waldron](http://twitter.com/rwaldron) - Plugin Architect and Developer\n* [Cezar Sá Espinola](http://twitter.com/cezarsa) - Developer\n* [Jarques Pretorius](http://twitter.com/jarques) - Logo Designer\n\n# Plugin Contributors\n\n* [Hosselaer](https://github.com/Hosselaer)\n* [Mario Klingemann](http://www.quasimondo.com)\n","_id":"caman@3.2.1","dist":{"shasum":"a378356e0c68a9c176e51b2c7ae9fffa6d1bae3a","tarball":"https://registry.npmjs.org/caman/-/caman-3.2.1.tgz","integrity":"sha512-pclOofV2u3on9NlaRLVj4Gd/OCaWbK7XexbdRLNOu4GRDRslnFpHxjI+FezytSF+nylq7wzbesFQSnSgacyhFw==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQD3KsiOaNdyptRxXHFFvlI1nx6RXqhf8390+j5hAOAFDgIhAJMaMiFrXOjgICMyk8fU678QWf/GftEIMkL/NqtDbqJQ"}]},"_npmVersion":"1.1.59","_npmUser":{"name":"meltingice","email":"meltingice8917@gmail.com"},"maintainers":[{"name":"meltingice","email":"meltingice8917@gmail.com"}],"directories":{}},"3.3.0":{"name":"caman","version":"3.3.0","description":"Pure Javascript (Ca)nvas (Man)ipulation. Easy, but powerful, image manipulation library.","keywords":["canvas","image","manipulate","filter","image manipulation"],"homepage":"http://camanjs.com","author":{"name":"Ryan LeFevre","email":"meltingice8917@gmail.com","url":"http://meltingice.net"},"contributors":[{"name":"Rick Waldron","url":"http://github.com/rwldrn"},{"name":"Cezar Sa Espinola","url":"http://github.com/cezarsa"}],"main":"./dist/caman.full.js","repository":{"type":"git","url":"http://github.com/meltingice/CamanJS.git"},"dependencies":{"canvas":"*"},"devDependencies":{"coffee-script":">= 1.3.1","jsmin":"*","mocha":"*","chai":"*","servedir":"*"},"scripts":{"test":"./node_modules/mocha/bin/mocha --compilers coffee:coffee-script --reporter spec ./test/node/*.coffee","examples":"./node_modules/servedir/bin/servedir"},"readme":"# About the Project\n\n[![Build Status](https://secure.travis-ci.org/meltingice/CamanJS.png)](http://travis-ci.org/meltingice/CamanJS)\n\nThe main focus of CamanJS is manipulating images using the HTML5 canvas and Javascript. It's a combination of a simple-to-use interface with advanced and efficient image/canvas editing techniques. It is also completely library independent and can be safely used next to jQuery, YUI, Scriptaculous, MooTools, etc.\n\nCamanJS is very easy to extend with new filters and plugins, and it comes with a wide array of image editing functionality, which is only growing as the community makes more plugins.\n\nFor more information, I highly recommend taking a look at the [official website](http://camanjs.com) where there is more comprehensive documentation and interactive demos. You can also [read the wiki](https://github.com/meltingice/CamanJS/wiki) for some basic information about the project and how to use it.\n\nCamanJS is written in [Coffeescript](http://coffeescript.org) as of version 3.0. **It works both in-browser and in NodeJS.**\n\n## Example Usage\n\nInclude one of the versions in the `dist/` folder, then you can run:\n\n```js\nCaman(\"#image-id\", function () {\n  this.brightness(10);\n  this.contrast(20);\n  this.render(function () {\n    alert(\"Done!\");\n  });\n});\n```\n\nCaman also supports modifying images via the `data-caman` HTML attribute. Simply separate each instruction with a space. Images with the `data-caman` attribute will automatically be modified at page load.\n\n```html\n<img data-caman=\"saturation(-10) brightness(20) vignette('10%')\" src=\"path/to/image.jpg\">\n```\n\n## Upgrading from 2.x to 3.x\n\nFor the end-user, there are no changes to CamanJS that will affect your code. Everything works exactly the same as before.\n\nFor developers, there are some major changes regarding how filters and plugins are added to CamanJS. Previously, you would explicitly extend the Caman.manip interface. This object no longer exists. Now, the way you add filters is:\n\n``` coffeescript\nCaman.Filter.register \"filterName\", ->\n  # Variables that exist here will be available in the process function\n  # because of JS closure.\n  amt = 20\n\n  @process \"filterName\", (rgba) ->\n    # Alter rgba pixel object here\n    return rgba\n```\n\nPlugins are similarly added:\n\n``` coffeescript\nCaman.Plugin.register \"pluginName\", ->\n  return @\n```\n\n**Building CamanJS**\n\nIf you are a developer who is contributing directly to the project, there are some tools to help you out.\n\nThe requirements for building CamanJS are:\n\n* node\n* coffeescript\n* jsmin (for node)\n\nIf you're running OSX and have Growl installed, it's also recommended you have:\n\n* coffeescript-growl\n\nTo build, simply run:\n\n```\ncake build\n```\n\nThe resulting files will be placed in the dist/ folder. Plugins will be automatically discovered and added to caman.full.js after the core library.\n\nIf you add any files to the core library, you will need to add them to the `coffeeFiles` array in the Cakefile. The point of this is so that order is preserved when generating the file JS file. Plugins do not need to be added to the Cakefile.\n\nYou will probably want to generate documentation if you make any changes or add a plugin. In addition to the normal requirements, you will also need:\n\n* docco\n* Pygments (Python library)\n\nTo generate the documentation, run:\n\n```\ncake docs\n```\n\n## CDN JS Hosting\n\nCamanJS is hosted on CDN JS if you're looking for a CDN hosting solution. It is the full and minified version of the library, which means all plugins are included. Simply load CamanJS directly from [this URL](http://cdnjs.cloudflare.com/ajax/libs/camanjs/3.2.2/caman.full.min.js) for usage on your site.\n\n## NodeJS Compatibility\n\nCamanJS is fully compatible with NodeJS. The easiest way to install and use it is:\n\n```\nnpm install caman\n```\n\nIf you wish to do things a bit manually, the required libraries are:\n\n* cairo >= 1.10.0\n* libjpeg\n* libpng\n* [node-canvas](https://github.com/LearnBoost/node-canvas)\n  * Can also use: npm install canvas\n\n**Saving from NodeJS**\n\nTo save your modified image in NodeJS, simply call the save() function **after** rendering is finished by passing a callback function to `render()`. Trying to save before rendering is finished will cause issues.\n\n``` coffeescript\nCaman \"./path/to/file.jpg\", ->\n  @brightness 40\n  @render -> @save \"./output.jpg\"\n```\n\n# Testing\n\nThe test suite for CamanJS is currently being rewritten since the old one was next to useless. It uses Mocha, and can be run by executing:\n\n```\nnpm test\n```\n\n# Project Contributors\n\n* [Ryan LeFevre](http://twitter.com/meltingice) - Project Creator, Maintainer, and Lead Developer\n* [Rick Waldron](http://twitter.com/rwaldron) - Plugin Architect and Developer\n* [Cezar Sá Espinola](http://twitter.com/cezarsa) - Developer\n* [Jarques Pretorius](http://twitter.com/jarques) - Logo Designer\n\n# Plugin Contributors\n\n* [Hosselaer](https://github.com/Hosselaer)\n* [Mario Klingemann](http://www.quasimondo.com)\n","_id":"caman@3.3.0","dist":{"shasum":"c037da6bacb6e26e23dbf4369a0a3272d7513c4b","tarball":"https://registry.npmjs.org/caman/-/caman-3.3.0.tgz","integrity":"sha512-fz4MDZv5J8DRfktd0tZK/xEcIBD9pfm/f/3c5epoA5wCCunIEGyVA0uWLx6xgENe8YqfxK74Wj1y/GEvU+GzDg==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEMCHxR6BoIQm+qL9Vm1soC2dy4VdFIGBzthk0WftWQpjWgCIBRYC5fBraJVsTYavLRyeKiTCCS0QR2n3YEFznCaHUa+"}]},"_npmVersion":"1.1.63","_npmUser":{"name":"meltingice","email":"meltingice8917@gmail.com"},"maintainers":[{"name":"meltingice","email":"meltingice8917@gmail.com"}],"directories":{}},"3.4.0":{"name":"caman","version":"3.4.0","description":"Pure Javascript (Ca)nvas (Man)ipulation. Easy, but powerful, image manipulation library.","keywords":["canvas","image","manipulate","filter","image manipulation"],"homepage":"http://camanjs.com","author":{"name":"Ryan LeFevre","email":"meltingice8917@gmail.com","url":"http://meltingice.net"},"engines":{"node":">= 0.6.18"},"contributors":[{"name":"Rick Waldron","url":"http://github.com/rwldrn"},{"name":"Cezar Sa Espinola","url":"http://github.com/cezarsa"}],"main":"./dist/caman.full.js","repository":{"type":"git","url":"http://github.com/meltingice/CamanJS.git"},"dependencies":{"canvas":"*","fibers":"*"},"devDependencies":{"coffee-script":">= 1.3.1","jsmin":"*","mocha":"*","chai":"*","servedir":"*"},"scripts":{"test":"./node_modules/mocha/bin/mocha --compilers coffee:coffee-script --reporter spec ./test/node/*.coffee","examples":"./node_modules/servedir/bin/servedir"},"readme":"# About the Project\n\n[![Build Status](https://secure.travis-ci.org/meltingice/CamanJS.png)](http://travis-ci.org/meltingice/CamanJS)\n\nThe main focus of CamanJS is manipulating images using the HTML5 canvas and Javascript. It's a combination of a simple-to-use interface with advanced and efficient image/canvas editing techniques. It is also completely library independent and can be safely used next to jQuery, YUI, Scriptaculous, MooTools, etc.\n\nCamanJS is very easy to extend with new filters and plugins, and it comes with a wide array of image editing functionality, which is only growing as the community makes more plugins.\n\nFor more information, I highly recommend taking a look at the [official website](http://camanjs.com) where there is more comprehensive documentation and interactive demos. You can also [read the wiki](https://github.com/meltingice/CamanJS/wiki) for some basic information about the project and how to use it.\n\nCamanJS is written in [Coffeescript](http://coffeescript.org) as of version 3.0. **It works both in-browser and in NodeJS.**\n\n## Example Usage\n\nInclude one of the versions in the `dist/` folder, then you can run:\n\n```js\nCaman(\"#image-id\", function () {\n  this.brightness(10);\n  this.contrast(20);\n  this.render(function () {\n    alert(\"Done!\");\n  });\n});\n```\n\nCaman also supports modifying images via the `data-caman` HTML attribute. Simply separate each instruction with a space. Images with the `data-caman` attribute will automatically be modified at page load.\n\n```html\n<img data-caman=\"saturation(-10) brightness(20) vignette('10%')\" src=\"path/to/image.jpg\">\n```\n\n## Upgrading from 2.x to 3.x\n\nFor the end-user, there are no changes to CamanJS that will affect your code. Everything works exactly the same as before.\n\nFor developers, there are some major changes regarding how filters and plugins are added to CamanJS. Previously, you would explicitly extend the Caman.manip interface. This object no longer exists. Now, the way you add filters is:\n\n``` coffeescript\nCaman.Filter.register \"filterName\", ->\n  # Variables that exist here will be available in the process function\n  # because of JS closure.\n  amt = 20\n\n  @process \"filterName\", (rgba) ->\n    # Alter rgba pixel object here\n    return rgba\n```\n\nPlugins are similarly added:\n\n``` coffeescript\nCaman.Plugin.register \"pluginName\", ->\n  return @\n```\n\n**Building CamanJS**\n\nIf you are a developer who is contributing directly to the project, there are some tools to help you out.\n\nThe requirements for building CamanJS are:\n\n* node\n* coffeescript\n* jsmin (for node)\n\nIf you're running OSX and have Growl installed, it's also recommended you have:\n\n* coffeescript-growl\n\nTo build, simply run:\n\n```\ncake build\n```\n\nThe resulting files will be placed in the dist/ folder. Plugins will be automatically discovered and added to caman.full.js after the core library.\n\nIf you add any files to the core library, you will need to add them to the `coffeeFiles` array in the Cakefile. The point of this is so that order is preserved when generating the file JS file. Plugins do not need to be added to the Cakefile.\n\nYou will probably want to generate documentation if you make any changes or add a plugin. In addition to the normal requirements, you will also need:\n\n* docco\n* Pygments (Python library)\n\nTo generate the documentation, run:\n\n```\ncake docs\n```\n\n## CDN JS Hosting\n\nCamanJS is hosted on CDN JS if you're looking for a CDN hosting solution. It is the full and minified version of the library, which means all plugins are included. Simply load CamanJS directly from [this URL](http://cdnjs.cloudflare.com/ajax/libs/camanjs/3.2.2/caman.full.min.js) for usage on your site.\n\n## NodeJS Compatibility\n\nCamanJS is fully compatible with NodeJS. The easiest way to install and use it is:\n\n```\nnpm install caman\n```\n\nIf you wish to do things a bit manually, the required libraries are:\n\n* cairo >= 1.10.0\n* libjpeg\n* libpng\n* [node-canvas](https://github.com/LearnBoost/node-canvas)\n  * Can also use: npm install canvas\n\n**Saving from NodeJS**\n\nTo save your modified image in NodeJS, simply call the save() function **after** rendering is finished by passing a callback function to `render()`. Trying to save before rendering is finished will cause issues.\n\n``` coffeescript\nCaman \"./path/to/file.jpg\", ->\n  @brightness 40\n  @render -> @save \"./output.jpg\"\n```\n\n# Testing\n\nThe test suite for CamanJS is currently being rewritten since the old one was next to useless. It uses Mocha, and can be run by executing:\n\n```\nnpm test\n```\n\n# Project Contributors\n\n* [Ryan LeFevre](http://twitter.com/meltingice) - Project Creator, Maintainer, and Lead Developer\n* [Rick Waldron](http://twitter.com/rwaldron) - Plugin Architect and Developer\n* [Cezar Sá Espinola](http://twitter.com/cezarsa) - Developer\n* [Jarques Pretorius](http://twitter.com/jarques) - Logo Designer\n\n# Plugin Contributors\n\n* [Hosselaer](https://github.com/Hosselaer)\n* [Mario Klingemann](http://www.quasimondo.com)\n","readmeFilename":"README.md","_id":"caman@3.4.0","dist":{"shasum":"ae5cf606d1e0ab12bac854c68f042084d875cbe7","tarball":"https://registry.npmjs.org/caman/-/caman-3.4.0.tgz","integrity":"sha512-OUDlaqjnKfTV4gK88M8AIzalMRkyvh7bfD/tAbBOKJPPgO4AMP5wdI/NTV93nGerHyXuyh5kuL/tMP+wl0GcNw==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIHqpaXOL9xIBcoaXnb8PyKJ3RqSPLgwUIsqvhRiTryKRAiAzwoS+u9XHUxS5Y+Fj9/G2w0Z/qdyqfw5qgcd74cHoRQ=="}]},"_npmVersion":"1.1.69","_npmUser":{"name":"meltingice","email":"meltingice8917@gmail.com"},"maintainers":[{"name":"meltingice","email":"meltingice8917@gmail.com"}],"directories":{}},"4.0.0":{"name":"caman","version":"4.0.0","description":"Javascript (Ca)nvas (Man)ipulation for NodeJS and the browser","keywords":["canvas","image","manipulate","filter","image manipulation","editing"],"homepage":"http://camanjs.com","author":{"name":"Ryan LeFevre","email":"meltingice8917@gmail.com","url":"http://meltingice.net"},"engines":{"node":">= 0.6.18"},"contributors":[{"name":"Rick Waldron","url":"http://github.com/rwldrn"},{"name":"Cezar Sa Espinola","url":"http://github.com/cezarsa"},{"name":"Jarques Pretorius","url":"http://twitter.com/jarques"},{"name":"Hosselaer","url":"https://github.com/Hosselaer"},{"name":"Mario Klingemann","url":"http://www.quasimondo.com"}],"main":"./dist/caman.full.js","repository":{"type":"git","url":"http://github.com/meltingice/CamanJS.git"},"dependencies":{"canvas":"*","fibers":"*"},"devDependencies":{"coffee-script":">= 1.3.1","jsmin":"*","packer":"*","mocha":"*","chai":"*","servedir":"*","cli":"*","cli-table":"*"},"scripts":{"test":"./node_modules/mocha/bin/mocha --compilers coffee:coffee-script --reporter spec --globals Caman ./test/node/*.coffee","examples":"./node_modules/servedir/bin/servedir"},"readme":"# About the Project\n\n[![Build Status](https://secure.travis-ci.org/meltingice/CamanJS.png)](http://travis-ci.org/meltingice/CamanJS)\n\nThe main focus of CamanJS is manipulating images using the HTML5 canvas and Javascript. It's a combination of a simple-to-use interface with advanced and efficient image/canvas editing techniques. It is also completely library independent and can be safely used next to jQuery, YUI, Scriptaculous, MooTools, etc.\n\nCamanJS is very easy to extend with new filters and plugins, and it comes with a wide array of image editing functionality, which is only growing as the community makes more plugins. All features that are not a part of the core CamanJS library are in a [separate plugins repository](https://github.com/meltingice/CamanJS-Plugins).\n\nFor more information, I highly recommend taking a look at the [official website](http://camanjs.com) where there is more comprehensive documentation and interactive demos. You can also [read the wiki](https://github.com/meltingice/CamanJS/wiki) for some basic information about the project and how to use it.\n\nCamanJS is written in [Coffeescript](http://coffeescript.org) as of version 3.0. **It works both in-browser and in NodeJS.**\n\n## Usage\n\nInclude one of the versions in the `dist/` folder, then you can run:\n\n```js\nCaman(\"#image-id\", function () {\n  this.brightness(10);\n  this.contrast(20);\n  this.render(function () {\n    alert(\"Done!\");\n  });\n});\n```\n\nCaman also supports modifying images via the `data-caman` HTML attribute. Simply separate each instruction with a space. Images with the `data-caman` attribute will automatically be modified at page load.\n\n```html\n<img data-caman=\"saturation(-10) brightness(20) vignette('10%')\" src=\"path/to/image.jpg\">\n```\n\n### HiDPI Support\n\nVersion 4 introduces better support for HiDPI (Retina) displays. It allows you to specify a higher resolution replacement using HTML data attributes. Keep in mind, however, that higher resolution images take longer to render.\n\n**HTML data attributes**\n\n* `data-caman-hidpi`: URL to the high resolution replacement image\n* `data-caman-hidpi-disabled`: HiDPI support is enabled by default, so add this attribute if you wish to force disable it\n\n## Development\n\nIf you are a developer who is contributing directly to the project, there are some tools to help you out.\n\n### Building\n\nTo install all dependencies required for development, run `npm install -d`.\n\nBecause all plugins are in a separate repository, make sure you run:\n\n```\ngit submodule init && git submodule update\n```\n\nTo build, simply run `cake build`. The resulting files will be placed in the dist/ folder. Plugins will be automatically discovered and added to caman.full.js after the core library. You can also auto-compile when a file changes by using `cake watch`.\n\nIf you add any files to the core library, you will need to add them to the `coffeeFiles` array in the Cakefile. The point of this is so that order is preserved when generating the file JS file. Plugins do not need to be added to the Cakefile.\n\nYou will probably want to generate documentation if you make any changes. In addition to the normal requirements, you will also need the Python library Pygments.\n\nTo generate the documentation, run `cake docs`.\n\n## CDN JS Hosting\n\nCamanJS is hosted on CDN JS if you're looking for a CDN hosting solution. It is the full and minified version of the library, which means all plugins are included. Simply load CamanJS directly from [this URL](http://cdnjs.cloudflare.com/ajax/libs/camanjs/3.3.0/caman.full.min.js) for usage on your site.\n\n## NodeJS Compatibility\n\nCamanJS is fully compatible with NodeJS. The easiest way to install it is:\n\n```\nnpm install caman\n```\n\n**Saving from NodeJS**\n\nTo save your modified image in NodeJS, simply call the save() function **after** rendering is finished by passing a callback function to `render()`. Trying to save before rendering is finished will cause issues.\n\n``` coffeescript\nCaman \"./path/to/file.jpg\", ->\n  @brightness 40\n  @render -> @save \"./output.jpg\"\n```\n\n# Testing\n\nThe test suite is currently under heavy expansion, but a number of tests exist for NodeJS, which test a good part of the core library. Browser-based tests still need to be written, mostly for initialization and proxy URL testing.\n\nTo run the NodeJS tests, run `npm test`.\n\n# Project Contributors\n\n* [Ryan LeFevre](http://twitter.com/meltingice) - Project Creator, Maintainer, and Lead Developer\n* [Rick Waldron](http://twitter.com/rwaldron) - Plugin Architect and Developer\n* [Cezar Sá Espinola](http://twitter.com/cezarsa) - Developer\n* [Jarques Pretorius](http://twitter.com/jarques) - Logo Designer\n\n# Plugin Contributors\n\n* [Hosselaer](https://github.com/Hosselaer)\n* [Mario Klingemann](http://www.quasimondo.com)\n","readmeFilename":"README.md","_id":"caman@4.0.0","dist":{"shasum":"383a7dd8f910e8c8373322fc9aadcd38c5dedbfe","tarball":"https://registry.npmjs.org/caman/-/caman-4.0.0.tgz","integrity":"sha512-WsSeC3ZztyCH75wPXtICLrzGN178h0WVm5yGXU8+maUo1jNnSggrvXgjfxcNB74WVySalSU6kVp9XBgZ8h/N5w==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIGs73FyJt4Cfzmay0D7RgGSIDXqcD00I33a1hm/uKXlwAiAkizXaBi67lSWmvpQbGRETFRza5T9QUx6cNa9gCJG/jw=="}]},"_npmVersion":"1.1.69","_npmUser":{"name":"meltingice","email":"meltingice8917@gmail.com"},"maintainers":[{"name":"meltingice","email":"meltingice8917@gmail.com"}],"directories":{}},"4.1.0":{"name":"caman","version":"4.1.0","description":"Javascript (Ca)nvas (Man)ipulation for NodeJS and the browser","keywords":["canvas","image","manipulate","filter","image manipulation","editing"],"homepage":"http://camanjs.com","author":{"name":"Ryan LeFevre","email":"meltingice8917@gmail.com","url":"http://meltingice.net"},"engines":{"node":">= 0.6.18"},"contributors":[{"name":"Rick Waldron","url":"http://github.com/rwldrn"},{"name":"Cezar Sa Espinola","url":"http://github.com/cezarsa"},{"name":"Jarques Pretorius","url":"http://twitter.com/jarques"},{"name":"Hosselaer","url":"https://github.com/Hosselaer"},{"name":"Mario Klingemann","url":"http://www.quasimondo.com"}],"main":"./dist/caman.full.js","repository":{"type":"git","url":"http://github.com/meltingice/CamanJS.git"},"dependencies":{"canvas":"*","fibers":"*"},"devDependencies":{"coffee-script":">= 1.3.1","jsmin":"*","packer":"*","mocha":"*","chai":"*","servedir":"*","cli":"*","cli-table":"*"},"scripts":{"test":"./node_modules/mocha/bin/mocha --compilers coffee:coffee-script --reporter spec --globals Caman ./test/node/*.coffee","examples":"./node_modules/servedir/bin/servedir"},"readme":"# About the Project\n\n[![Build Status](https://secure.travis-ci.org/meltingice/CamanJS.png)](http://travis-ci.org/meltingice/CamanJS)\n\nThe main focus of CamanJS is manipulating images using the HTML5 canvas and Javascript. It's a combination of a simple-to-use interface with advanced and efficient image/canvas editing techniques. It is also completely library independent and can be safely used next to jQuery, YUI, Scriptaculous, MooTools, etc.\n\nCamanJS is very easy to extend with new filters and plugins, and it comes with a wide array of image editing functionality, which is only growing as the community makes more plugins. All features that are not a part of the core CamanJS library are in a [separate plugins repository](https://github.com/meltingice/CamanJS-Plugins).\n\nFor more information, I highly recommend taking a look at the [official website](http://camanjs.com) where there is more comprehensive documentation and interactive demos. You can also [read the wiki](https://github.com/meltingice/CamanJS/wiki) for some basic information about the project and how to use it.\n\nCamanJS is written in [Coffeescript](http://coffeescript.org) as of version 3.0. **It works both in-browser and in NodeJS.**\n\n## Usage\n\nInclude one of the versions in the `dist/` folder, then you can run:\n\n```js\nCaman(\"#image-id\", function () {\n  this.brightness(10);\n  this.contrast(20);\n  this.render(function () {\n    alert(\"Done!\");\n  });\n});\n```\n\nCaman also supports modifying images via the `data-caman` HTML attribute. Simply separate each instruction with a space. Images with the `data-caman` attribute will automatically be modified at page load.\n\n```html\n<img data-caman=\"saturation(-10) brightness(20) vignette('10%')\" src=\"path/to/image.jpg\">\n```\n\n### HiDPI Support\n\nVersion 4 introduces better support for HiDPI (Retina) displays. It allows you to specify a higher resolution replacement using HTML data attributes. Keep in mind, however, that higher resolution images take longer to render.\n\n**HTML data attributes**\n\n* `data-caman-hidpi`: URL to the high resolution replacement image\n* `data-caman-hidpi-disabled`: HiDPI support is enabled by default, so add this attribute if you wish to force disable it\n\n## Upgrading to Version 4\n\nThere is only 1 breaking change that occured with the version 4 release. When you initialize CamanJS with a canvas and an image, the parameter order has changed. It is now:\n\n``` javascript\nCaman(\"#canvas-id\", \"/path/to/image.png\", function() {});\n```\n\nThis is in order to be more consistent with initialization, such that the \"initialization object\" is always the first parameter. Update your code accordingly.\n\n## Development\n\nIf you are a developer who is contributing directly to the project, there are some tools to help you out.\n\n### Building\n\nTo install all dependencies required for development, run `npm install -d`.\n\nBecause all plugins are in a separate repository, make sure you run:\n\n```\ngit submodule init && git submodule update\n```\n\nTo build, simply run `cake build`. The resulting files will be placed in the dist/ folder. Plugins will be automatically discovered and added to caman.full.js after the core library. You can also auto-compile when a file changes by using `cake watch`.\n\nIf you add any files to the core library, you will need to add them to the `coffeeFiles` array in the Cakefile. The point of this is so that order is preserved when generating the file JS file. Plugins do not need to be added to the Cakefile.\n\nYou will probably want to generate documentation if you make any changes. In addition to the normal requirements, you will also need the Python library Pygments.\n\nTo generate the documentation, run `cake docs`.\n\n## CDN JS Hosting\n\nCamanJS is hosted on CDN JS if you're looking for a CDN hosting solution. It is the full and minified version of the library, which means all plugins are included. Simply load CamanJS directly from [this URL](http://cdnjs.cloudflare.com/ajax/libs/camanjs/3.3.0/caman.full.min.js) for usage on your site.\n\n## NodeJS Compatibility\n\nCamanJS is fully compatible with NodeJS. The easiest way to install it is:\n\n```\nnpm install caman\n```\n\n**Saving from NodeJS**\n\nTo save your modified image in NodeJS, simply call the save() function **after** rendering is finished by passing a callback function to `render()`. Trying to save before rendering is finished will cause issues.\n\n``` coffeescript\nCaman \"./path/to/file.jpg\", ->\n  @brightness 40\n  @render -> @save \"./output.jpg\"\n```\n\n# Testing\n\nThe test suite is currently under heavy expansion, but a number of tests exist for NodeJS, which test a good part of the core library. Browser-based tests still need to be written, mostly for initialization and proxy URL testing.\n\nTo run the NodeJS tests, run `npm test`.\n\n# Project Contributors\n\n* [Ryan LeFevre](http://twitter.com/meltingice) - Project Creator, Maintainer, and Lead Developer\n* [Rick Waldron](http://twitter.com/rwaldron) - Plugin Architect and Developer\n* [Cezar Sá Espinola](http://twitter.com/cezarsa) - Developer\n* [Jarques Pretorius](http://twitter.com/jarques) - Logo Designer\n\n# Plugin Contributors\n\n* [Hosselaer](https://github.com/Hosselaer)\n* [Mario Klingemann](http://www.quasimondo.com)\n","readmeFilename":"README.md","_id":"caman@4.1.0","dist":{"shasum":"c5fd1130264abe918e30095837e2d7271fe60882","tarball":"https://registry.npmjs.org/caman/-/caman-4.1.0.tgz","integrity":"sha512-0jbXl9k3zDUxIh5g7Ziu1gOle/cnjGEJ6ll+h22/YMp9moyo0Kj+6nBERO8FAtZnlTygRZCuHer34i9wmLU68Q==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQC03CehBcXoOVGGRIhOYCIVdHnTVsJ6pO8rErvivRXvtAIgC+Wev3bTdanWZsr96rzGzoV9xMF6TQ6YZj/euJtZVQE="}]},"_from":".","_npmVersion":"1.2.2","_npmUser":{"name":"meltingice","email":"meltingice8917@gmail.com"},"maintainers":[{"name":"meltingice","email":"meltingice8917@gmail.com"}],"directories":{}},"4.1.1":{"name":"caman","version":"4.1.1","description":"Javascript (Ca)nvas (Man)ipulation for NodeJS and the browser","keywords":["canvas","image","manipulate","filter","image manipulation","editing"],"homepage":"http://camanjs.com","author":{"name":"Ryan LeFevre","email":"meltingice8917@gmail.com","url":"http://meltingice.net"},"engines":{"node":">= 0.6.18"},"contributors":[{"name":"Rick Waldron","url":"http://github.com/rwldrn"},{"name":"Cezar Sa Espinola","url":"http://github.com/cezarsa"},{"name":"Jarques Pretorius","url":"http://twitter.com/jarques"},{"name":"Hosselaer","url":"https://github.com/Hosselaer"},{"name":"Mario Klingemann","url":"http://www.quasimondo.com"}],"main":"./dist/caman.full.js","repository":{"type":"git","url":"http://github.com/meltingice/CamanJS.git"},"dependencies":{"canvas":"*","fibers":"*"},"devDependencies":{"coffee-script":">= 1.6.1","docco":"0.6.0","jsmin":"*","packer":"*","mocha":"*","chai":"*","servedir":"*","cli":"*","cli-table":"*"},"scripts":{"test":"./node_modules/mocha/bin/mocha --compilers coffee:coffee-script --reporter spec --globals Caman ./test/unit/*.coffee","examples":"./node_modules/servedir/bin/servedir"},"readme":"# About the Project\n\n[![Build Status](https://secure.travis-ci.org/meltingice/CamanJS.png)](http://travis-ci.org/meltingice/CamanJS)\n\nThe main focus of CamanJS is manipulating images using the HTML5 canvas and Javascript. It's a combination of a simple-to-use interface with advanced and efficient image/canvas editing techniques. It is also completely library independent and can be safely used next to jQuery, YUI, Scriptaculous, MooTools, etc.\n\nCamanJS is very easy to extend with new filters and plugins, and it comes with a wide array of image editing functionality, which is only growing as the community makes more plugins. All features that are not a part of the core CamanJS library are in a [separate plugins repository](https://github.com/meltingice/CamanJS-Plugins).\n\nFor more information, I highly recommend taking a look at the [official website](http://camanjs.com) where there is more comprehensive documentation and interactive demos. You can also [read the wiki](https://github.com/meltingice/CamanJS/wiki) for some basic information about the project and how to use it.\n\nCamanJS is written in [Coffeescript](http://coffeescript.org) as of version 3.0. **It works both in-browser and in NodeJS.**\n\n## Usage\n\nInclude one of the versions in the `dist/` folder, then you can run:\n\n```js\nCaman(\"#image-id\", function () {\n  this.brightness(10);\n  this.contrast(20);\n  this.render(function () {\n    alert(\"Done!\");\n  });\n});\n```\n\nCaman also supports modifying images via the `data-caman` HTML attribute. Simply separate each instruction with a space. Images with the `data-caman` attribute will automatically be modified at page load.\n\n```html\n<img data-caman=\"saturation(-10) brightness(20) vignette('10%')\" src=\"path/to/image.jpg\">\n```\n\n### HiDPI Support\n\nVersion 4 introduces better support for HiDPI (Retina) displays. It allows you to specify a higher resolution replacement using HTML data attributes. Keep in mind, however, that higher resolution images take longer to render.\n\n**HTML data attributes**\n\n* `data-caman-hidpi`: URL to the high resolution replacement image\n* `data-caman-hidpi-disabled`: HiDPI support is enabled by default, so add this attribute if you wish to force disable it\n\n## Upgrading to Version 4\n\nThere is only 1 breaking change that occured with the version 4 release. When you initialize CamanJS with a canvas and an image, the parameter order has changed. It is now:\n\n``` javascript\nCaman(\"#canvas-id\", \"/path/to/image.png\", function() {});\n```\n\nThis is in order to be more consistent with initialization, such that the \"initialization object\" is always the first parameter. Update your code accordingly.\n\n## Development\n\nIf you are a developer who is contributing directly to the project, there are some tools to help you out.\n\n### Building\n\nTo install all dependencies required for development, run `npm install -d`.\n\nBecause all plugins are in a separate repository, make sure you run:\n\n```\ngit submodule init && git submodule update\n```\n\nTo build, simply run `cake build`. The resulting files will be placed in the dist/ folder. Plugins will be automatically discovered and added to caman.full.js after the core library. You can also auto-compile when a file changes by using `cake watch`.\n\nIf you add any files to the core library, you will need to add them to the `coffeeFiles` array in the Cakefile. The point of this is so that order is preserved when generating the file JS file. Plugins do not need to be added to the Cakefile.\n\nYou will probably want to generate documentation if you make any changes. In addition to the normal requirements, you will also need the Python library Pygments.\n\nTo generate the documentation, run `cake docs`.\n\n## CDN JS Hosting\n\nCamanJS is hosted on CDN JS if you're looking for a CDN hosting solution. It is the full and minified version of the library, which means all plugins are included. Simply load CamanJS directly from [this URL](http://cdnjs.cloudflare.com/ajax/libs/camanjs/3.3.0/caman.full.min.js) for usage on your site.\n\n## NodeJS Compatibility\n\nCamanJS is fully compatible with NodeJS. The easiest way to install it is:\n\n```\nnpm install caman\n```\n\n**Saving from NodeJS**\n\nTo save your modified image in NodeJS, simply call the save() function **after** rendering is finished by passing a callback function to `render()`. Trying to save before rendering is finished will cause issues.\n\n``` coffeescript\nCaman \"./path/to/file.jpg\", ->\n  @brightness 40\n  @render -> @save \"./output.jpg\"\n```\n\n## Testing\n\nTests for CamanJS run both in NodeJS and the browser.\n\n### NodeJS\n\nThe NodeJS tests use mocha as the test runner. The simplest way to run the test suite is:\n\n```\nnpm test\n```\n\n### Browser\n\nThe browser tests are run by Testacular. It will start up Chrome, Firefox, and Safari in the background. If you're running Windows, you will want to remove Safari by editing `test/testacular.conf.js`. You can minimize each of these browsers if desired. It will automatically run tests after CamanJS is recompiled by the Cakefile as well. \n\n**Because it prefers to be installed globally, Testacular is a soft dependency.**\n\n**Install**\n```\nnpm install -g testacular\n```\n\n**Run**\n```\ntestacular start test/testacular.conf.js\n```\n\n# Project Contributors\n\n* [Ryan LeFevre](http://twitter.com/meltingice) - Project Creator, Maintainer, and Lead Developer\n* [Rick Waldron](http://twitter.com/rwaldron) - Plugin Architect and Developer\n* [Cezar Sá Espinola](http://twitter.com/cezarsa) - Developer\n* [Jarques Pretorius](http://twitter.com/jarques) - Logo Designer\n\n# Plugin Contributors\n\n* [Hosselaer](https://github.com/Hosselaer)\n* [Mario Klingemann](http://www.quasimondo.com)\n","readmeFilename":"README.md","_id":"caman@4.1.1","dist":{"shasum":"aa5b5e335107c7e811e26b8eaedaec3b5d4d6737","tarball":"https://registry.npmjs.org/caman/-/caman-4.1.1.tgz","integrity":"sha512-KbTW0NScXebgc2fwotMyGo0Ob534sZirHnu15ea4r7i2pnO1OG7iuYvna2Dljh6pO7+f4+IXD4XOKw4lDZEGJg==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCtm3GLGD2wnOEz6fZgr8rqalvnv7R39prCIUYOK8D3IwIgLjdkyGInZBgWUMzZkdr9CsvZVwK6KcKtvYlhwY5nznU="}]},"_from":".","_npmVersion":"1.2.11","_npmUser":{"name":"meltingice","email":"meltingice8917@gmail.com"},"maintainers":[{"name":"meltingice","email":"meltingice8917@gmail.com"}],"directories":{}},"4.1.2":{"name":"caman","version":"4.1.2","description":"Javascript (Ca)nvas (Man)ipulation for NodeJS and the browser","keywords":["canvas","image","manipulate","filter","image manipulation","editing"],"homepage":"http://camanjs.com","author":{"name":"Ryan LeFevre","email":"meltingice8917@gmail.com","url":"http://meltingice.net"},"engines":{"node":">= 0.6.18"},"contributors":[{"name":"Rick Waldron","url":"http://github.com/rwldrn"},{"name":"Cezar Sa Espinola","url":"http://github.com/cezarsa"},{"name":"Jarques Pretorius","url":"http://twitter.com/jarques"},{"name":"Hosselaer","url":"https://github.com/Hosselaer"},{"name":"Mario Klingemann","url":"http://www.quasimondo.com"}],"main":"./dist/caman.full.js","repository":{"type":"git","url":"http://github.com/meltingice/CamanJS.git"},"dependencies":{"canvas":"*","fibers":"*"},"devDependencies":{"coffee-script":">= 1.6.1","docco":"0.6.2","codo":"*","jsmin":"*","packer":"*","mocha":"*","chai":"*","servedir":"*","cli":"*","cli-table":"*","karma":"*"},"scripts":{"test":"./node_modules/mocha/bin/mocha --compilers coffee:coffee-script --reporter spec --globals Caman ./test/unit/*.coffee && ./node_modules/.bin/karma start --single-run","examples":"./node_modules/servedir/bin/servedir","docs":"codo","docs-server":"codo --server"},"readme":"# About the Project\n\n[![Build Status](https://secure.travis-ci.org/meltingice/CamanJS.png)](http://travis-ci.org/meltingice/CamanJS)\n\nThe main focus of CamanJS is manipulating images using the HTML5 canvas and Javascript. It's a combination of a simple-to-use interface with advanced and efficient image/canvas editing techniques. It is also completely library independent and can be safely used next to jQuery, YUI, Scriptaculous, MooTools, etc.\n\nCamanJS is very easy to extend with new filters and plugins, and it comes with a wide array of image editing functionality, which is only growing as the community makes more plugins. All features that are not a part of the core CamanJS library are in a [separate plugins repository](https://github.com/meltingice/CamanJS-Plugins).\n\nFor more information, I highly recommend taking a look at the [official website](http://camanjs.com) where there is more comprehensive documentation and interactive demos. You can also [read the wiki](https://github.com/meltingice/CamanJS/wiki) for some basic information about the project and how to use it.\n\nCamanJS is written in [Coffeescript](http://coffeescript.org) as of version 3.0. **It works both in-browser and in NodeJS.**\n\n## Usage\n\nInclude one of the versions in the `dist/` folder, then you can run:\n\n```js\nCaman(\"#image-id\", function () {\n  this.brightness(10);\n  this.contrast(20);\n  this.render(function () {\n    alert(\"Done!\");\n  });\n});\n```\n\nCaman also supports modifying images via the `data-caman` HTML attribute. Simply separate each instruction with a space. Images with the `data-caman` attribute will automatically be modified at page load.\n\n```html\n<img data-caman=\"saturation(-10) brightness(20) vignette('10%')\" src=\"path/to/image.jpg\">\n```\n\n### HiDPI Support\n\nVersion 4 introduces better support for HiDPI (Retina) displays. It allows you to specify a higher resolution replacement using HTML data attributes. Keep in mind, however, that higher resolution images take longer to render.\n\n**HTML data attributes**\n\n* `data-caman-hidpi`: URL to the high resolution replacement image\n* `data-caman-hidpi-disabled`: HiDPI support is enabled by default, so add this attribute if you wish to force disable it\n\n## Upgrading to Version 4\n\nThere is only 1 breaking change that occured with the version 4 release. When you initialize CamanJS with a canvas and an image, the parameter order has changed. It is now:\n\n``` javascript\nCaman(\"#canvas-id\", \"/path/to/image.png\", function() {});\n```\n\nThis is in order to be more consistent with initialization, such that the \"initialization object\" is always the first parameter. Update your code accordingly.\n\n## Development\n\nIf you are a developer who is contributing directly to the project, there are some tools to help you out.\n\n### Building\n\nTo install all dependencies required for development, run `npm install -d`.\n\nBecause all plugins are in a separate repository, make sure you run:\n\n```\ngit submodule init && git submodule update\n```\n\nTo build, simply run `cake build`. The resulting files will be placed in the dist/ folder. Plugins will be automatically discovered and added to caman.full.js after the core library. You can also auto-compile when a file changes by using `cake watch`.\n\nIf you add any files to the core library, you will need to add them to the `coffeeFiles` array in the Cakefile. The point of this is so that order is preserved when generating the file JS file. Plugins do not need to be added to the Cakefile.\n\nYou will probably want to generate documentation if you make any changes. In addition to the normal requirements, you will also need the Python library Pygments.\n\nTo generate the documentation, run `cake docs`.\n\n## CDN JS Hosting\n\nCamanJS is hosted on CDN JS if you're looking for a CDN hosting solution. It is the full and minified version of the library, which means all plugins are included. Simply load CamanJS directly from [this URL](http://cdnjs.cloudflare.com/ajax/libs/camanjs/3.3.0/caman.full.min.js) for usage on your site.\n\n## NodeJS Compatibility\n\nCamanJS is fully compatible with NodeJS. The easiest way to install it is:\n\n```\nnpm install caman\n```\n\n**Saving from NodeJS**\n\nTo save your modified image in NodeJS, simply call the save() function **after** rendering is finished by passing a callback function to `render()`. Trying to save before rendering is finished will cause issues.\n\n``` javascript\nCaman = require('caman').Caman;\n\nCaman(\"./path/to/file.jpg\", function () {\n  this.brightness(40);\n  this.render(function () {\n    this.save(\"./output.png\");\n  });\n});\n```\n\n## Testing\n\nTests for CamanJS run both in NodeJS and the browser.\n\n### NodeJS\n\nThe NodeJS tests use mocha as the test runner. The simplest way to run the test suite is by running `npm test`.\n\n### Browser\n\nThe browser tests are run by Karma. It will start up Chrome, Firefox, and Safari (if running OSX) in the background. You can minimize each of these browsers if desired. It will automatically run tests after CamanJS is recompiled by the Cakefile as well.\n\nYou can run Karma by running `karma start`, or you can do a single run with the NodeJS tests by running `npm test`.\n","readmeFilename":"README.md","bugs":{"url":"https://github.com/meltingice/CamanJS/issues"},"_id":"caman@4.1.2","dist":{"shasum":"68fb69dd62c6d89fe599d4f855193a0355c2d3c9","tarball":"https://registry.npmjs.org/caman/-/caman-4.1.2.tgz","integrity":"sha512-vtxqU5gO3qpQ7pPYwTF7TRr+bDy87fHmZRZqoWywgmhMAwbCIM/p5KOj5g/IdGQfoukZDSIpxOzLXGx+4/cr3Q==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIE+jbwO75PIOs9AIeadt1QlsOmkS2MCtsS0yQdWyWafRAiBSM8hCdQCq2LVKSubbpzxKa172d+m1RP4JoUfhZ9CHqQ=="}]},"_from":".","_npmVersion":"1.2.23","_npmUser":{"name":"meltingice","email":"meltingice8917@gmail.com"},"maintainers":[{"name":"meltingice","email":"meltingice8917@gmail.com"}],"directories":{}}},"maintainers":[{"name":"meltingice","email":"meltingice8917@gmail.com"}],"time":{"modified":"2022-06-13T05:30:23.861Z","created":"2011-03-03T20:29:17.428Z","1.0.0":"2011-03-03T20:29:18.584Z","1.1.0":"2011-03-03T23:39:15.296Z","1.2.0":"2011-03-06T08:44:47.085Z","1.2.1":"2011-04-04T03:13:11.868Z","2.0.0":"2011-04-04T06:58:15.085Z","3.1.0":"2012-01-20T05:33:22.697Z","3.1.2":"2012-04-06T19:37:18.949Z","3.2.0":"2012-09-08T22:56:26.177Z","3.2.1":"2012-09-26T02:57:39.347Z","3.3.0":"2012-12-18T03:27:40.430Z","3.4.0":"2012-12-18T04:23:51.628Z","4.0.0":"2013-01-07T04:43:38.110Z","4.1.0":"2013-02-13T01:02:27.144Z","4.1.1":"2013-04-09T03:18:56.792Z","4.1.2":"2013-07-27T17:57:42.563Z"},"author":{"name":"Ryan LeFevre","email":"meltingice8917@gmail.com","url":"http://meltingice.net"},"repository":{"type":"git","url":"http://github.com/meltingice/CamanJS.git"},"users":{"meltingice":true,"subso":true,"parkerproject":true,"jawish":true,"dlv_201":true,"leejefon":true,"paulw":true,"aditya_1806":true}}