*hESrSSKJr SSKrSSKrSSKrSSKJrJr SSK J r SSK J r J r JrJr "SS5rS S jr"S S 5rg) 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 lazypropertycf^\rSrSrSrSU4Sjjr\SSj5r\SSj5r\ S5r \ SSj5r \ S5r \ S 5r\ SS j5r\ SS j5r\ SS j5r\ SS j5r\ SSj5r\ SSj5rSSSjjr\ S5r\SSSjj5rSrU=r$)ImagezcGraphical image stream such as JPEG, PNG, or GIF with properties and methods required by ImagePart.cN>[[U] 5 XlX lX0lgN)superr __init___blob _filename _image_header)selfblobfilename image_header __class__s M/home/mande/repo/quber/.venv/lib/python3.13/site-packages/docx/image/image.pyrImage.__init__s  eT#% !)cP[R"U5nURX!5$)zXReturn a new |Image| subclass instance parsed from the image binary contained in `blob`.)ioBytesIO _from_stream)clsrstreams r from_blobImage.from_blobs#D!--rcx[U[5(a]Un[US5nUR5n[R "U5nSSS5 [ RRU5nO%UnURS5 UR5nSnURWWU5$!,(df  Nf=f)zReturn a new |Image| subclass instance loaded from the image file identified by `image_descriptor`, a path or file-like object.rbNr) isinstancestropenreadrrospathbasenameseekr )r!image_descriptorr,frr"rs r from_fileImage.from_file#s & , ,#DdD!QvvxD)"ww''-H%F KKN;;=DHh77"!s 'B++ B9cUR$)zThe bytes of the image 'file'.)rrs rr Image.blob4szzrc.URR$)zIMIME content type for this image, e.g. ``'image/jpeg'`` for a JPEG image.)r content_typer4s rr7Image.content_type9s!!...rc`[RRUR5SSS$)zThe 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,splitextrr4s rext Image.ext>s)ww/21266rcUR$)zhOriginal image file name, if loaded from disk, or a generic filename if loaded from an anonymous stream.)rr4s rrImage.filenameHs~~rc.URR$z,The horizontal pixel dimension of the image.)rpx_widthr4s rrBImage.px_widthNs!!***rc.URR$z*The vertical pixel dimension of the image.)r px_heightr4s rrFImage.px_heightSs!!+++rc.URR$zwInteger dots per inch for the width of this image. Defaults to 72 when not present in the file, as is often the case. )rhorz_dpir4s rrJImage.horz_dpiX !!***rc.URR$zxInteger dots per inch for the height of this image. Defaults to 72 when not present in the file, as is often the case. )rvert_dpir4s rrOImage.vert_dpi`rLrcF[URUR- 5$)zuA |Length| value representing the native width of the image, calculated from the values of `px_width` and `horz_dpi`.)rrBrJr4s rwidth Image.widthhsdmmdmm344rcF[URUR- 5$)zwA |Length| value representing the native height of the image, calculated from the values of `px_height` and `vert_dpi`.)rrFrOr4s rheight Image.heightnsdnnt}}455rcdUcUcURUR4$Uc>Uce[U5[UR5- n[URU-5nUc9[U5[UR5- n[URU-5n[ U5[ U54$)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. )rRrUfloatroundr)rrRrUscaling_factors rscaled_dimensionsImage.scaled_dimensionsts$ =V^::t{{* * =% %%"6]U4;;-??N$**~56E >"5\E$**,==N4;;78F5z3v;&&rc^[R"UR5R5$)z#SHA1 hash digest of the image blob.)hashlibsha1r hexdigestr4s rr_ Image.sha1s ||DJJ'1133rcN[U5nUcSUR-nU"X#U5$)z`Return an instance of the |Image| subclass corresponding to the format of the image in `stream`.zimage.%s)_ImageHeaderFactory default_ext)r!r"rrrs rr Image._from_streams1+62  !L$<$<.read_32s A{{2rr"rl) docx.imagerwlen from_streamr) r"rwrzheaderr!offsetsignature_bytesend found_bytess rrcrcsZ%V_F(2$_s?++C(  )??6* * )3 ! rc\rSrSrSrS Sjr\S Sj5r\S Sj5r\S5r \S5r \S5r \S 5r S r g )rgz>Base class for image header subclasses like |Jpeg| and |Tiff|.c4XlX lX0lX@lgr) _px_width _px_height _horz_dpi _vert_dpi)rrBrFrJrOs rrBaseImageHeader.__init__s!#!!rcSn[U5e)zDAbstract property definition, must be implemented by all subclasses.zNcontent_type property must be implemented by all subclasses of BaseImageHeaderNotImplementedError)rmsgs rr7BaseImageHeader.content_types_!#&&rc[S5e)z}Default 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 BaseImageHeaderrr4s rrdBaseImageHeader.default_exts " [  rcUR$rA)rr4s rrBBaseImageHeader.px_widths~~rcUR$rE)rr4s rrFBaseImageHeader.px_heightsrcUR$rI)rr4s rrJBaseImageHeader.horz_dpi ~~rcUR$rN)rr4s rrOBaseImageHeader.vert_dpirr)rrrrN)rBrjrFrjrJrjrOrjri)rmrnrorprqrrsr7rdrBrFrJrOrtrrrgrgsH" ''   rrgr|)rq __future__rr^rr+typingrrdocx.image.exceptionsr docx.sharedrrr r r rcrgrrrrs@ # 899S1S1l!"11r