B W_>@sdZddlmZmZmZddlmZddlmZm Z ddl m Z m Z ddl mZdd lmZGd d d eZGd d d eZGdddeZGdddeZGdddeZGdddeZddZGdddeZGdddeZGdddeZGdddeZd S)!z[ Objects related to parsing headers of JPEG image streams, both JFIF and Exif sub-formats. )absolute_importdivisionprint_function)BytesIO)JPEG_MARKER_CODE MIME_TYPE) BIG_ENDIAN StreamReader)BaseImageHeader)Tiffc@s(eZdZdZeddZeddZdS)Jpegz2 Base class for JFIF and EXIF subclasses. cCstjS)zi MIME content type for this image, unconditionally `image/jpeg` for JPEG images. )r ZJPEG)selfrA/var/www/html/venv/lib/python3.7/site-packages/docx/image/jpeg.py content_typeszJpeg.content_typecCsdS)zJ Default filename extension, always 'jpg' for JPG images. Zjpgr)rrrr default_extszJpeg.default_extN)__name__ __module__ __qualname____doc__propertyrrrrrrrs rc@seZdZdZeddZdS)Exifz3 Image header parser for Exif image format cCs8t|}|jj}|jj}|jj}|jj}|||||S)zm Return |Exif| instance having header properties parsed from Exif image in *stream*. ) _JfifMarkers from_streamsofpx_width px_heightapp1horz_dpivert_dpi)clsstreammarkersrrr r!rrrr)s  zExif.from_streamN)rrrr classmethodrrrrrr%src@seZdZdZeddZdS)Jfifz3 Image header parser for JFIF image format cCs8t|}|jj}|jj}|jj}|jj}|||||S)zj Return a |Jfif| instance having header properties parsed from image in *stream*. )rrrrrapp0r r!)r"r#r$rrr r!rrrr>s  zJfif.from_streamN)rrrrr%rrrrrr&:sr&csXeZdZdZfddZddZeddZedd Z ed d Z ed d Z Z S)rzp Sequence of markers in a JPEG file, perhaps truncated at first SOS marker for performance reasons. cstt|t||_dS)N)superr__init__list_markers)rr$) __class__rrr)Ssz_JfifMarkers.__init__cCsRd}d}g}x0|jD]&}|||j|jt|j|jfqW|g|}d|S)z Returns a tabular listing of the markers in this instance, which can be handy for debugging and perhaps other uses. z4 offset seglen mc name ======= ====== == =====z%7d %6d %02X %s )r+appendoffsetsegment_lengthord marker_codenamejoin)rheadertmplZrowsmarkerlinesrrr__str__Ws  z_JfifMarkers.__str__cCs@t|}g}x(|D]}|||jtjkrPqW||S)z Return a |_JfifMarkers| instance containing a |_JfifMarker| subclass instance for each marker in *stream*. ) _MarkerParserr iter_markersr.r2rZSOS)r"r#Z marker_parserr$r7rrrrgs   z_JfifMarkers.from_streamcCs,x|jD]}|jtjkr|SqWtddS)z5 First APP0 marker in image markers. zno APP0 marker in imageN)r+r2rAPP0KeyError)rmrrrr'us  z_JfifMarkers.app0cCs,x|jD]}|jtjkr|SqWtddS)z5 First APP1 marker in image markers. zno APP1 marker in imageN)r+r2rAPP1r=)rr>rrrrs  z_JfifMarkers.app1cCs,x|jD]}|jtjkr|SqWtddS)zF First start of frame (SOFn) marker in this sequence. z(no start of frame (SOFn) marker in imageN)r+r2rSOF_MARKER_CODESr=)rr>rrrrs  z_JfifMarkers.sof) rrrrr)r9r%rrr'rr __classcell__rr)r,rrNs   rcs4eZdZdZfddZeddZddZZS)r:z_ Service class that knows how to parse a JFIF stream and iterate over its markers. cstt|||_dS)N)r(r:r)_stream)r stream_reader)r,rrr)sz_MarkerParser.__init__cCst|t}||S)z` Return a |_MarkerParser| instance to parse JFIF markers from *stream*. )r r )r"r#rCrrrrs z_MarkerParser.from_streamccsTt|j}d}d}x:|tjkrN||\}}t||j|}|V||j}qWdS)z Generate a (marker_code, segment_offset) 2-tuple for each marker in the JPEG *stream*, in the order they occur in the stream. rN) _MarkerFinderrrBrZEOInext_MarkerFactoryr0)rZ marker_finderstartr2segment_offsetr7rrrr;s   z_MarkerParser.iter_markers) rrrrr)r%rr;rArr)r,rr:s  r:csLeZdZdZfddZeddZddZdd Zd d Z d d Z Z S)rDzP Service class that knows how to find the next JFIF marker in a stream. cstt|||_dS)N)r(rDr)rB)rr#)r,rrr)sz_MarkerFinder.__init__cCs||S)zU Return a |_MarkerFinder| instance to find JFIF markers in *stream*. r)r"r#rrrrsz_MarkerFinder.from_streamcCsL|}x>|j|d}|j|dd\}}|dkr0q||d}}PqW||fS)a` Return a (marker_code, segment_offset) 2-tuple identifying and locating the first marker in *stream* occuring after offset *start*. The returned *segment_offset* points to the position immediately following the 2-byte marker code, the start of the marker segment, for those markers that have a segment. )rGr)_offset_of_next_ff_byte_next_non_ff_byte)rrGpositionbyte_r2rHrrrrEs z_MarkerFinder.nextcCs@|j||}x|dkr(|}qW|jd}||fS)u Return an offset, byte 2-tuple for the next byte in *stream* that is not 'ÿ', starting with the byte at offset *start*. If the byte at offset *start* is not 'ÿ', *start* and the returned *offset* will be the same. r)rBseek _read_bytetell)rrGrMZoffset_of_non_ff_byterrrrKs    z_MarkerFinder._next_non_ff_bytecCs<|j||}x|dkr(|}qW|jd}|S)u Return the offset of the next 'ÿ' byte in *stream* starting with the byte at offset *start*. Returns *start* if the byte at that offset is a hex 255; it does not necessarily advance in the stream. rNr)rBrOrPrQ)rrGrMZoffset_of_ff_byterrrrJs    z%_MarkerFinder._offset_of_next_ff_bytecCs|jd}|std|S)zm Return the next byte read from stream. Raise Exception if stream is at end of file. rzunexpected end of file)rBread Exception)rrMrrrrPs z_MarkerFinder._read_byte) rrrrr)r%rrErKrJrPrArr)r,rrDs   rDcCsB|tjkrt}n$|tjkr t}n|tjkr0t}nt}||||S)zx Return |_Marker| or subclass instance appropriate for marker at *offset* in *stream* having *marker_code*. ) rr< _App0Markerr? _App1Markerr@ _SofMarker_Markerr)r2r#r/Z marker_clsrrrrFs   rFcs\eZdZdZfddZeddZeddZedd Z ed d Z ed d Z Z S)rWzu Base class for JFIF marker classes. Represents a marker and its segment occuring in a JPEG byte stream. cs$tt|||_||_||_dS)N)r(rWr) _marker_code_offset_segment_length)rr2r/r0)r,rrr)sz_Marker.__init__cCs&t|rd}n ||}||||S)zz Return a generic |_Marker| instance for the marker at *offset* in *stream* having *marker_code*. r)rZ is_standalone read_short)r"r#r2r/r0rrrrs  z_Marker.from_streamcCs|jS)u The single-byte code that identifies the type of this marker, e.g. ``'à'`` for start of image (SOI). )rX)rrrrr2)sz_Marker.marker_codecCs tj|jS)N)rZ marker_namesrX)rrrrr31sz _Marker.namecCs|jS)N)rY)rrrrr/5sz_Marker.offsetcCs|jS)z> The length in bytes of this marker's segment )rZ)rrrrr09sz_Marker.segment_length) rrrrr)r%rrr2r3r/r0rArr)r,rrWs    rWcsLeZdZdZfddZeddZeddZdd Ze d d Z Z S) rTz0 Represents a JFIF APP0 marker segment. cs*tt||||||_||_||_dS)N)r(rTr)_density_units _x_density _y_density)rr2r/length density_units x_density y_density)r,rrr)Esz_App0Marker.__init__cCs ||jS)zm Horizontal dots per inch specified in this marker, defaults to 72 if not specified. )_dpir])rrrrr Msz_App0Marker.horz_dpicCs ||jS)zk Vertical dots per inch specified in this marker, defaults to 72 if not specified. )rcr^)rrrrr!Usz_App0Marker.vert_dpicCs4|jdkr|}n |jdkr,tt|d}nd}|S)zH Return dots per inch corresponding to *density* value. rrgRQ@H)r\intround)rZdensityZdpirrrrc]s   z_App0Marker._dpicCs@||}||d}||d}||d}|||||||S)zg Return an |_App0Marker| instance for the APP0 marker at *offset* in *stream*. )r[Z read_byte)r"r#r2r/r0r`rarbrrrris     z_App0Marker.from_stream) rrrrr)rr r!rcr%rrArr)r,rrTAs     rTcs\eZdZdZfddZeddZeddZedd Z ed d Z ed d Z Z S)rUz7 Represents a JFIF APP1 (Exif) marker segment. cs$tt||||||_||_dS)N)r(rUr) _horz_dpi _vert_dpi)rr2r/r_r r!)r,rrr)sz_App1Marker.__init__cCsH||}|||r&||||ddS||||}|||||j|jS)z Extract the horizontal and vertical dots-per-inch value from the APP1 header at *offset* in *stream*. rd)r[_is_non_Exif_APP1_segment_tiff_from_exif_segmentr r!)r"r#r2r/r0tiffrrrrs   z_App1Marker.from_streamcCs|jS)zm Horizontal dots per inch specified in this marker, defaults to 72 if not specified. )rj)rrrrr sz_App1Marker.horz_dpicCs|jS)zk Vertical dots per inch specified in this marker, defaults to 72 if not specified. )rk)rrrrr!sz_App1Marker.vert_dpicCs ||d|d}|dkS)z Return True if the APP1 segment at *offset* in *stream* is NOT an Exif segment, as determined by the ``'Exif'`` signature at offset 2 in the segment. rsExif)rOrR)r"r#r/Zexif_signaturerrrrls z%_App1Marker._is_non_Exif_APP1_segmentcCs.||d||d}t|}t|S)z Return a |Tiff| instance parsed from the Exif APP1 segment of *segment_length* at *offset* in *stream*. )rOrRrr r)r"r#r/r0Z segment_bytesZ substreamrrrrmsz#_App1Marker._tiff_from_exif_segment) rrrrr)r%rrr r!rlrmrArr)r,rrUs     rUcsDeZdZdZfddZeddZeddZedd Z Z S) rVzA Represents a JFIF start of frame (SOFx) marker segment. cs$tt||||||_||_dS)N)r(rVr) _px_width _px_height)rr2r/r0rr)r,rrr)sz_SofMarker.__init__cCs2||}||d}||d}||||||S)zd Return an |_SofMarker| instance for the SOFn marker at *offset* in stream. )r[)r"r#r2r/r0rrrrrrs   z_SofMarker.from_streamcCs|jS)z( Image height in pixels )rr)rrrrrsz_SofMarker.px_heightcCs|jS)z' Image width in pixels )rq)rrrrrsz_SofMarker.px_width) rrrrr)r%rrrrrArr)r,rrVs    rVN)r __future__rrrcompatr constantsrr Zhelpersr r imager rnr rrr&objectrr:rDrFrWrTrUrVrrrrs"   F#K/BG