B &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|||_||_||_dS)N)superr __init___blob _filename _image_header)selfblobfilename image_header) __class__B/var/www/html/venv/lib/python3.7/site-packages/docx/image/image.pyrszImage.__init__cCst|}|||S)zr Return a new |Image| subclass instance parsed from the image binary contained in *blob*. )r _from_stream)clsrstreamrrr from_blobszImage.from_blobc Csht|r@|}t|d}|}t|}WdQRXtj|}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_filecCs|jS)z/ The bytes of the image 'file' )r)rrrrr9sz Image.blobcCs|jjS)zb MIME content type for this image, e.g. ``'image/jpeg'`` for a JPEG image )r content_type)rrrrr'@szImage.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"splitextr)rrrrextHsz Image.extcCs|jS)z Original image file name, if loaded from disk, or a generic filename if loaded from an anonymous stream. )r)rrrrrRszImage.filenamecCs|jjS)z= The horizontal pixel dimension of the image )rpx_width)rrrrr*ZszImage.px_widthcCs|jjS)z; The vertical pixel dimension of the image )r px_height)rrrrr+aszImage.px_heightcCs|jjS)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_dpi)rrrrr,hszImage.horz_dpicCs|jjS)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_dpi)rrrrr-pszImage.vert_dpicCst|j|jS)z A |Length| value representing the native width of the image, calculated from the values of `px_width` and `horz_dpi`. )r r*r,)rrrrwidthxsz Image.widthcCst|j|jS)z A |Length| value representing the native height of the image, calculated from the values of `px_height` and `vert_dpi`. )r r+r-)rrrrheightsz Image.heightNcCs||dkr|dkr|j|jfS|dkrDt|t|j}t|j|}|dkrlt|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 hexdigest)rrrrr4sz Image.sha1cCs&t|}|dkrd|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)NN)N)__name__ __module__ __qualname____doc__r classmethodrr&propertyrr'r r)rr*r+r,r-r.r/r2r4r __classcell__rr)rrr s$             r c Csbddlm}dd}||}x<|D]4\}}}|t|}|||}||kr"||Sq"WtdS)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_32N)Z docx.imager?lenZ from_streamr ) rr?rAheaderroffsetZsignature_bytesendZ found_bytesrrrr6s   r6c@s`eZdZdZddZeddZeddZedd Zed d Z ed d Z eddZ dS)BaseImageHeaderzH Base class for image header subclasses like |Jpeg| and |Tiff|. cCs||_||_||_||_dS)N) _px_width _px_height _horz_dpi _vert_dpi)rr*r+r,r-rrrrszBaseImageHeader.__init__cCsd}t|dS)zV Abstract property definition, must be implemented by all subclasses. zNcontent_type property must be implemented by all subclasses of BaseImageHeaderN)NotImplementedError)rmsgrrrr'szBaseImageHeader.content_typecCsd}t|dS)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 BaseImageHeaderN)rK)rrLrrrr7szBaseImageHeader.default_extcCs|jS)z= The horizontal pixel dimension of the image )rG)rrrrr*szBaseImageHeader.px_widthcCs|jS)z; The vertical pixel dimension of the image )rH)rrrrr+szBaseImageHeader.px_heightcCs|jS)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. )rI)rrrrr,szBaseImageHeader.horz_dpicCs|jS)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. )rJ)rrrrr-szBaseImageHeader.vert_dpiN) r8r9r:r;rr=r'r7r*r+r,r-rrrrrFs   rF)r; __future__rrrr3r!compatrr exceptionsr sharedr r r objectr r6rFrrrrs %