Intro

Simpro is a javascript library, it is built on top of CamanJS which is an Image manipulation javascript library. What Simpro does is to kind of simplify the syntax by making it a functional type and eliminating the use of the this keyword. So what it does is, you provide it with an image path, the path to which the newly manipulated image should be saved, and the value of intensity based on the function used.

Installation

The installation is easy and as follows:

npm install simpro

Usage

Now how is simpro used, simpro is easy to use, right now it consists of only 11 functions but will increase with time. The following are examples of the manipulative functions of some simpro functions.

const {
  greyscale,
  gamma,
  sepia,
  brightness,
  contrast,
  vibrance,
  saturation,
  hue,
  invert,
  noise,
  fillColor,
} = require("simpro");

//Converts the image to greyscale
greyscale(fileLocationURL, outputFileToBeSavedTo);

//The fileUrl is the input file, the outputUrl is where the file is going to be kept, and the value is the value for the gamma, it extends from 0 to infinity but the recommended values is from 0 to 5.
gamma(fileLocationURL, outputFileToBeSavedTo, value);

//Applies an adjustable sepia effect to the image. Range is from 0 to 100. The larger the value, the stronger the sepia effect.
sepia(fileLocationURL, outputFileToBeSavedTo, value);

//The fileUrl is the input file, the outputUrl is where the file is going to be kept, and the value parameter is the value for the brightness, it extends from -100 to +100, value less than 0 wil darken and value greater than zero will brighten the image.
brightness(fileLocationURL, outputFileToBeSavedTo, value);

//The fileUrl is the input file, the outputUrl is where the file is going to be kept, and the value parameter is the value for the contrast, it extends from -100 to +100, value less than 0 wil decrease contrast and value greater than zero will increase contrast of the image, the recommended values are from 5 to 10.
contrast(fileLocationURL, outputFileToBeSavedTo, value);

//Similar to saturation, but adjusts the saturation levels in a slightly smarter, more subtle way. Vibrance will boost colors that are less saturated more and boost already saturated colors less, while saturation boosts all colors by the same level. Range is -100 to 100.
vibrance(fileLocationURL, outputFileToBeSavedTo, value);

//Adjusts the color saturation of the image. If you want to completely desaturate the image, using the greyscale filter is highly recommended because it will yield better results. Range is -100 to 100.
saturation(fileLocationURL, outputFileToBeSavedTo, value);

//Adjust the hue of an image, value can range from 0 to 100
hue(fileLocationURL, outputFileToBeSavedTo, value);

//Inverts all colors in the image by subtracting each color channel value from 255.
invert(fileLocationURL, outputFileToBeSavedTo);

//Applies an adjustable amount of noise to the image.
noise(fileLocationURL, outputFileToBeSavedTo, value);

//Fills the canvas with a single solid color. Useful when used with layers. Can take either separate R, G, and B values as arguments, or a single hex color value.
fillColor(fileLocationURL, outputFileToBeSavedTo, value);

The greyscale function changes this image

To this

And this is only what the greyscale function does, ten other functions perform different manipulation. You can play around with them and get to know them better.

Contributors

Contributors are welcome to contribute at the Github Simpro repository.