python-pillow/Pillow
1
1
Fork 0
mirror of https://github.com/python-pillow/Pillow.git synced 2025-01-13 18:56:17 +03:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #1 from radarhere/patch-1

Browse Source 
Added Exif code examples
This commit is contained in:
Vladimir 2023-02-11 21:19:15 -08:00 committed by GitHub
commit d20e250d17
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 29 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

40
src/PIL/Image.py
View File

@ -1433,7 +1433,7 @@ class Image:
def getexif(self):
"""
Gets EXIF data of the image.
Gets EXIF data from the image.
:returns: an :py:class:`~PIL.Image.Exif` object.
"""
@ -3607,18 +3607,36 @@ atexit.register(core.clear_cache)
class Exif(MutableMapping):
"""
Exif class provides read and write access to EXIF image data.
This class provides read and write access to EXIF image data::
Only basic information is available on the root level, in Exif object
itself. In order to access the rest, obtain their respective IFDs using
:py:meth:`~PIL.Image.Exif.get_ifd` method and one of
:py:class:`~PIL.ExifTags.IFD` members (most notably ``Exif`` and
``GPSInfo``).
from PIL import Image
im = Image.open("exif.png")
exif = im.getexif() # Returns an instance of this class
Both root Exif and child IFD objects support dict interface and can be
indexed by int values that are available as enum members of
:py:class:`~PIL.ExifTags.Base`, :py:class:`~PIL.ExifTags.GPS`, and
:py:class:`~PIL.ExifTags.Interop`.
Information can be read and written, iterated over or deleted::
print(exif[274]) # 1
exif[274] = 2
for k, v in exif.items():
print("Tag", k, "Value", v) # Tag 274 Value 2
del exif[274]
To access information beyond IFD0, :py:meth:`~PIL.Image.Exif.get_ifd`
returns a dictionary::
from PIL import ExifTags
im = Image.open("exif_gps.jpg")
exif = im.getexif()
gps_ifd = exif.get_ifd(ExifTags.IFD.GPSInfo)
print(gps_ifd)
Other IFDs include ``ExifTags.IFD.Exif``, ``ExifTags.IFD.Makernote``,
``ExifTags.IFD.Interop`` and ``ExifTags.IFD.IFD1``.
:py:mod:`~PIL.ExifTags` also has enum classes to provide names for data::
print(exif[ExifTags.Base.Software]) # PIL
print(gps_ifd[ExifTags.GPS.GPSDateStamp]) # '1999:99:99 99:99:99'
"""
endian = None