pixelsmith

Node based engine for spritesmith built of top of get-pixels and save-pixels.

This can be used for constructing a canvas, placing images on it, and extracting the result image.

Getting Started

Install the module with: npm install pixelsmith

1// Load in our dependencies
2var Pixelsmith = require('pixelsmith');
3
4// Create a new engine
5var pixelsmith = new Pixelsmith();
6
7// Interpret some images from disk
8pixelsmith.createImages(['img1.jpg', 'img2.png'], function handleImages (err, imgs) {
9  // If there was an error, throw it
10  if (err) {
11    throw err;
12  }
13
14  // We recieve images in the same order they were given
15  imgs[0].width; // 50 (pixels)
16  imgs[0].height; // 100 (pixels)
17
18  // Create a canvas that fits our images (200px wide, 300px tall)
19  var canvas = pixelsmith.createCanvas(200, 300);
20
21  // Add the images to our canvas (at x=0, y=0 and x=50, y=100 respectively)
22  canvas.addImage(imgs[0], 0, 0);
23  canvas.addImage(imgs[1], 50, 100);
24
25  // Export canvas to image
26  var resultStream = canvas['export']({format: 'png'});
27  resultStream; // Readable stream outputting PNG image of the canvas
28});

Documentation

This module was built to the specification for spritesmith engines.

Specification version: 2.0.0

https://github.com/twolfson/spritesmith-engine-spec/tree/2.0.0

Engine(options)

Our engine constructor supports the following options:

• options Object - Optional container for various settings
  • concurrentFileLimit Number - Amount of files to load concurrently via createImages
    • May be useful if bumping into EMFILE (file descriptor limit)

engine.createImages(images, cb)

Our createImages methods supports the following types of images:

• image String - Filepath to image
• image Object - Vinyl object with buffer for image (uses buffer)
• image Object - Vinyl object with stream for image (uses stream)
• image Object - Vinyl object with null for image (reads buffer from provided filepath)

canvas.export(options)

Our export method provides support for the following options:

• options Object
  • background Number[] - rgba array of value for background
    • By default, the background is [0, 0, 0, 0] (transparent black)
    • [0] - Red value for background
      • Can range from 0 to 255
    • [1] - Green value for background
      • Can range from 0 to 255
    • [2] - Blue value for background
      • Can range from 0 to 255
    • [3] - Alpha/transparency value for background
      • Can range from 0 to 255
  • quality Number - Optional quality percentage for JPEG images
    • This value can range from 0 to 100

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint via npm run lint and test via npm test.

Donating

Support this project and others by twolfson via donations.

http://twolfson.com/support-me

Unlicense

As of Nov 24 2014, Todd Wolfson has released this repository and its contents to the public domain.

It has been released under the UNLICENSE.