The 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.
CamanJS 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.
For more information, I highly recommend taking a look at the official website where there is more comprehensive documentation and interactive demos. You can also read the wiki for some basic information about the project and how to use it.
Caman("#image-id", function () {
this.brightness(10);
this.contrast(20);
this.render(function () {
alert("Done!");
});
});CamanJS uses git submodules in order to organize things a bit better. Because of this, you have a few options in making sure you get all the required files.
Recursive Clone
Recommended if you haven't cloned the project yet.
git clone --recursive https://github.com/meltingice/CamanJS.git
Submodule Init
If you have cloned the project already, you can do (after pulling the latest changes):
git submodule init
git submodule update
The library is split up into several source files and has a separate submodule for plugins. The reason behind this organization is to make it as simple as possible to support the NodeJS port of Caman. This also helps to avoid library bloat.
Makefile
The NodeJS powered Makefile for the project will automatically check to make sure you've initialized the submodules, and if you haven't, will do so for you. Running the Makefile requires smoosh (available in npm).
To build, simply run:
make
The resulting files will be placed in the dist/ folder.
CamanJS 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 for usage on your site.
There is now a version of CamanJS that is made to work with NodeJS. It has all of the functionality of the normal browser version, including plugins. Take a look at the node branch for more information.
tl;dr
npm install caman
CamanJS 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.
- Ryan LeFevre - Project Creator, Maintainer, and Lead Developer
- Rick Waldron - Plugin Architect and Developer
- Cezar Sá Espinola - Developer
- Jarques Pretorius - Logo Designer