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()
   173  37 156
   181  89  80
   162 200  54
>>> img.to('float').print()
   0.68 0.15 0.61
   0.71 0.35 0.31
   0.64 0.78 0.21
>>> img = Image.Random(size=3, dtype='float')
>>> img.print()
   0.72 0.42 0.91
   0.65 0.55 0.55
   0.81 0.53 0.59
>>> img.to('uint8').print()
   183 108 233
   165 140 141
   206 135 150

Seealso:: astype to_int to_float