colour.io.convert_bit_depth#

colour.io.convert_bit_depth(a: ArrayLike, bit_depth: Literal['uint8', 'uint16', 'float16', 'float32', 'float64', 'float128'] = 'float32') numpy.ndarray[source]#

Convert given array to given bit depth, the current bit depth of the array is used to determine the appropriate conversion path.

Parameters
  • a (ArrayLike) – Array to convert to given bit depth.

  • bit_depth (Literal['uint8', 'uint16', 'float16', 'float32', 'float64', 'float128']) – Bit depth.

Returns

Converted array.

Return type

class`numpy.ndarray`

Examples

>>> a = np.array([0.0, 0.5, 1.0])
>>> convert_bit_depth(a, 'uint8')
array([  0, 128, 255], dtype=uint8)
>>> convert_bit_depth(a, 'uint16')
array([    0, 32768, 65535], dtype=uint16)
>>> convert_bit_depth(a, 'float16')
array([ 0. ,  0.5,  1. ], dtype=float16)
>>> a = np.array([0, 128, 255], dtype=np.uint8)
>>> convert_bit_depth(a, 'uint16')
array([    0, 32896, 65535], dtype=uint16)
>>> convert_bit_depth(a, 'float32')  
array([ 0.       ,  0.501960...,  1.       ], dtype=float32)