Skip to content

Commit

Permalink
Updated docstring
Browse files Browse the repository at this point in the history
  • Loading branch information
radarhere committed Sep 11, 2021
1 parent e122e8f commit 835aa45
Showing 1 changed file with 30 additions and 24 deletions.
54 changes: 30 additions & 24 deletions src/PIL/TiffImagePlugin.py
Expand Up @@ -437,35 +437,41 @@ class ImageFileDirectory_v2(MutableMapping):
Data Structures:
* self.tagtype = {}
* ``self.tagtype = {}``
* Key: numerical tiff tag number
* Value: integer corresponding to the data type from
~PIL.TiffTags.TYPES`
:attr:`~PIL.TiffTags.TYPES`
.. versionadded:: 3.0.0
"""
.. versionadded:: 3.0.0
"""
Documentation:
'internal' data structures:
* self._tags_v2 = {} Key: numerical tiff tag number
Value: decoded data, as tuple for multiple values
* self._tagdata = {} Key: numerical tiff tag number
Value: undecoded byte string from file
* self._tags_v1 = {} Key: numerical tiff tag number
Value: decoded data in the v1 format
Tags will be found in the private attributes self._tagdata, and in
self._tags_v2 once decoded.
self.legacy_api is a value for internal use, and shouldn't be
changed from outside code. In cooperation with the
ImageFileDirectory_v1 class, if legacy_api is true, then decoded
tags will be populated into both _tags_v1 and _tags_v2. _tags_v2
will be used if this IFD is used in the TIFF save routine. Tags
should be read from _tags_v1 if legacy_api == true.
'internal' data structures:
* ``self._tags_v2 = {}``
* Key: numerical tiff tag number
* Value: decoded data, as tuple for multiple values
* ``self._tagdata = {}``
* Key: numerical tiff tag number
* Value: undecoded byte string from file
* ``self._tags_v1 = {}``
* Key: numerical tiff tag number
* Value: decoded data in the v1 format
Tags will be found in the private attributes ``self._tagdata``, and in
``self._tags_v2`` once decoded.
``self.legacy_api`` is a value for internal use, and shouldn't be changed
from outside code. In cooperation with
:py:class:`~PIL.TiffImagePlugin.ImageFileDirectory_v1`, if ``legacy_api``
is true, then decoded tags will be populated into both ``_tags_v1`` and
``_tags_v2``. ``_tags_v2`` will be used if this IFD is used in the TIFF
save routine. Tags should be read from ``_tags_v1`` if
``legacy_api == true``.
"""

Expand Down

0 comments on commit 835aa45

Please sign in to comment.