U ڲga@shddlmZddlZddlZddlZddlZddlZddlmZm Z m Z ddl m Z ddl mZddlmZdZd Zd Zd d d dddZddddddZdddddZddZGddde ZGddde j ZGd d!d!ZGd"d#d#eZGd$d%d%Zd8d&d'd(d)Zd9d*d+d,d-Zd.d/ZGd0d1d1Z Gd2d3d3Z!Gd4d5d5e!Z"Gd6d7d7e!Z#dS):) annotationsN)IOAny NamedTuple)Image) deprecate)is_pathiiFzimage buffer overrun errorzdecoding errorz unknown errorzbad configurationzout of memory error)iintboolOSError)errorencoderreturncCsjztj|}Wntk r.t|}YnX|sJ|rr<rIrRrrrverifys zImageFile.verifyc Cs|jdkrd}t|tj|}|js,|Sd|_|joDt|jdk}|oTttd }d}z|j }d}Wnt k r|j j }YnXz|j }d}Wnt k r|j j}YnX|r|jd\}}} } t| tr| ddf} |dkrt| dkr| d|jkr| dtjkrzddl} t|j} | j| d| jd |_W5QRX| |jd| d|jkr|d }t|tj|j|j|| | |_d}|jrd|j_Wn"t ttfk rd|_YnX|d } |jsh|jjt d z |j!}Wnt k rd }YnXddt"#|jddD|_|jD](\}}} } || t$|j|| |j%}z|'|j||j(r|)|j |*d d} n|}z||j+}WnJt,t-j.fk r}z$t/rWYqVnd}t||W5d}~XYnX|s"t/r qVndt|d}t|||}|*|\}} |dkrFqV||d}qW5|&Xqsz"ImageFile.load..cSs|d|d|dfS)NrrrZrr6rrrr^z ImageFile.load..zimage file is truncatedzimage file is truncated (z bytes not processed)r")6r6rrloadmapr=lenhasattrsys load_readrr<read load_seekseek isinstancer'rFZ _MAPMODESmmapr;filenoZ ACCESS_READrGrZ map_bufferimZpaletteZdirty ImportError load_preparesortr%Z tile_prefix itertoolsgroupby _getdecoderr8cleanupsetimagepulls_fdsetfddecoder:r@rDrLOAD_TRUNCATED_IMAGESr7load_endr>Z!_close_exclusive_fp_after_loadingrIr)rJrZpixelZuse_mmapr7rkrmZ decoder_namer)r*r+ror<Zerr_codeprefixrbsenrrrres        ""         zImageFile.loadcCsP|jr"|jj|jks"|jj|jkr6tj|j|j|_|jdkrLtj|dS)NP)rqrFrGrrnewrerRrrrrs<s" zImageFile.load_preparecCsdSrOrrRrrrr~DszImageFile.load_endcCsF||jks.t|dr|jdks:||j|jkr:d}t|||kS)N _n_framesz attempt to seek outside sequence)r4rhrZn_framesrCtell)rJframerrrr _seek_checkPs zImageFile._seek_check)NN) r,r-r.__doc__r3rSrTrWrersr~r __classcell__rrrLrr0js0    r0c@s2eZdZdddddZejdddddZd S) StubHandler StubImageFilerV)rqrcCsdSrOrrJrqrrrr;aszStubHandler.openz Image.ImagecCsdSrOrrrrrredszStubHandler.loadN)r,r-r.r;abcabstractmethodrerrrrr`src@s4eZdZdZddddZddZddd d Zd S) rz Base class for stub image loaders. A stub loader is an image loader that can identify files of a certain format, but relies on external code to load the file. rVrNcCsd}t|dS)Nz+StubImageFile subclass must implement _openNotImplementedErrorrJrrrrr?qszStubImageFile._opencCsT|}|dkr&d|jd}t|||}|dk sread method. :param size: Number of bytes to read. :returns: A string containing size bytes of data. Raises an OSError if the file is truncated and the read cannot be completed rr^zTruncated File Readcss|]}t|VqdSrO)rg)r`rrrr dsz_safe_read..) SAFEBLOCKrkrgrrappendsumjoin)r<rGrrZremaining_sizeblockrrr _safe_readGs(    rc@s(eZdZddddZddddZdS) PyCodecStaterVrNcCsd|_d|_d|_d|_dS)Nr)xsizeysizexoffyoffrRrrrr3kszPyCodecState.__init__r(cCs |j|j|j|j|j|jfSrO)rrrrrRrrrr)qszPyCodecState.extentsN)r,r-r.r3r)rrrrrjsrc@sNeZdZUded<ddZddZddd d Zd d ZddddddZd S)PyCodeczIO[bytes] | NonefdcGs(d|_t|_d|_||_||dSrO)rqrrUrrFinit)rJrFr+rrrr3xs zPyCodec.__init__cCs ||_dS)z Override to perform codec specific initialization :param args: Array of args items from the tile entry :returns: None N)r+rrrrrsz PyCodec.initrVrNcCsdS)zT Override to perform codec specific cleanup :returns: None NrrRrrrrxszPyCodec.cleanupcCs ||_dS)z Called from ImageFile to set the Python file-like object :param fd: A Python file-like object :returns: None N)r)rJrrrrr{sz PyCodec.setfdNz tuple[int, int, int, int] | None)r)rcCs||_|r|\}}}}n d\}}}}|dkrJ|dkrJ|jj\|j_|j_n(||j_||j_|||j_|||j_|jjdks|jjdkrd}t||jj|jj|jjdks|jj|jj|jjdkrd}t|dS)z Called from ImageFile to set the core output image for the codec :param im: A core image object :param extents: a 4 tuple of (x0, y0, x1, y1) defining the rectangle for this tile :returns: None )rrrrrzSize cannot be negativerz Tile cannot extend outside imageN)rqrGrUrrrr ValueError)rJrqr)Zx0Zy0x1y1rrrrrys&    zPyCodec.setimage)N) r,r-r.r/r3rrxr{ryrrrrrus   rc@sHeZdZdZdZeddddZddd d d Zddd dddZd S) PyDecoderz Python implementation of a format decoder. Override this class and add the decoding logic in the :meth:`decode` method. See :ref:`Writing Your Own File Codec in Python` FrrNcCs|jSrO) _pulls_fdrRrrrrzszPyDecoder.pulls_fdbytestuple[int, int])bufferrcCsd}t|dS)a= Override to perform the decoding process. :param buffer: A bytes object with the data to be decoded. :returns: A tuple of ``(bytes consumed, errcode)``. If finished with decoding return -1 for the bytes consumed. Err codes are from :data:`.ImageFile.ERRORS`. zunavailable in base decoderNr)rJrrrrrr|s zPyDecoder.decodeNrV)rrcCsz|s |j}t|jd|}|jdk s(t||j|j||}|ddkr^d}t ||ddkrvd}t |dS)a Convenience method to set the internal image from a stream of raw data :param data: Bytes to be set :param rawmode: The rawmode to be used for the decoder. If not specified, it will default to the mode of the image :returns: None rYNrznot enough image datarzcannot decode image data) rFrrwrqrryrUr)r|r)rJrrawmoderrrrrr set_as_raws    zPyDecoder.set_as_raw)N) r,r-r.rrpropertyrzr|rrrrrrs  rc@sLeZdZdZdZeddddZddd d d Zd dd dZddZ dS) PyEncoderz Python implementation of a format encoder. Override this class and add the decoding logic in the :meth:`encode` method. See :ref:`Writing Your Own File Codec in Python` FrrNcCs|jSrO) _pushes_fdrRrrrrszPyEncoder.pushes_fdrztuple[int, int, bytes])rrcCsd}t|dS)a  Override to perform the encoding process. :param bufsize: Buffer size. :returns: A tuple of ``(bytes encoded, errcode, bytes)``. If finished with encoding return 1 for the error code. Err codes are from :data:`.ImageFile.ERRORS`. zunavailable in base encoderNr)rJrrrrrrs zPyEncoder.encodercCs@|js dS|d\}}}|r8|jdk s,t|j|||fS)z If ``pushes_fd`` is ``True``, then this method will be used, and ``encode()`` will only be called once. :returns: A tuple of ``(bytes consumed, errcode)``. Err codes are from :data:`.ImageFile.ERRORS`. )rr rN)rrrrr)rJZbytes_consumedrrrrrr s zPyEncoder.encode_to_pyfdcCs<d}|dkr8||\}}}|dkr|||dq|S)z :param fh: File handle. :param bufsize: Buffer size. :returns: If finished successfully, return 0. Otherwise, return an error code. Err codes are from :data:`.ImageFile.ERRORS`. rN)rr)rJrrrstatusbufrrrrs zPyEncoder.encode_to_fileN) r,r-r.rrrrrrrrrrrrs r)r)N)$ __future__rrrrurDritypingrrrrZ _deprecaterZ_utilr r9rr}rrrr%r&r0rrrrrrrrrrrrrrsF       w  # J3