diff options
Diffstat (limited to 'doc/tutorial.rst')
| -rw-r--r-- | doc/tutorial.rst | 23 |
1 files changed, 23 insertions, 0 deletions
diff --git a/doc/tutorial.rst b/doc/tutorial.rst index 0574aa3..a5bc849 100644 --- a/doc/tutorial.rst +++ b/doc/tutorial.rst @@ -209,3 +209,26 @@ pair (see exiv2's documentation for a list of valid >>> value = 'A beautiful picture.' >>> metadata[key] = pyexiv2.XmpTag(key, value) +Accessing embedded previews +########################### + +Images may embed previews (also called thumbnails) of various sizes in their +metadata. pyexiv2 allows to easily access them:: + + >>> previews = metadata.previews + + >>> len(previews) + 2 + +They are sorted by increasing size. Let's play with the largest one:: + + >>> largest = previews[-1] + + >>> largest.dimensions + (320, 240) + + >>> largest.mime_type + 'image/jpeg' + + >>> largest.write_to_file('largest') + |