File: //home/arjun/projects/env/lib/python3.10/site-packages/docx/image/__pycache__/tiff.cpython-310.pyc
o
$we�( � @ s� d dl mZmZmZ d dlmZmZmZ d dlm Z G dd� de �Z
G dd� d�Z G dd � d �Z G d
d � d �Z
d d
� ZG dd� d�ZG dd� de�ZG dd� de�ZG dd� de�ZG dd� de�ZdS )� )� MIME_TYPE�TIFF_FLD�TIFF_TAG)�
BIG_ENDIAN�
LITTLE_ENDIAN� StreamReader)�BaseImageHeaderc @ s4 e Zd ZdZedd� �Zedd� �Zedd� �ZdS ) �Tiffz`Image header parser for TIFF images.
Handles both big and little endian byte ordering.
c C s t jS )z[Return the MIME type of this TIFF image, unconditionally the string
``image/tiff``.)r �TIFF��self� r
�H/home/arjun/projects/env/lib/python3.10/site-packages/docx/image/tiff.py� content_type s zTiff.content_typec C � dS )z:Default filename extension, always 'tiff' for TIFF images.�tiffr
r r
r
r � default_ext s zTiff.default_extc C s0 t �|�}|j}|j}|j}|j}| ||||�S )zYReturn a |Tiff| instance containing the properties of the TIFF image in
`stream`.)� _TiffParser�parse�px_width� px_height�horz_dpi�vert_dpi)�cls�stream�parserr r r r r
r
r � from_stream s
zTiff.from_streamN) �__name__�
__module__� __qualname__�__doc__�propertyr r � classmethodr r
r
r
r r s
r c s| e Zd ZdZ� fdd�Zedd� �Zedd� �Zedd � �Z ed
d � �Z
ed d
� �Z edd� �Z dd� Z
edd� �Z� ZS )r zkParses a TIFF image stream to extract the image properties found in its main
image file directory (IFD)c � t t| ��� || _d S �N)�superr �__init__� _ifd_entries)r � ifd_entries�� __class__r
r r& ) �
z_TiffParser.__init__c C s( | � |�}|�d�}t�||�}| |�S )zmReturn an instance of |_TiffParser| containing the properties parsed from the
TIFF image in `stream`.� )�_make_stream_reader� read_long� _IfdEntriesr )r r �
stream_rdr� ifd0_offsetr( r
r
r r - s
z_TiffParser.parsec C � | � tj�S )z�The horizontal dots per inch value calculated from the XResolution and
ResolutionUnit tags of the IFD; defaults to 72 if those tags are not present.)�_dpir � X_RESOLUTIONr r
r
r r 6 � z_TiffParser.horz_dpic C r2 )z�The vertical dots per inch value calculated from the XResolution and
ResolutionUnit tags of the IFD; defaults to 72 if those tags are not present.)r3 r � Y_RESOLUTIONr r
r
r r < r5 z_TiffParser.vert_dpic C � | j �tj�S )z�The number of stacked rows of pixels in the image, |None| if the IFD contains
no ``ImageLength`` tag, the expected case when the TIFF is embeded in an Exif
image.)r' �getr � IMAGE_LENGTHr r
r
r r B � z_TiffParser.px_heightc C r7 )z�The number of pixels in each row in the image, |None| if the IFD contains no
``ImageWidth`` tag, the expected case when the TIFF is embeded in an Exif
image.)r' r8 r � IMAGE_WIDTHr r
r
r r I r: z_TiffParser.px_widthc C s$ |� d� |�d�}|dkrtS tS )z�Return either BIG_ENDIAN or LITTLE_ENDIAN depending on the endian indicator
found in the TIFF `stream` header, either 'MM' or 'II'.� � s MM)�seek�readr r )r r �
endian_strr
r
r �_detect_endianP s
z_TiffParser._detect_endianc C s^ | j }||vr dS tj|v r|tj nd}|dkrdS |dkr!dnd}|| }tt|| ��S )a! Return the dpi value calculated for `resolution_tag`, which can be either
TIFF_TAG.X_RESOLUTION or TIFF_TAG.Y_RESOLUTION.
The calculation is based on the values of both that tag and the
TIFF_TAG.RESOLUTION_UNIT tag in this parser's |_IfdEntries| instance.
�H r= r gR� ��Q@)r' r �RESOLUTION_UNIT�int�round)r �resolution_tagr( �resolution_unit�units_per_inch�
dots_per_unitr
r
r r3 X s
��z_TiffParser._dpic C s | � |�}t||�S )z�Return a |StreamReader| instance with wrapping `stream` and having "endian-
ness" determined by the 'MM' or 'II' indicator in the TIFF stream header.)rA r )r r �endianr
r
r r- r s
z _TiffParser._make_stream_reader)r r r r r& r" r r! r r r r rA r3 r- �
__classcell__r
r
r) r r % s$
r c sF e Zd ZdZ� fdd�Zdd� Zdd� Zedd � �Zd
d d �Z � Z
S )r/ z}Image File Directory for a TIFF image, having mapping (dict) semantics allowing
"tag" values to be retrieved by tag code.c r# r$ )r% r/ r& �_entries)r �entriesr) r
r r& ~ r+ z_IfdEntries.__init__c C � | j �|�S )z5Provides ``in`` operator, e.g. ``tag in ifd_entries``)rL � __contains__�r �keyr
r
r rO � � z_IfdEntries.__contains__c C rN )zCProvides indexed access, e.g. ``tag_value = ifd_entries[tag_code]``)rL � __getitem__rP r
r
r rS � rR z_IfdEntries.__getitem__c C s$ t ||�}dd� |�� D �}| |�S )zVReturn a new |_IfdEntries| instance parsed from `stream` starting at
`offset`.c S s i | ]}|j |j�qS r
)�tag�value)�.0�er
r
r �
<dictcomp>� s z+_IfdEntries.from_stream.<locals>.<dictcomp>)�
_IfdParser� iter_entries)r r �offset�
ifd_parserrM r
r
r r � s
z_IfdEntries.from_streamNc C s | j �||�S )zhReturn value of IFD entry having tag matching `tag_code`, or `default` if no
matching tag found.)rL r8 )r �tag_code�defaultr
r
r r8 � � z_IfdEntries.getr$ ) r r r r r& rO rS r" r r8 rK r
r
r) r r/ z s
r/ c s4 e Zd ZdZ� fdd�Zdd� Zedd� �Z� ZS )rY zaService object that knows how to extract directory entries from an Image File
Directory (IFD)c � t t| ��� || _|| _d S r$ )r% rY r& � _stream_rdr�_offset)r r0 r[ r) r
r r& � �
z_IfdParser.__init__c c s: � t | j�D ]}| jd |d }t| j|�}|V qdS )zVGenerate an |_IfdEntry| instance corresponding to each entry in the
directory.r= � N)�range� _entry_countrb �_IfdEntryFactoryra )r �idx�dir_entry_offset� ifd_entryr
r
r rZ � s � �z_IfdParser.iter_entriesc C s | j �| j�S )zDThe count of directory entries, read from the top of the IFD header.)ra �
read_shortrb r r
r
r rf � r_ z_IfdParser._entry_count) r r r r r& rZ r! rf rK r
r
r) r rY � s rY c C s@ t jtt jtt jtt jti}| � |d�}|�
|t �}|� | |�S )ztReturn an |_IfdEntry| subclass instance containing the value of the directory
entry at `offset` in `stream_rdr`.r= )
r �ASCII�_AsciiIfdEntry�SHORT�_ShortIfdEntry�LONG�
_LongIfdEntry�RATIONAL�_RationalIfdEntryrk r8 � _IfdEntryr )r0 r[ �ifd_entry_classes�
field_type�EntryClsr
r
r rg � s � rg c sP e Zd ZdZ� fdd�Zedd� �Zedd� �Zedd � �Z ed
d � �Z
� Z S ) rt zsBase class for IFD entry classes.
Subclasses are differentiated by value type, e.g. ASCII, long int, etc.
c r` r$ )r% rt r& � _tag_code�_value)r r] rU r) r
r r& � rc z_IfdEntry.__init__c C s> |� |d�}|�|d�}|�|d�}| �||||�}| ||�S )a! Return an |_IfdEntry| subclass instance containing the tag and value of the
tag parsed from `stream_rdr` at `offset`.
Note this method is common to all subclasses. Override the ``_parse_value()``
method to provide distinctive behavior based on field type.
r< r, � )rk r. � _parse_value)r r0 r[ r] � value_count� value_offsetrU r
r
r r � s
z_IfdEntry.from_streamc C r )zReturn the value of this field parsed from `stream_rdr` at `offset`.
Intended to be overridden by subclasses.
zUNIMPLEMENTED FIELD TYPEr
�r r0 r[ r| r} r
r
r r{ � s z_IfdEntry._parse_valuec C � | j S )z.Short int code that identifies this IFD entry.)rx r r
r
r rT � � z
_IfdEntry.tagc C r )z7Value of this tag, its type being dependent on the tag.)ry r r
r
r rU � r� z_IfdEntry.value) r r r r r& r" r r{ r! rT rU rK r
r
r) r rt � s
rt c @ � e Zd ZdZedd� �ZdS )rm z<IFD entry having the form of a NULL-terminated ASCII string.c C s |� |d |�S )z�Return the ASCII string parsed from `stream_rdr` at `value_offset`.
The length of the string, including a terminating ' ' (NUL) character, is in
`value_count`.
r )�read_strr~ r
r
r r{ � s z_AsciiIfdEntry._parse_valueN�r r r r r" r{ r
r
r
r rm � � rm c @ r� )ro z0IFD entry expressed as a short (2-byte) integer.c C � |dkr
|� |d�S dS )z�Return the short int value contained in the `value_offset` field of this
entry.
Only supports single values at present.
r rz z)Multi-value short integer NOT IMPLEMENTED)rk r~ r
r
r r{ � � z_ShortIfdEntry._parse_valueNr� r
r
r
r ro � r� ro c @ r� )rq z/IFD entry expressed as a long (4-byte) integer.c C r� )z�Return the long int value contained in the `value_offset` field of this
entry.
Only supports single values at present.
r rz z(Multi-value long integer NOT IMPLEMENTED�r. r~ r
r
r r{ r� z_LongIfdEntry._parse_valueNr� r
r
r
r rq r� rq c @ r� )rs z5IFD entry expressed as a numerator, denominator pair.c C s* |dkr|� |�}|� |d�}|| S dS )z�Return the rational (numerator / denominator) value at `value_offset` in
`stream_rdr` as a floating-point number.
Only supports single values at present.
r r, z$Multi-value Rational NOT IMPLEMENTEDr� )r r0 r[ r| r} � numerator� denominatorr
r
r r{ s
z _RationalIfdEntry._parse_valueNr� r
r
r
r rs r� rs N)� constantsr r r �helpersr r r �imager r r r/ rY rg rt rm ro rq rs r
r
r
r �<module> s U ,