U cqel@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 lazypropertycs eZdZdZddddfdd Zeddd d d Zed d ZeddZ eddZ e ddZ eddZ eddddZeddddZeddddZeddddZed dd!d"Zed dd#d$Zd2d&d&d'd(d)d*Ze d+d,Zed3d-dd.dd/d0d1ZZS)4ImagezgGraphical image stream such as JPEG, PNG, or GIF with properties and methods required by ImagePart.bytesstrBaseImageHeader)blobfilename image_headercs$tt|||_||_||_dSN)superr __init___blob _filename _image_header)selfrrr __class__4/tmp/pip-unpacked-wheel-gx5hpqp3/docx/image/image.pyrszImage.__init__r)rreturncCst|}|||S)z`Return a new |Image| subclass instance parsed from the image binary contained in `blob`.)ioBytesIO _from_stream)clsrstreamrrr from_blobs zImage.from_blobc Cslt|trD|}t|d}|}t|}W5QRXtj|}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.rbrN) isinstancer openreadrrospathbasenameseekr )r!Zimage_descriptorr)frr"rrrr from_file%s   zImage.from_filecCs|jS)zThe bytes of the image 'file'.)rrrrrr6sz Image.blobcCs|jjS)zIMIME content type for this image, e.g. ``'image/jpeg'`` for a JPEG image.)r content_typer.rrrr/;szImage.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)splitextrr.rrrext@sz Image.extcCs|jS)zpOriginal image file name, if loaded from disk, or a generic filename if loaded from an anonymous stream.)rr.rrrrJszImage.filenameint)rcCs|jjSz,The horizontal pixel dimension of the image.)rpx_widthr.rrrr5PszImage.px_widthcCs|jjSz*The vertical pixel dimension of the image.)r px_heightr.rrrr7UszImage.px_heightcCs|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_dpir.rrrr9ZszImage.horz_dpicCs|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_dpir.rrrr;bszImage.vert_dpircCst|j|jS)z}A |Length| value representing the native width of the image, calculated from the values of `px_width` and `horz_dpi`.)rr5r9r.rrrwidthjsz Image.widthcCst|j|jS)zA |Length| value representing the native height of the image, calculated from the values of `px_height` and `vert_dpi`.)rr7r;r.rrrheightpsz Image.heightNz int | NonezTuple[Length, Length])r<r=rcCs|dkr|dkr|j|jfS|dkrP|dk s0tt|t|j}t|j|}|dkrxt|t|j}t|j|}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. N)r<r=AssertionErrorfloatroundr)rr<r=Zscaling_factorrrrscaled_dimensionsvs  zImage.scaled_dimensionscCst|jS)z#SHA1 hash digest of the image blob.)hashlibsha1r hexdigestr.rrrrCsz Image.sha1z IO[bytes]z str | None)r"rrrcCs&t|}|dkrd|j}||||S)zhReturn an instance of the |Image| subclass corresponding to the format of the image in `stream`.Nzimage.%s)_ImageHeaderFactory default_ext)r!r"rrrrrrr s  zImage._from_stream)NN)N)__name__ __module__ __qualname____doc__r classmethodr#r-propertyrr/r r2rr5r7r9r;r<r=rArCr __classcell__rrrrr sD       r c Csbddlm}dd}||}|D]8\}}}|t|}|||}||kr ||Sq tdS)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_32N)Z docx.imagerNlen from_streamr) r"rNrPheaderr!offsetZsignature_bytesendZ found_bytesrrrrEs   rEc@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)rr5r7r9r;rrrrszBaseImageHeader.__init__cCsd}t|dS)zDAbstract property definition, must be implemented by all subclasses.zNcontent_type property must be implemented by all subclasses of BaseImageHeaderNNotImplementedErrorrmsgrrrr/szBaseImageHeader.content_typecCsd}t|dS)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 BaseImageHeaderNrZr\rrrrFszBaseImageHeader.default_extcCs|jSr4)rVr.rrrr5szBaseImageHeader.px_widthcCs|jSr6)rWr.rrrr7szBaseImageHeader.px_heightcCs|jSr8)rXr.rrrr9szBaseImageHeader.horz_dpicCs|jSr:)rYr.rrrr;szBaseImageHeader.vert_dpiN) rGrHrIrJrrLr/rFr5r7r9r;rrrrrs     r)rJ __future__rrBrr(typingrrZtyping_extensionsrZdocx.image.exceptionsrZ docx.sharedrrr r r rErrrrrs