image-output

Output image data to a destination: file, canvas, console, stdout, ImageData etc.

Usage

var output = require('image-output')

// create chess pattern png from raw pixels data
output({
	data: [0,0,0,1, 1,1,1,1, 1,1,1,1, 0,0,0,1],
	width: 2,
	height: 2
}, 'chess.png')

API

output(source, destination?, options?)

Output pixel data source to a destination based on options. Undefined destination displays image to console/stdout. The operation is done in sync fashion.

source

Shoud be an actual image data container, one of:

• Canvas, Context2D, WebGLContext
• ImageData
• Object {data: Uint8Array, width, height}
• DataURL or base64 string
• Image, Video, ImageBitmap with resolved data
• Array, Array of Arrays, Uint8Array, FloatArray with raw pixels
• ArrayBuffer, Buffer
• Ndarray

Handy for that purpose is image-pixels:

var pixels = require('image-pixels')
output(await pixels('image.png'), 'image-copy.png')

destination

Can be any image output destination:

options

Customize color palette in terminal

You can choose color palette with flags or environment variable FORCE_COLOR=0123

node ./script.js --no-color
node ./script.js --color
node ./script.js --color=256
node ./script.js --color=16m

Related

• image-equal − compare if two images are equal.
• image-pixels − load image data from any source.
• image-encode − encode image data into one of the target formats.

Similar

• save-pixels − output ndarray with image pixels to a file.
• terminal-image − print image to a terminal.

License

© 2018 Dmitry Iv. MIT License.