a ]jE@sdZddlmZddlZddlZddlZddlmZmZddl m Z ddl m Z m Z mZmZGdddZd d d d ZGd ddZdS)zProvides objects that can characterize image streams. That characterization is as to content type and size, as a required step in including them in a document. ) annotationsN)IOTuple)UnrecognizedImageError)EmuInchesLength lazypropertycs,eZdZdZddddfdd Zedddd d Zed d d dZeddZ eddddZ e ddZ eddZ eddddZeddddZeddddZedddd Zed!dd"d#Zed!dd$d%Zd3d'd'd(d)d*d+Ze d,d-Zed4d.dd/dd0d1d2ZZS)5ImagezgGraphical image stream such as JPEG, PNG, or GIF with properties and methods required by ImagePart.bytesstrBaseImageHeader)blobfilename image_headercs$tt|||_||_||_dSN)superr __init___blob _filename _image_header)selfrrr __class__L/var/www/html/assistant/venv/lib/python3.9/site-packages/docx/image/image.pyrszImage.__init__)rreturncCst|}|||S)z`Return a new |Image| subclass instance parsed from the image binary contained in `blob`.)ioBytesIO _from_stream)clsrstreamrrr from_blobs zImage.from_blobzstr | IO[bytes])image_descriptorcCst|trX|}t|d"}|}t|}Wdn1s@0Ytj|}n|}| d|}d}| |||S)zReturn a new |Image| subclass instance loaded from the image file identified by `image_descriptor`, a path or file-like object.rbNr) isinstancer openreadrrospathbasenameseekr)r r#r)frr!rrrr from_file#s  ( zImage.from_filecCs|jS)zThe bytes of the image 'file'.)rrrrrr4sz Image.blobrcCs|jjS)zIMIME content type for this image, e.g. ``'image/jpeg'`` for a JPEG image.)r content_typer.rrrr09szImage.content_typecCstj|jdddS)aThe file extension for the image. If an actual one is available from a load filename it is used. Otherwise a canonical extension is assigned based on the content type. Does not contain the leading period, e.g. 'jpg', not '.jpg'. N)r(r)splitextrr.rrrext>sz Image.extcCs|jS)zpOriginal image file name, if loaded from disk, or a generic filename if loaded from an anonymous stream.)rr.rrrrHszImage.filenameintcCs|jjSz,The horizontal pixel dimension of the image.)rpx_widthr.rrrr6NszImage.px_widthcCs|jjSz*The vertical pixel dimension of the image.)r px_heightr.rrrr8SszImage.px_heightcCs|jjSzInteger dots per inch for the width of this image. Defaults to 72 when not present in the file, as is often the case. )rhorz_dpir.rrrr:XszImage.horz_dpicCs|jjSzInteger dots per inch for the height of this image. Defaults to 72 when not present in the file, as is often the case. )rvert_dpir.rrrr<`szImage.vert_dpircCst|j|jS)z}A |Length| value representing the native width of the image, calculated from the values of `px_width` and `horz_dpi`.)rr6r:r.rrrwidthhsz Image.widthcCst|j|jS)zA |Length| value representing the native height of the image, calculated from the values of `px_height` and `vert_dpi`.)rr8r<r.rrrheightnsz Image.heightNzint | Length | NonezTuple[Length, Length])r=r>rcCs|dur|dur|j|jfS|durP|dus0Jt|t|j}t|j|}|durxt|t|j}t|j|}t|t|fS)a?(cx, cy) pair representing scaled dimensions of this image. The native dimensions of the image are scaled by applying the following rules to the `width` and `height` arguments. * If both `width` and `height` are specified, the return value is (`width`, `height`); no scaling is performed. * If only one is specified, it is used to compute a scaling factor that is then applied to the unspecified dimension, preserving the aspect ratio of the image. * If both `width` and `height` are |None|, the native dimensions are returned. The native dimensions are calculated using the dots-per-inch (dpi) value embedded in the image, defaulting to 72 dpi if no value is specified, as is often the case. The returned values are both |Length| objects. N)r=r>floatroundr)rr=r>Zscaling_factorrrrscaled_dimensionsts  zImage.scaled_dimensionscCst|jS)z#SHA1 hash digest of the image blob.)hashlibsha1r hexdigestr.rrrrCsz Image.sha1 IO[bytes]z str | None)r!rrrcCs&t|}|durd|j}||||S)zhReturn an instance of the |Image| subclass corresponding to the format of the image in `stream`.Nzimage.%s)_ImageHeaderFactory default_ext)r r!rrrrrrrs  zImage._from_stream)NN)N)__name__ __module__ __qualname____doc__r classmethodr"r-propertyrr0r r3rr6r8r:r<r=r>rArCr __classcell__rrrrr sB     r rEr!c Cshddlm}dddd}||}|D]8\}}}|t|}|||}||kr&||Sq&tdS)zRA |BaseImageHeader| subclass instance that can parse headers of image in `stream`.r) SIGNATURESrErOcSs|d|dS)Nr )r+r'rOrrrread_32s z$_ImageHeaderFactory..read_32N)Z docx.imagerPlen from_streamr) r!rPrRheaderr offsetZsignature_bytesendZ found_bytesrrrrFs   rFc@sxeZdZdZdddddddZedddd Zeddd d Zed d ZeddZ eddZ eddZ dS)r z>Base class for image header subclasses like |Jpeg| and |Tiff|.r4)r6r8r:r<cCs||_||_||_||_dSr) _px_width _px_height _horz_dpi _vert_dpi)rr6r8r:r<rrrrszBaseImageHeader.__init__r r/cCsd}t|dS)zDAbstract property definition, must be implemented by all subclasses.zNcontent_type property must be implemented by all subclasses of BaseImageHeaderNNotImplementedError)rmsgrrrr0szBaseImageHeader.content_typecCs tddS)zDefault filename extension for images of this type. An abstract property definition, must be implemented by all subclasses. zMdefault_ext property must be implemented by all subclasses of BaseImageHeaderNr\r.rrrrGszBaseImageHeader.default_extcCs|jSr5)rXr.rrrr6szBaseImageHeader.px_widthcCs|jSr7)rYr.rrrr8szBaseImageHeader.px_heightcCs|jSr9)rZr.rrrr:szBaseImageHeader.horz_dpicCs|jSr;)r[r.rrrr<szBaseImageHeader.vert_dpiN) rHrIrJrKrrMr0rGr6r8r:r<rrrrr s    r )rK __future__rrBrr(typingrrZdocx.image.exceptionsrZ docx.sharedrrrr r rFr rrrrs