6px

NodeJS 6px SDK

Wrapper to the 6px image processing API. Includes methods to make the process of sending over jobs easier.

More examples can be found in the examples directory, but here's a sample of adding a watermark to an image.

var px = require('6px')({
    userId: '***USER_ID***',
    apiKey: '***API_KEY***',
    apiSecret: '***API_SECRET***'
});

/**
 * Load our images
 *
 * It can be a path to a file on your machine.
 * It can be a buffer.
 * It can be a location on the internet.
 */
var image = px({
    taxi: './images/unsplash_city_taxi.jpg',
    logo: 'http://6px.io/img/[e-mail]'
});

/**
 * Create a new output object.
 *
 * We need to tell that output which input we are working with.
 * In this case we will use the taxi as the main image.  We use an object, that way we can specify the filename that we want to use.  You do have the option of just putting `false` in there, and 6px will generate a name for you.
 */
var output = image.output({ taxi: 'unsplashed_6px_watermark' });

/**
 * We are now adding a layer action.  We are referring to the other input we defined earlier.
 *
 * Some options are opacity, x, y, width, height.
 */
output.layer('logo', {
    opacity: 0.6
});

// Where does the image end up?  Passing `6px` will send it to 6px's CDN.
output.url('6px');

/**
 * Send to 6px!  The result will be a response from the API with the ID.
 *
 * This doesn't mean the job is done.  This means the API has received the request.
 */
image.save(function(err, res) {
    console.log(res);
});

All of those methods are chainable, by the way:

var px = require('6px')({
    userId: '***USER_ID***',
    apiKey: '***API_KEY***',
    apiSecret: '***API_SECRET***'
});

var image = px({
    taxi: './images/unsplash_city_taxi.jpg',
    logo: 'http://6px.io/img/[e-mail]'
});

image.output({ taxi: 'unsplashed_6px_watermark' })
    .layer('logo', {
        opacity: 0.6
    })
    .url('6px');

image.save(function(err, res) {
    console.log(res);
});

Granted, we lost the comments, but you can see most of the methods are set up to be chainable.