Image.astype

Image.astype(dtype: DTypeLike) → Image

Cast 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. Values are retained, only the datatype is changed.

Example:

>>> from machinevisiontoolbox import Image
>>> img = Image.Random(size=3)
>>> img.print()
    62 157  43
     8  13 235
   149  63 192
>>> img.astype('float').print()
    62.00 157.00  43.00
     8.00  13.00 235.00
   149.00  63.00 192.00
>>> img = Image.Random(size=3, dtype='float')
>>> img.print()
   0.08 0.80 0.89
   0.12 0.34 0.84
   0.39 0.98 0.75
>>> img.astype('uint8').print()
   0 0 0
   0 0 0
   0 0 0

Seealso:

to