o hE@sdZddlmZddlZddlZddlZddlmZmZddl m Z ddl m Z m Z mZmZGdddZdd 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 lazypropertycseZdZdZd5fdd Zed6d d Zed7ddZeddZ ed8ddZ e ddZ eddZ ed9ddZed9ddZed9ddZed9d d!Zed:d#d$Zed:d%d&Z 'd;dd3d4ZZS)?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 r r __class__P/var/www/html/premium_crap/venv/lib/python3.10/site-packages/docx/image/image.pyrs zImage.__init__returncCst|}|||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_blobimage_descriptorstr | IO[bytes]cCst|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 r#r*fr r!r rrr from_file#s    zImage.from_filecC|jS)zThe bytes of the image 'file'.)rrrrrr 4z Image.blobcC|jjS)zIMIME content type for this image, e.g. ``'image/jpeg'`` for a JPEG image.)r content_typer0rrrr39zImage.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.)rr0rrrr HszImage.filenameintcCr2z,The horizontal pixel dimension of the image.)rpx_widthr0rrrr:Nr4zImage.px_widthcCr2z*The vertical pixel dimension of the image.)r px_heightr0rrrr<Sr4zImage.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>XzImage.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_dpir0rrrrA`r?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>r0rrrwidthhz Image.widthcCrB)zA |Length| value representing the native height of the image, calculated from the values of `px_height` and `vert_dpi`.)rr<rAr0rrrheightnrDz Image.heightNrCint | Length | NonerETuple[Length, Length]cCs|dur|dur|j|jfS|dur(|dusJt|t|j}t|j|}|durrArCrErKrMr __classcell__rrrrr sD              r r!rOc Cs`ddlm}ddd}||}|D]\}}}|t|}|||}||kr-||Sqt) zRA |BaseImageHeader| subclass instance that can parse headers of image in `stream`.r) SIGNATURESr!rOcSs|d|dS)Nr )r,r()r!rrrread_32s  z$_ImageHeaderFactory..read_32Nr!rO) docx.imager[len from_streamr) r!r[r]headerr offsetsignature_bytesend found_bytesrrrrQs    rQc@sfeZdZdZdddZedd d Zedd dZeddZeddZ eddZ eddZ dS)rz>Base class for image header subclasses like |Jpeg| and |Tiff|.r:r8r<r>rAcCs||_||_||_||_dSr) _px_width _px_height _horz_dpi _vert_dpi)rr:r<r>rArrrrs zBaseImageHeader.__init__rrcCs d}t|)zDAbstract property definition, must be implemented by all subclasses.zNcontent_type property must be implemented by all subclasses of BaseImageHeaderNotImplementedError)rmsgrrrr3szBaseImageHeader.content_typecCstd)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 BaseImageHeaderrkr0rrrrRszBaseImageHeader.default_extcCr/r9)rgr0rrrr:r1zBaseImageHeader.px_widthcCr/r;)rhr0rrrr<r1zBaseImageHeader.px_heightcCr/r=)rir0rrrr>zBaseImageHeader.horz_dpicCr/r@)rjr0rrrrArnzBaseImageHeader.vert_dpiN)r:r8r<r8r>r8rAr8rS) rTrUrVrWrrYr3rRr:r<r>rArrrrrs      rr^)rW __future__rrLrr)typingrrdocx.image.exceptionsr docx.sharedrrrr r rQrrrrrs