o &T]@sdZddlmZmZmZddlZddlZddlmZm Z ddl m Z ddl m Z mZmZGd d d eZd d ZGd ddeZdS)z Provides objects that can characterize image streams as to content type and size, as a required step in including them in a document. )absolute_importdivisionprint_functionN)BytesIO is_string)UnrecognizedImageError)EmuInches lazypropertycseZdZdZfddZeddZeddZedd Z ed d Z e d d Z eddZ eddZeddZeddZeddZeddZeddZd#ddZe dd Zed$d!d"ZZS)%Imagezq Graphical image stream such as JPEG, PNG, or GIF with properties and methods required by ImagePart. cs$tt|||_||_||_dSN)superr __init___blob _filename _image_header)selfblobfilename image_header __class__@D:\Projects\ConvertPro\env\Lib\site-packages\docx\image\image.pyrs zImage.__init__cCst|}|||S)zr Return a new |Image| subclass instance parsed from the image binary contained in *blob*. )r _from_stream)clsrstreamrrr from_blobs zImage.from_blobcCs|t|r*|}t|d}|}t|}Wdn1swYtj|}n |}|d|}d}||||S)z Return a new |Image| subclass instance loaded from the image file identified by *image_descriptor*, a path or file-like object. rbNr) ropenreadrospathbasenameseekr)rZimage_descriptorr$frrrrrr from_file&s   zImage.from_filecC|jS)z/ The bytes of the image 'file' )rrrrrr9z Image.blobcC|jjS)zb MIME content type for this image, e.g. ``'image/jpeg'`` for a JPEG image )r content_typer*rrrr-@zImage.content_typecCstj|jdddS)a The 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'. rN)r#r$splitextrr*rrrextHsz Image.extcCr))z Original image file name, if loaded from disk, or a generic filename if loaded from an anonymous stream. )rr*rrrrRzImage.filenamecCr,z= The horizontal pixel dimension of the image )rpx_widthr*rrrr3ZzImage.px_widthcCr,z; The vertical pixel dimension of the image )r px_heightr*rrrr6ar4zImage.px_heightcCr,z Integer 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*rrrr8hr.zImage.horz_dpicCr,z Integer 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:pr.zImage.vert_dpicCt|j|jS)z A |Length| value representing the native width of the image, calculated from the values of `px_width` and `horz_dpi`. )r r3r8r*rrrwidthxz Image.widthcCr;)z A |Length| value representing the native height of the image, calculated from the values of `px_height` and `vert_dpi`. )r r6r:r*rrrheightr=z Image.heightNcCs||dur|dur|j|jfS|dur"t|t|j}t|j|}|dur6t|t|j}t|j|}t|t|fS)a Return a (cx, cy) 2-tuple representing the native dimensions of this image scaled by applying the following rules to *width* and *height*. 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>floatroundr )rr<r>Zscaling_factorrrrscaled_dimensionss zImage.scaled_dimensionscCst|jS)z4 SHA1 hash digest of the image blob )hashlibsha1r hexdigestr*rrrrCsz Image.sha1cCs&t|}|dur d|j}||||S)zz Return an instance of the |Image| subclass corresponding to the format of the image in *stream*. Nzimage.%s)_ImageHeaderFactory default_ext)rrrrrrrrrs  zImage._from_stream)NNr)__name__ __module__ __qualname____doc__r classmethodrr(propertyrr-r r0rr3r6r8r:r<r>rArCr __classcell__rrrrr s@               r c Cs^ddlm}dd}||}|D]\}}}|t|}|||}||kr,||Sqt)zx Return a |BaseImageHeader| subclass instance that knows how to parse the headers of the image in *stream*. r) SIGNATUREScSs|d|dS)Nr )r&r")rrrrread_32s  z$_ImageHeaderFactory..read_32)Z docx.imagerNlenZ from_streamr ) rrNrPheaderroffsetZsignature_bytesendZ found_bytesrrrrEs   rEc@s`eZdZdZddZeddZeddZedd Zed d Z ed d Z eddZ dS)BaseImageHeaderzH Base class for image header subclasses like |Jpeg| and |Tiff|. cCs||_||_||_||_dSr) _px_width _px_height _horz_dpi _vert_dpi)rr3r6r8r:rrrrs zBaseImageHeader.__init__cC d}t|)zV Abstract property definition, must be implemented by all subclasses. zNcontent_type property must be implemented by all subclasses of BaseImageHeaderNotImplementedErrorrmsgrrrr-szBaseImageHeader.content_typecCrZ)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 BaseImageHeaderr[r]rrrrFszBaseImageHeader.default_extcCr)r2)rVr*rrrr3r+zBaseImageHeader.px_widthcCr)r5)rWr*rrrr6r+zBaseImageHeader.px_heightcCr)r7)rXr*rrrr8r1zBaseImageHeader.horz_dpicCr)r9)rYr*rrrr:r1zBaseImageHeader.vert_dpiN) rGrHrIrJrrLr-rFr3r6r8r:rrrrrUs     rU)rJZ __future__rrrrBr#compatrr exceptionsr sharedr r r objectr rErUrrrrs %