o 7h%@sdZddlmZddlZddlZddlZddlmZmZm Z m Z ddl m Z ddlmZddlmZddlmZmZerNdd lmZdd lmZdd lmZGd d d eZGdddeZ dS)zImagePart and related objects.) annotationsN)IO TYPE_CHECKINGAnycast)Image)Part)image_content_types)Emu lazyproperty)PackURI)Package)LengthcseZdZdZ d)d*fd d Zed+ddZed,ddZed,ddZ ed-ddZ d.ddZ e d,d d!Z ed/d"d#Zed0d%d&Zed/d'd(ZZS)1 ImagePartzrAn image part. An image part generally has a partname matching the regex `ppt/media/image[1-9][0-9]*.*`. Npartnamer content_typestrpackager blobbytesfilename str | Nonecs&tt|||||||_||_dSN)superr__init___blob _filename)selfrrrrr __class__X/var/www/html/figdemos/bartoux_crm/venv/lib/python3.10/site-packages/pptx/parts/image.pyrs zImagePart.__init__imagerreturncCs|||j|j||j|jS)zcReturn new |ImagePart| instance containing `image`. `image` is an |Image| object. )next_image_partnameextrrr)clsrr"r r r!new(s z ImagePart.newcCs|jdur d|jS|jS)aVThe filename associated with this image. Either the filename of the original image or a generic name of the form `image.ext` where `ext` is appropriate to the image file format, e.g. `'jpg'`. An image created using a path will have that filename; one created with a file-like object will have a generic name. Nzimage.)rr%rr r r!desc6s zImagePart.desccCs|jjS)z0File-name extension for this image e.g. `'png'`.)rr%r(r r r!r%Csz ImagePart.extcCst|j|jS)zAn |Image| object containing the image in this image part. Note this is a `pptx.image.Image` object, not a PIL Image. )rrr)r(r r r!r"HszImagePart.image scaled_cx int | None scaled_cytuple[int, int]cCs|j\}}|r |r ||fS|r%|s%t|t|}tt||}||fS|s=|r=t|t|}tt||}||fS||fS)aReturn scaled image dimensions in EMU based on the combination of parameters supplied. If `scaled_cx` and `scaled_cy` are both |None|, the native image size is returned. If neither `scaled_cx` nor `scaled_cy` is |None|, their values are returned unchanged. If a value is provided for either `scaled_cx` or `scaled_cy` and the other is |None|, the missing value is calculated such that the image's aspect ratio is preserved. ) _native_sizefloatintround)rr*r,Zimage_cxZimage_cyZscaling_factorr r r!scalePs zImagePart.scalecCt|jS)zThe 40-character SHA1 hash digest for the image binary of this image part. like: `"1be010ea47803b00e140b852765cdf84f491da47"`. hashlibsha1r hexdigestr(r r r!r6jszImagePart.sha1cCt|j}|jS)zR(horz_dpi, vert_dpi) pair representing the dots-per-inch resolution of this image.)r from_blobrdpirr"r r r!_dpir zImagePart._dpituple[Length, Length]cCsHd}|j\}}|j\}}|||}|||}tt|tt|fS)zA (width, height) 2-tuple representing the native dimensions of the image in EMU. Calculated based on the image DPI value, if present, assuming 72 dpi as a default. i )r<_px_sizer r0)rZ EMU_PER_INCHZhorz_dpiZvert_dpiwidth_px height_pxwidthheightr r r!r.xs     zImagePart._native_sizecCr8)zNA (width, height) 2-tuple representing the dimensions of this image in pixels.)rr9rsizer;r r r!r?r=zImagePart._px_sizer) rr rrrr rrrr)rr r"rr#rr#r)r#r)r*r+r,r+r#r-r#r-)r#r>)__name__ __module__ __qualname____doc__r classmethodr'propertyr)r%r"r2r r6r<r.r? __classcell__r r rr!rs*         rcseZdZdZd%fdd Zed&d'd d Zed(ddZed)ddZ e d*ddZ e d+ddZ e d*ddZ ed,ddZe d*ddZe d+ddZed,d d!Ze d-d#d$ZZS).rzIImmutable value object representing an image such as a JPEG, PNG, or GIF.rrrrcstt|||_||_dSr)rrrrr)rrrrr r!rs zImage.__init__Nr#cCs |||S)zCReturn a new |Image| object loaded from the image binary in `blob`.r )r&rrr r r!r9 zImage.from_blob image_filestr | IO[bytes]cCszt|tr%t|d }|}Wdn1swYtj|}ntt|dr1| d|}d}| ||S)zReturn a new |Image| object loaded from `image_file`. `image_file` can be either a path (str) or a file-like object. rbNseekr) isinstanceropenreadospathbasenamecallablegetattrrRr9)r&rOfrrr r r! from_files     zImage.from_filecC|jS)z*The binary image bytestream of this image.)rr(r r r!rsz Image.blobrcCs t|jS)z-MIME-type of this image, e.g. `"image/jpeg"`.)r r%r(r r r!rrNzImage.content_typer-cs&d ddd fdd }||jd S) zA (horz_dpi, vert_dpi) 2-tuple specifying the dots-per-inch resolution of this image. A default value of (72, 72) is used if the dpi is not specified in the image file. r:rc SsNzttt|}|dks|dkrd}W|SW|Sttfy&d}Y|Sw)zReturn an integer dots-per-inch value corresponding to `dpi`. If `dpi` is |None|, a non-numeric type, less than 1 or greater than 2048, 72 is returned. iH)r0r1r/ TypeError ValueError)r:int_dpir r r!rbszImage.dpi..int_dpipil_dpituple[int, int] | Nonecs&t|tr|d|dfSdS)zReturn a (horz_dpi, vert_dpi) 2-tuple corresponding to `pil_dpi`. The value for the 'dpi' key in the `info` dict of a PIL image. If the 'dpi' key is not present or contains an invalid value, `(72, 72)` is returned. rr^)r_r_)rStuple)rcrbr r!normalize_pil_dpis z$Image.dpi..normalize_pil_dpiN)r:r)rcrd _pil_props)rrgr rfr!r:s  z Image.dpicCs@ddddddd}|j}||vrd}t|||f||S) aCanonical file extension for this image e.g. `'png'`. The returned extension is all lowercase and is the canonical extension for the content type of this image, regardless of what extension may have been used in its filename, if any. bmpgifjpgpngtiffwmf)BMPGIFJPEGPNGTIFFZWMFz7unsupported image format, expected one of: %s, got '%s')_formatrakeys)rZext_mapformattmplr r r!r%sz Image.extcCr])zFilename from path used to load this image, if loaded from the filesystem. |None| if no filename was used in loading, such as when loaded from an in-memory stream. )rr(r r r!rszImage.filenamecCr3)z#SHA1 hash digest of the image blob.r4r(r r r!r6sz Image.sha1cC |jdS)zLA (width, height) 2-tuple specifying the dimensions of this image in pixels.r^rir(r r r!rDrNz Image.sizecCrz)z/The PIL Image format of this image, e.g. 'PNG'.rrir(r r r!rvrNz Image._format:tuple[str | None, tuple[int, int], tuple[int, int] | None]cCsNt|j}t|}|j}|j\}}td|j d}| |||f|fS)zAtuple of image properties extracted from this image using Pillow.rdr:) ioBytesIOr PIL_ImagerTrxrDrinfogetclose)rstreamZ pil_imagerxr@rAr:r r r!rjs    zImage._pil_props)rrrrr)rrrrr#r)rOrPr#r)r#rrErF)r#r)r#r{)rGrHrIrJrrKr9r\rLrr rr:r%rr6rDrvrjrMr r rr!rs2         r)rJ __future__rr5r|rVtypingrrrrPILrr~pptx.opc.packager pptx.opc.specr pptx.utilr r pptx.opc.packurir pptx.packager rrobjectr r r r!s        x