Image.metadata

Image.metadata(key: str | None = None) → Any

Get image EXIF metadata

Parameters:

key (str, optional) – metadata key

Returns:

image metadata

Return type:

dict, int, float, str

Get image metadata from EXIF headers.

Example:

>>> from machinevisiontoolbox import Image
>>> img = Image.Read('church.jpg')
>>> meta = img.metadata()  # get all metadata as a dict
>>> len(meta)
9
>>> meta
{'ResolutionUnit': 2, 'ExifOffset': 188, 'Make': 'Panasonic', 'Model': 'DMC-FZ30', 'Software': 'Ver.1.0  ', 'Orientation': 1, 'DateTime': '2009:08:22 15:50:06', 'XResolution': 72.0, 'YResolution': 72.0}
>>> meta['Make']
'Panasonic'
>>> img.metadata('Make')  # get specific metadata item
'Panasonic'

Note

Metadata items will be converted, where possible, to int or float values.