+ iERt^RIHt^RIt^RIt^RIt^RIHtHt^RI H t ^RI H t H t HtHt!RR4tRR lt!R R 4tR#) 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 lazypropertycba]tRt^tRtRV3Rllt]RRl4t]RRl4t] R4t ] R R l4t ] R 4t ] R 4t] R Rl4t] RRl4t] RRl4t] RRl4t] RRl4t] RRl4tRRRllt] R4t]R RRll4tRtV;t#)!ImagezcGraphical image stream such as JPEG, PNG, or GIF with properties and methods required by ImagePart.c$V^8dQhRRRRRR/#)blobbytesfilenamestr image_headerBaseImageHeader)formats"W/Users/agent/.openclaw/workspace/.venv/lib/python3.14/site-packages/docx/image/image.py __annotate__Image.__annotate__s!**U*c**c P<\\V` 4WnW nW0nR#N)superr __init___blob _filename _image_header)selfrrr __class__s&&&&rrImage.__init__s  eT#% !)rc V^8dQhRRRR/#)r rrreturnr r)rs"rrrs..U.u.rc P\P!V4pVPW!4#)zXReturn a new |Image| subclass instance parsed from the image binary contained in `blob`.)ioBytesIO _from_stream)clsrstreams&& r from_blobImage.from_blobs#D!--rcV^8dQhRR/#)r image_descriptorzstr | IO[bytes]r)rs"rrr$s888rc \V\4'dfTp\VR4;_uu_4pVP4p\P !V4pRRR4\ PPV4pM%TpVP^4VP4pRpVPXXV4# +'giLh;i)zReturn a new |Image| subclass instance loaded from the image file identified by `image_descriptor`, a path or file-like object.rbN) isinstanceropenreadr'r(ospathbasenameseekr))r*r/r6frr+rs&& r from_fileImage.from_file#s & , ,#DdD!!QvvxD)"ww''-H%F KKN;;=DHh77"!s 'B44 C c VP#)zThe bytes of the image 'file'.)rr!s&rr Image.blob4szzrcV^8dQhRR/#r r%rr)rs"rrr:s//c/rc .VPP#)zIMIME content type for this image, e.g. ``'image/jpeg'`` for a JPEG image.)r content_typer=s&rrBImage.content_type9s!!...rc p\PPVP4^,R,#)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'. :NN)r5r6splitextrr=s&rext Image.ext>s'ww/2266rc VP#)zhOriginal image file name, if loaded from disk, or a generic filename if loaded from an anonymous stream.)rr=s&rrImage.filenameHs~~rcV^8dQhRR/#r r%intr)rs"rrrOs++#+rc .VPP#z,The horizontal pixel dimension of the image.)r px_widthr=s&rrPImage.px_widthNs!!***rcV^8dQhRR/#rLr)rs"rrrTs,,3,rc .VPP#z*The vertical pixel dimension of the image.)r px_heightr=s&rrUImage.px_heightSs!!+++rcV^8dQhRR/#rLr)rs"rrrY++#+rc .VPP#zwInteger dots per inch for the width of this image. Defaults to 72 when not present in the file, as is often the case. )r horz_dpir=s&rr[Image.horz_dpiX !!***rcV^8dQhRR/#rLr)rs"rrrarXrc .VPP#zxInteger dots per inch for the height of this image. Defaults to 72 when not present in the file, as is often the case. )r vert_dpir=s&rraImage.vert_dpi`r]rcV^8dQhRR/#r r%rr)rs"rrris55v5rc N\VPVP, 4#)zuA |Length| value representing the native width of the image, calculated from the values of `px_width` and `horz_dpi`.)rrPr[r=s&rwidth Image.widthhsdmmdmm344rcV^8dQhRR/#rdr)rs"rrros666rc N\VPVP, 4#)zwA |Length| value representing the native height of the image, calculated from the values of `px_height` and `vert_dpi`.)rrUrar=s&rheight Image.heightnsdnnt}}455rc$V^8dQhRRRRRR/#)r rfzint | Length | Nonerjr%zTuple[Length, Length]r)rs"rrrts$''('9L' 'rc VfVfVPVP3#VfHVfQh\V4\VP4, p\VPV,4pVfB\V4\VP4, p\VPV,4p\ V4\ V43#)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. )rfrjfloatroundr)r!rfrjscaling_factors&&& rscaled_dimensionsImage.scaled_dimensionsts$ =V^::t{{* * =% %%"6]U4;;-??N$**~56E >"5\E$**,==N4;;78F5z3v;&&rc ^\P!VP4P4#)z#SHA1 hash digest of the image blob.)hashlibsha1r hexdigestr=s&rru Image.sha1s ||DJJ'1133rc(V^8dQhRRRRRRRR/#) r r+ IO[bytes]rrrz str | Noner%r r)rs"rrrs2 1 1 1 1 1  1rc X\V4pVfRVP,pV!W#V4#)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$<$<.__annotate__s rcFVP^4VP^ 4#))r8r4)r+s&rread_32$_ImageHeaderFactory..read_32s A{{2r) docx.imagerlen from_streamr) r+rrheaderr*offsetsignature_bytesend found_bytess & rr{r{sZ%V_F(2$_s?++C(  )??6* * )3 ! rc]tRt^tRtRRlt]RRl4t]RRl4t]R4t ]R 4t ]R 4t ]R 4t R t R #)rz>Base class for image header subclasses like |Jpeg| and |Tiff|.c(V^8dQhRRRRRRRR/#)r rPrMrUr[rar)rs"rrBaseImageHeader.__annotate__s("""""s"rc 6WnW nW0nW@nR#r) _px_width _px_height _horz_dpi _vert_dpi)r!rPrUr[ras&&&&&rrBaseImageHeader.__init__s!#!!rcV^8dQhRR/#r@r)rs"rrrs''c'rc Rp\V4h)zDAbstract property definition, must be implemented by all subclasses.zNcontent_type property must be implemented by all subclasses of BaseImageHeaderNotImplementedError)r!msgs& rrBBaseImageHeader.content_types_!#&&rcV^8dQhRR/#r@r)rs"rrrs  S rc \R4h)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 BaseImageHeaderrr=s&rr|BaseImageHeader.default_exts " [  rc VP#rO)rr=s&rrPBaseImageHeader.px_widths~~rc VP#rT)rr=s&rrUBaseImageHeader.px_heightsrc VP#rZ)rr=s&rr[BaseImageHeader.horz_dpi ~~rc VP#r`)rr=s&rraBaseImageHeader.vert_dpirr)rrrrN)r~rrrrrrrBr|rPrUr[rarrrrrrsH" ''   rr)r __future__rrtr'r5typingrrdocx.image.exceptionsr docx.sharedrrrr r r{rrrrrs@ # 899S1S1l!"11r