PqhldZddlmZddlZddlZddlZddlmZmZddl m Z ddl m Z ddl mZmZmZmZGdd Zd ZGd d Zy) 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 lazypropertyc<eZdZdZdfd ZeddZedZedZ edZ e dZ edZ edd Zedd Zedd Zedd Zedd ZeddZ d ddZe dZe d ddZxZS)ImagezgGraphical image stream such as JPEG, PNG, or GIF with properties and methods required by ImagePart.cTtt| ||_||_||_yN)superr __init___blob _filename _image_header)selfblobfilename image_header __class__s Q/srv/www/ollama/chat-ollama/venv/lib/python3.12/site-packages/docx/image/image.pyrzImage.__init__s& eT#% !)cPtj|}|j||S)z`Return a new |Image| subclass instance parsed from the image binary contained in `blob`.)ioBytesIO _from_stream)clsrstreams r from_blobzImage.from_blobs%D!--rcbt|tr\|}t|d5}|j}t j |}dddt jj|}n%|}|jd|j}d}|j|S#1swYaxYw)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_filezImage.from_file%s & ,#DdD! *QvvxD) *ww''-H%F KKN;;=DHh77 * *s &B%%B.c|jS)zThe bytes of the image 'file'.)rrs rrz Image.blob6szzrc.|jjS)zIMIME content type for this image, e.g. ``'image/jpeg'`` for a JPEG image.)r content_typer1s rr3zImage.content_type;s!!...rc`tjj|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*splitextrr1s rextz Image.ext@s)ww/21266rc|jS)zpOriginal image file name, if loaded from disk, or a generic filename if loaded from an anonymous stream.)rr1s rrzImage.filenameJs~~rc.|jjSz,The horizontal pixel dimension of the image.)rpx_widthr1s rr;zImage.px_widthPs!!***rc.|jjSz*The vertical pixel dimension of the image.)r px_heightr1s rr>zImage.px_heightUs!!+++rc.|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_dpir1s rrAzImage.horz_dpiZ !!***rc.|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_dpir1s rrEzImage.vert_dpibrBrcFt|j|jz S)z}A |Length| value representing the native width of the image, calculated from the values of `px_width` and `horz_dpi`.)r r;rAr1s rwidthz Image.widthjsdmmdmm344rcFt|j|jz S)zA |Length| value representing the native height of the image, calculated from the values of `px_height` and `vert_dpi`.)r r>rEr1s rheightz Image.heightpsdnnt}}455rcZ|||j|jfS|=|Jt|t|jz }t|j|z}|9t|t|jz }t|j|z}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. )rGrIfloatroundr)rrGrIscaling_factors rscaled_dimensionszImage.scaled_dimensionsvs$ =V^::t{{* * =% %%"6]U4;;-??N$**~56E >"5\E$**,==N4;;78F5z3v;&&rc\tj|jjS)z#SHA1 hash digest of the image blob.)hashlibsha1r hexdigestr1s rrQz Image.sha1s ||DJJ'1133rcNt|}|d|jz}||||S)zhReturn an instance of the |Image| subclass corresponding to the format of the image in `stream`.zimage.%s)_ImageHeaderFactory default_ext)r r!rrrs rrzImage._from_streams3+62  !L$<$<rArErGrIrNrQr __classcell__)rs@rr r st* .. 88 //77 ++,,++++55 66 >B''0:' '@44 $ 1 1 1 1  1 1rr cddlm}d}||}|D]1\}}}|t|z}|||}||k(s |j|cSt)znReturn a |BaseImageHeader| subclass instance that knows how to parse the headers of the image in `stream`.r) SIGNATUREScF|jd|jdS)Nr )r,r()r!s rread_32z$_ImageHeaderFactory..read_32s A{{2r) docx.imagerclen from_streamr) r!rcrfheaderr offsetsignature_bytesend found_bytess rrTrTsg&V_F(2+$V_s?++VC( / )??6* * + ! rcveZdZdZdZedZedZedZedZ edZ edZ y ) rWz>Base class for image header subclasses like |Jpeg| and |Tiff|.c<||_||_||_||_yr) _px_width _px_height _horz_dpi _vert_dpi)rr;r>rArEs rrzBaseImageHeader.__init__s!#!!rcd}t|)zDAbstract property definition, must be implemented by all subclasses.zNcontent_type property must be implemented by all subclasses of BaseImageHeaderNotImplementedErrorrmsgs rr3zBaseImageHeader.content_types  "#&&rcd}t|)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 BaseImageHeaderrvrxs rrUzBaseImageHeader.default_exts  "#&&rc|jSr:)rqr1s rr;zBaseImageHeader.px_widths~~rc|jSr=)rrr1s rr>zBaseImageHeader.px_heightsrc|jSr@)rsr1s rrAzBaseImageHeader.horz_dpi ~~rc|jSrD)rtr1s rrEzBaseImageHeader.vert_dpir~rN) r[r\r]r^rr`r3rUr;r>rArErrrWrWsH" '' ' 'rrW)r^ __future__rrPrr)typingrrtyping_extensionsrdocx.image.exceptionsr docx.sharedrr r r r rTrWrrrrsC # "899S1S1l!$66r