Pixels, Please

An image loading module for graphics applications.

• Supports many popular image formats.
• Image resizing.
• Pixel data conversion for 32-bit texture formats.
• Non-blocking image loading and processing.

Tested on Windows, Mac and Linux (including Raspberry Pi).

Requirements

• Pixels, Please contains native code and requires a system with a proper C++ toolchain (node-gyp).

Install

npm install --save pixels-please

yarn add pixels-please

• Installation requires node-gyp.

Examples

Asynchronously load image data into a Buffer.

const Pipeline = require('pixels-please');

Pipeline(imageFilename)
    .bytes({format: 'argb'})
    .toBuffer()
    .then(buffer => {
        // ...
    });

Synchronously load image data into a Buffer in 32 bit ARGB format.

const Pipeline = require('pixels-please');

let buffer = Pipeline(imageFilename)
    .bytes({format: 'argb'})
    .toBufferSync();

Read the image header for size information.

const Pipeline = require('pixels-please');

let header = Pipeline(imageFilename)
    .toHeaderSync();

console.log(`${header.width}x${header.height}`);

Resize an image to fit into a 100x100 bounding box, preserving aspect ratio.

const Pipeline = require('pixels-please');

let buffer = Pipeline(imageFilename)
    .bytes()
    .fit()
    .filter('gaussian')
    .resize(100, 100)
    .toBufferSync();

Image Formats

License

Code is under the MIT License.