o 'fl@sdZddlmZddlZddlZddlZddlmZmZddl m Z ddl m Z ddl mZmZmZmZGdd d Zd d ZGd d d ZdS)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)Self)UnrecognizedImageError)EmuInchesLength lazypropertycseZdZdZd4fdd Zed5d d ZeddZeddZ eddZ e ddZ eddZ ed6ddZed6ddZed6ddZed6dd Zed7d"d#Zed7d$d%Z &d8d9d+d,Ze d-d.Ze &d:d;d2d3ZZS)<ImagezgGraphical image stream such as JPEG, PNG, or GIF with properties and methods required by ImagePart.blobbytesfilenamestr image_headerBaseImageHeadercs$tt|||_||_||_dSN)superr __init___blob _filename _image_header)selfr rr __class__H/home/ubuntu/flask/venv/lib/python3.10/site-packages/docx/image/image.pyrs zImage.__init__returnrcCst|}|||S)z`Return a new |Image| subclass instance parsed from the image binary contained in `blob`.)ioBytesIO _from_stream)clsr streamrrr from_blobs  zImage.from_blobcCst|tr,|}t|d}|}t|}Wdn1s wYtj|}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) isinstanceropenreadrrospathbasenameseekr )r!image_descriptorr)fr r"rrrr from_file%s    zImage.from_filecC|jS)zThe bytes of the image 'file'.)rrrrrr 6z Image.blobcC|jjS)zIMIME content type for this image, e.g. ``'image/jpeg'`` for a JPEG image.)r content_typer0rrrr3;zImage.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)splitextrr0rrrext@sz Image.extcCr/)zpOriginal image file name, if loaded from disk, or a generic filename if loaded from an anonymous stream.)rr0rrrrJszImage.filenameintcCr2z,The horizontal pixel dimension of the image.)rpx_widthr0rrrr:Pr4zImage.px_widthcCr2z*The vertical pixel dimension of the image.)r px_heightr0rrrr<Ur4zImage.px_heightcCr2zInteger dots per inch for the width of this image. Defaults to 72 when not present in the file, as is often the case. )rhorz_dpir0rrrr>ZzImage.horz_dpicCr2zInteger dots per inch for the height of this image. Defaults to 72 when not present in the file, as is often the case. )rvert_dpir0rrrrAbr?zImage.vert_dpircCt|j|jS)z}A |Length| value representing the native width of the image, calculated from the values of `px_width` and `horz_dpi`.)rr:r>r0rrrwidthjz Image.widthcCrB)zA |Length| value representing the native height of the image, calculated from the values of `px_height` and `vert_dpi`.)rr<rAr0rrrheightprDz Image.heightNrC int | NonerETuple[Length, Length]cCs|dur|dur|j|jfS|dur(|dusJt|t|j}t|j|}|durrArCrErKrMr __classcell__rrrrr sD              r c Cs^ddlm}dd}||}|D]\}}}|t|}|||}||kr,||Sqt)znReturn a |BaseImageHeader| subclass instance that knows how to parse the headers of the image in `stream`.r) SIGNATUREScSs|d|dS)Nr )r+r')r"rrrread_32s  z$_ImageHeaderFactory..read_32) docx.imagerZlen from_streamr) r"rZr\headerr!offsetsignature_bytesend found_bytesrrrrQs   rQc@s`eZdZdZddZeddZeddZedd Zed d Z ed d Z eddZ dS)rz>Base class for image header subclasses like |Jpeg| and |Tiff|.cCs||_||_||_||_dSr) _px_width _px_height _horz_dpi _vert_dpi)rr:r<r>rArrrrs zBaseImageHeader.__init__cC d}t|)zDAbstract property definition, must be implemented by all subclasses.zNcontent_type property must be implemented by all subclasses of BaseImageHeaderNotImplementedErrorrmsgrrrr3szBaseImageHeader.content_typecCri)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 BaseImageHeaderrjrlrrrrRszBaseImageHeader.default_extcCr/r9)rer0rrrr:r1zBaseImageHeader.px_widthcCr/r;)rfr0rrrr<r1zBaseImageHeader.px_heightcCr/r=)rgr0rrrr>zBaseImageHeader.horz_dpicCr/r@)rhr0rrrrArnzBaseImageHeader.vert_dpiN) rSrTrUrVrrXr3rRr:r<r>rArrrrrs     r)rV __future__rrLrr(typingrrtyping_extensionsrdocx.image.exceptionsr docx.sharedrrr r r rQrrrrrs