1.8 KiB
pxls 
Take in custom pixels container, return normalized 4-channel Uint8Array with pixels. Detects float/int input pixels, handles Infinities, unfolds structures.
var pxls = require('pxls')
var ndarray = require('ndarray')
pxls([[0,0,0], [1,1,1]]) // <uint8 0,0,0,255, 255,255,255,255>
pxls([0, 1], 1) // <uint8 0,0,0,255, 255,255,255,255>
pxls([0,0,0, 1,1,1], [2,1]) // <uint8 0,0,0,255, 255,255,255,255>
pxls(new Ndarray([0,1], [2,1]) // <uint8 0,0,0,255, 255,255,255,255>
pxls(new Ndarray([0,0,0,1,1,1], [2,1,3]) // <uint8 0,0,0,255, 255,255,255,255>
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.
- ndarray-to-bitmap-rgba − convert ndarray to rgba bitmap ndarray.
License
(c) 2018 Dmitry Yv. MIT License