U M{ja@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<rIrSrrrverifys 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)Nrrr[rr6rrrr_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;fileno ACCESS_READrGrZ map_bufferimpaletteZdirty ImportError load_preparesortr%Z tile_prefix itertoolsgroupby _getdecoderr8cleanupsetimagepulls_fdsetfddecoder:r@rDrLOAD_TRUNCATED_IMAGESr7load_endr>Z!_close_exclusive_fp_after_loadingrIr)rJrZpixelZuse_mmapr7rlrnZ decoder_namer)r*r+rpr<Zerr_codeprefixrbsenrrrrfs        ""         zImageFile.loadcCsP|jr"|jj|jks"|jj|jkr6tj|j|j|_|jdkrLtj|dS)NP)rsrFrGrrnewrfrSrrrrv<s" zImageFile.load_preparecCsdSrOrrSrrrrDszImageFile.load_endcCsF||jks.t|dr|jdks:||j|jkr:d}t|||kS)N _n_framesz attempt to seek outside sequence)r4rirZn_framesrCtell)rJframerrrr _seek_checkPs zImageFile._seek_check)NN) r,r-r.__doc__r3rTrUrXrfrvrr __classcell__rrrLrr0js0    r0c@s2eZdZdddddZejdddddZd S) StubHandler StubImageFilerW)rsrcCsdSrOrrJrsrrrr;aszStubHandler.openz Image.ImagecCsdSrOrrrrrrfdszStubHandler.loadN)r,r-r.r;abcabstractmethodrfrrrrr`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. rWrNcCsd}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)rh)rarrrr dsz_safe_read..) SAFEBLOCKrlrhrrappendsumjoin)r<rGrrZremaining_sizeblockrrr _safe_readGs(    rc@s(eZdZddddZddddZdS) PyCodecStaterWrNcCsd|_d|_d|_d|_dS)Nr)xsizeysizexoffyoffrSrrrr3kszPyCodecState.__init__r(cCs |j|j|j|j|j|jfSrO)rrrrrSrrrr)qszPyCodecState.extentsN)r,r-r.r3r)rrrrrjsrc@sNeZdZUded<ddZddZddd d Zd d ZddddddZd S)PyCodeczIO[bytes] | NonefdcGs(d|_t|_d|_||_||dSrO)rsrrVrrFinit)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.initrWrNcCsdS)zT Override to perform codec specific cleanup :returns: None NrrSrrrr{szPyCodec.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)rsrGrVrrrr ValueError)rJrsr)Zx0Zy0x1y1rrrrr|s&    zPyCodec.setimage)N) r,r-r.r/r3rr{r~r|rrrrrus   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_fdrSrrrr}szPyDecoder.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)rJrrrrrrs zPyDecoder.decodeNrW)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 rZNrznot enough image datarzcannot decode image data) rFrrzrsrr|rVr)rr)rJrrawmoderrrrrr set_as_raws    zPyDecoder.set_as_raw)N) r,r-r.rrpropertyr}rrrrrrrs  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_fdrSrrrrszPyEncoder.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__rrrrxrDrjtypingrrrrZ _deprecaterZ_utilr r9rrrrrr%r&r0rrrrrrrrrrrrrrsF       w  # J3