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()
   232 106 253
   240  15  73
   151  84 115
>>> img.to('float').print()
   0.91 0.42 0.99
   0.94 0.06 0.29
   0.59 0.33 0.45
>>> img = Image.Random(size=3, dtype='float')
>>> img.print()
   0.74 0.58 0.43
   0.82 0.61 0.21
   0.21 0.05 0.96
>>> img.to('uint8').print()
   190 148 110
   208 155  53
    54  13 244

Seealso:: astype to_int to_float