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()
   223 108 224
   117 107 253
    36 130 190
>>> img.astype('float').print()
   223.00 108.00 224.00
   117.00 107.00 253.00
    36.00 130.00 190.00
>>> img = Image.Random(size=3, dtype='float')
>>> img.print()
   0.22 0.53 0.42
   0.61 0.15 0.07
   0.06 1.00 0.06
>>> img.astype('uint8').print()
   0 0 0
   0 0 0
   0 0 0

Seealso:

to