colour.io.read_image_Imageio

colour.io.read_image_Imageio(path: str, bit_depth: Literal['uint8', 'uint16', 'float16', 'float32', 'float64', 'float128'] = 'float32', **kwargs: Any) numpy.ndarray[source]

Read the image at given path using Imageio.

Parameters
  • path (str) – Image path.

  • bit_depth (Literal['uint8', 'uint16', 'float16', 'float32', 'float64', 'float128']) – Returned image bit depth, the image data is converted with colour.io.convert_bit_depth() definition after reading the image.

  • kwargs (Any) – Keywords arguments.

Returns

Image data.

Return type

class`numpy.ndarray`

Notes

  • For convenience, single channel images are squeezed to 2D arrays.

Examples

>>> import os
>>> import colour
>>> path = os.path.join(colour.__path__[0], 'io', 'tests', 'resources',
...                     'CMS_Test_Pattern.exr')
>>> image = read_image_Imageio(path)
>>> image.shape  
(1267, 1274, 3)
>>> image.dtype
dtype('float32')