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()
   102 199  72
    18 137  75
    79  22 235
>>> img.to('float').print()
   0.40 0.78 0.28
   0.07 0.54 0.29
   0.31 0.09 0.92
>>> img = Image.Random(size=3, dtype='float')
>>> img.print()
   0.74 0.91 0.76
   0.29 0.20 0.99
   0.62 0.45 0.22
>>> img.to('uint8').print()
   189 231 193
    74  50 252
   157 114  56

Seealso:: astype to_int to_float