Get 4-channel pixels array from an ndarray or nested array

  • pxls

Downloads in past


322.3.25 years ago5 years agoMinified + gzip package size for pxls in KB


pxls unstable Build Status
Take in custom pixels container, return normalized 4-channel Uint8Array with pixels. Detects float/int input pixels, handles Infinities, unfolds structures. npm install pxls ```js var pxls = require('pxls') var ndarray = require('ndarray') pxls(0,0,0, 1,1,1) // pxls(0, 1, 1) // pxls(0,0,0, 1,1,1, 2,1) // pxls(new Ndarray(0,1, 2,1) // pxls(new Ndarray(0,0,0,1,1,1, 2,1,3) // ```

let pixels = pxls(arr, shape|step?)

Takes input actual pixels container arr and returns 4 channels flat Uint8Array pixels with layout [r,g,b,a, r,g,b,a, r,g,b,a, ...]. arr can be an Array of Arrays, TypedArray, Ndarray, ImageData or DOM container Image, Video, ImageBitmap, Canvas2D, Context2D, WebGLContext. 1-channel input is mapped as grayscale [v,v,v,255, v,v,v,255]. 3-channel input fills last channel with 255 [r,g,b,255, r,g,b,255]. shape can describe the shape of input array, eg. [100,100,3] or [10,10]. step optionally can define input number of channels in flat array, that is detected automatically for nested/ndarrays.

See also

  • to-uint8 − convert input argument to uint8 array.


(c) 2018 Dmitry Yv. MIT License