o \"r?rGrYrcry __classcell__rrr7rrYs/ | rc@s(eZdZdZddZddZddZdS) StubImageFilez 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. cCtd)Nz+StubImageFile subclass must implement _openNotImplementedErrorr=rrrr*AszStubImageFile._opencCsL|}|durtd|jd||}|dusJ|j|_|j|_dS)Nzcannot find loader for this z file)_loadr r:rGr8__dict__)r5loaderimagerrrrGDs   zStubImageFile.loadcCr)z (Hook) Find actual image loader.z+StubImageFile subclass must implement _loadrr=rrrrNrzStubImageFile._loadN)rzr{r|r}r*rGrrrrrr9s  rc@sPeZdZdZdZdZdZdZdZdZ ddZ ddZ dd Z d d Z d d ZdS)Parserzj Incremental image parser. This class implements the standard feed/close consumer interface. NrcCs|jdus JddS)z (Consumer) Reset the parser. Note that you can only call this method immediately after you've created a parser; parser instances cannot be reused. Nzcannot reuse parsers)datar=rrrreset`sz Parser.resetc Cs|jrdS|jdur||_n|j||_|jrh|jdkr=tt|j|j}|j|d|_|j||_|jdks;|js=dS|j|j\}}|dkr^d|_d|_|dkr\d|_t|ndS|j|d|_dS|jrmdSzt |j }t |}Wdn1swYWn t yYdSwt|dpt|d}|st|jdkrd|_n:||jd\}}} } g|_t |j|| |j|_|j|j|| |_|jt|jkr|j|jd|_d|_||_dS)z (Consumer) Feed data to the parser. :param data: A string buffer. :exception OSError: If the parser failed to parse the image file. NrrrNrL)finishedrrmriminrIr`rrioBytesIOrr&r rJr!rYr\r1r#r]rU) r5rskiprrrqr'rUflagdoarrrfeedhsX         z Parser.feedcCs|Sr9rr=rrr __enter__szParser.__enter__cGs |dSr9)r4r5rjrrr__exit__s zParser.__exit__c Cs|jr|dd|_|_|jstd|jstd|jrKt|j}z t ||_W|j n|j wWd|jS1sFwY|jS)a (Consumer) Close the stream. :returns: An image object. :exception OSError: If the parser failed to parse the image file either because it cannot be identified or cannot be decoded. rFNzimage was incompletezcannot parse this image) rmrrrr rrrrr&rG)r5r'rrrr4s    z Parser.close)rzr{r|r} incrementalrrrmrirrrrrr4rrrrrSsP rc Cs|t|ds d|_|jtdtt||jdd}z |tj kp(|tj j k}Wn t t fy7d}Ynw|r@| dSz |}| Wnjt tjfy}z[|D]R\}}} } t|j|| |j}| dkrp|| ||j||jr|||\} } n ||\} } } || | rnq| dkrt d | d ||qWWYd}~nMd}~ww|D]E\}}} } t|j|| |j}| dkr|| ||j||jr|||\} } n|||} | dkrt d | d |qt|d r | dSdS) zHelper to save image based on tile list :param im: Image object. :param fp: File object. :param tile: Tile list. :param bufsize: Optional buffer size encoderconfigrrDrFNTzencoder error z when writing image fileflush)rGrJrrZrmaxr$r2rKstdoutbufferr r rrRrUnsupportedOperationr _getencoderr1rOr]rU pushes_fdr_encode_to_pyfdencodewriterbencode_to_file)rUr'r!bufsizerfhexcrqrorrlrprrrr_savesh              rcCs|dkrdS|tkr||}t||krtd|Sg}|dkr;|t|t}|s,n|||t|8}|dks!tdd|D|krJtdd|S)a Reads large blocks in a safe way. Unlike fp.read(n), this function doesn't trust the user. If the requested size is larger than SAFEBLOCK, the file is read block by block. :param fp: File handle. Must implement a read 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 rrFzTruncated File Readcss|]}t|VqdSr9)rI).0rrrr ;sz_safe_read..) SAFEBLOCKrMrIr rappendsumjoin)r'r2rblockrrr _safe_read s$      rc@seZdZddZddZdS) PyCodecStatecCsd|_d|_d|_d|_dS)Nr)xsizeysizexoffyoffr=rrrrAs zPyCodecState.__init__cCs |j|j|j|j|j|jfSr9)rrrrr=rrrrhGs zPyCodecState.extentsN)rzr{r|rrhrrrrr@s rc@s\eZdZdZdZddZddZeddZd d Z d d Z d dZ dddZ dddZ dS) 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 Decoder in Python` FcGs(d|_t|_d|_||_||dSr9)rUrstatefdr1init)r5r1rjrrrrUs zPyDecoder.__init__cC ||_dS)z Override to perform decoder specific initialization :param args: Array of args items from the tile entry :returns: None N)rjrrrrr\ zPyDecoder.initcCs|jSr9) _pulls_fdr=rrrr^eszPyDecoder.pulls_fdcCst)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 <0 for the bytes consumed. Err codes are from :data:`.ImageFile.ERRORS`. r)r5rrrrr`is zPyDecoder.decodecCsdS)zV Override to perform decoder specific cleanup :returns: None Nrr=rrrrbtszPyDecoder.cleanupcCr)z Called from ImageFile to set the python file-like object :param fd: A python file-like object :returns: None N)r)r5rrrrr_|rzPyDecoder.setfdNcCs||_|r |\}}}}nd\}}}}|dkr%|dkr%|jj\|j_|j_n||j_||j_|||j_|||j_|jjdksE|jjdkrItd|jj|jj|jjdkse|jj|jj|jjdkritddS)z Called from ImageFile to set the core output image for the decoder :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)rUr2rrrrr ValueError)r5rUrhx0y0x1y1rrrr]s     zPyDecoder.setimagecCsd|s|j}t|jd|}||j|j||}|ddkr&td|ddkr0tddS)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 rArznot enough image datarzcannot decode image dataN) r1rr\r]rUrrhr`r)r5rrawmoderrprrr set_as_raws    zPyDecoder.set_as_rawr9)rzr{r|r}rrrpropertyr^r`rbr_r]rrrrrrKs   #r)r)rr/rKrr_utilrr$rrar rrrrrrrrrrrrrrs:     a B