Image.to#

Image.to(dtype: DTypeLike) → Image[source][source]#

Convert image datatype

Parameters:: dtype (str or NumPy dtype) – Numpy data type

The short-name aliases 'int', 'float', 'double', 'half' are also accepted and resolve to the Toolbox’s own defaults (uint8, float32, float64, float16 respectively) – this matters because NumPy’s own np.dtype('float') resolves to float64, not float32. See DTYPE_ALIASES.

Returns:: image
Return type:: Image

Create a new image, same size as input image, with pixels of a different datatype. Integer values are scaled according to the maximum value of the datatype, floating values are in the range 0.0 to 1.0.

Example:

>>> from machinevisiontoolbox import Image
>>> img = Image.Random(size=3)
>>> img.print()
    68  77 170
   239 205  22
   253 232  36
>>> img.to('float').print()
   0.27 0.30 0.67
   0.94 0.80 0.09
   0.99 0.91 0.14
>>> img = Image.Random(size=3, dtype='float')
>>> img.print()
   0.94 0.52 0.74
   0.97 0.63 0.14
   0.85 0.30 0.19
>>> img.to('uint8').print()
   241 132 188
   246 161  35
   216  77  49

Seealso:: astype to_int to_float