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()
   207 161  76
   198 245 204
    69 190 174
>>> img.astype('float').print()
   207.00 161.00  76.00
   198.00 245.00 204.00
    69.00 190.00 174.00
>>> img = Image.Random(size=3, dtype='float')
>>> img.print()
   0.17 0.84 0.34
   0.36 0.21 0.23
   0.34 0.78 0.31
>>> img.astype('uint8').print()
   0 0 0
   0 0 0
   0 0 0

Seealso:

to