Skip to content

mattdesl/get-image-pixels

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

browser support

get-image-pixels

experimental

Uses an intermediary canvas node to grab the RGBA pixels of the given source, with an optional clipping region. Works on HTML Canvas, Image, and Video elements.

var getPixels = require('get-image-pixels')

var data = getPixels(myImage) // returns a Uint8Array
console.log( data.length === (myImage.width * myImage.height * 4) ) //true

Or, with clipping:

var halfWidth = myImage.width/2
var data = getPixels(myImage, { x: halfWidth, width: halfWidth })
console.log( data.length === (halfWidth * myImage.height * 4) ) //true

Usage

NPM

getPixels(image[, opts])

Gets the RGBA pixels from HTML Image/Video/Canvas element as a Uint8Array with some optional parameters.

  • x the x position to start clipping, default 0
  • y the y position to start clipping, default 0
  • width the width of the source to copy; this will change the returned array's shape. defaults to image width
  • height the height of the source to copy; this will change the returned array's shape. defaults to image height

getPixels.dispose()

Release the shared canvas for GC. This is mainly useful if you need to minimize disruptive GC hitches, e.g. in a game loop.

License

MIT, see LICENSE.md for details.

About

Gets the RGBA pixel array from an Image/Video/Canvas source

Resources

License

Stars

Watchers

Forks

Packages

No packages published