to-uint8

Convert input array to uint8 array, detecting floats if required. Useful to ensure that an input array contains pixels/colors.

var u8 = require('to-uint8')

var pixels = u8([[0,0,0,1], [1,1,1,1]]) // <uint8 0,0,0,255, 255,255,255,255>

u8data = u8(data, detectFloat=true)

Return Uint8Array u8data with input data values, possibly converted from floats, if required. data can be an Array, Array of Arrays, TypedArray, Buffer, ArrayBuffer, base64 string or any other container.

u8(new Uint16Array([0, 1, 2])) // <uint8 0, 1, 2>
u8(new Float32Array([0, .5, 1])) // <uint8 0, 127, 255>
u8(new Float64Array([0, .5, 1])) // <uint8 0, 127, 255>
u8([0, .5, 1]) // <uint8 0, 127, 255>
u8([[0,0,0,0], [1,1,1,1]]) // <uint8 0,0,0,0, 255,255,255,255>

// untyped array with int-ish values doesn't get converted
u8([0, 1, 255]) // <uint8 0, 1, 255>

// unless passed a flag to force conversion
u8([0, 1, 255], false) // <uint8 0, 255, 255>

// bad data returns null
u8(/abc/) // null

See also

• to-array-buffer − convert anything to ArrayBuffer
• to-float32 − convert anything to float32.

License

(c) 2018 Dmitry Yv. MIT License