o 7¾hÅã@sÌdZddlmZddlmZddlmZddlmZm Z m Z ddl m Z ddl mZddlmZerDdd lmZdd lmZdd lmZGd d „d e ƒZGdd„deƒZGdd„deƒZGdd„deƒZdS)zAShapes based on the `p:pic` element, including Picture and Movie.é)Ú annotations)Ú TYPE_CHECKING©Ú LineFormat)Ú MSO_SHAPEÚMSO_SHAPE_TYPEÚ PP_MEDIA_TYPE)Ú BaseShape)ÚParentedElementProxy)Ú lazyproperty)Ú CT_Picture)ÚCT_LineProperties)Ú ProvidesPartcs¾eZdZdZd‡fdd„ Zed d d „ƒZejd!d d „ƒZed dd„ƒZejd!dd„ƒZed dd„ƒZ e jd!dd„ƒZ ed dd„ƒZ e jd!dd„ƒZ dd„Z e d"dd„ƒZ ed#dd„ƒZ‡ZS)$Ú _BasePicturez1Base class for shapes based on a `p:pic` element.Úpicr Úparentrcstt|ƒ ||¡||_dS©N)ÚsuperrÚ__init__Ú_pic)Úselfrr©Ú __class__©ú[/var/www/html/figdemos/bartoux_crm/venv/lib/python3.10/site-packages/pptx/shapes/picture.pyrs z_BasePicture.__init__ÚreturnÚfloatcCó|jjS)zÞ|float| representing relative portion cropped from shape bottom. Read/write. 1.0 represents 100%. For example, 25% is represented by 0.25. Negative values are valid as are values greater than 1.0. ©rÚ srcRect_b©rrrrÚ crop_bottomóz_BasePicture.crop_bottomÚvaluecCó ||j_dSrr©rr#rrrr!#ó cCr)z¹|float| representing relative portion cropped from left of shape. Read/write. 1.0 represents 100%. A negative value extends the side beyond the image boundary. ©rÚ srcRect_lr rrrÚ crop_left'r"z_BasePicture.crop_leftcCr$rr'r%rrrr)0r&cCr)zu|float| representing relative portion cropped from right of shape. Read/write. 1.0 represents 100%. ©rÚ srcRect_rr rrrÚ crop_right4óz_BasePicture.crop_rightcCr$rr*r%rrrr,<r&cCr)zp|float| representing relative portion cropped from shape top. Read/write. 1.0 represents 100%. ©rÚ srcRect_tr rrrÚcrop_top@r-z_BasePicture.crop_topcCr$rr.r%rrrr0Hr&cCs |j ¡S)z…Return the `a:ln` element for this `p:pic`-based image. The `a:ln` element contains the line format properties XML. )rÚ get_or_add_lnr rrrr1Ls z_BasePicture.get_or_add_lnrcCst|ƒS)zRProvides access to properties of the picture outline, such as its color and width.rr rrrÚlineSsz_BasePicture.lineúCT_LineProperties | NonecCr)z¨The `a:ln` element for this `p:pic`. Contains the line format properties such as line color and width. |None| if no `a:ln` element is present. )rÚlnr rrrr4Xr"z_BasePicture.ln)rr rr)rr)r#r)rr)rr3)Ú__name__Ú __module__Ú __qualname__Ú__doc__rÚpropertyr!Úsetterr)r,r0r1r r2r4Ú __classcell__rrrrrs0         rc@sFeZdZdZeddd„ƒZeddd„ƒZed d „ƒZedd d „ƒZ dS)ÚMoviezùA movie shape, one that places a video on a slide. Like |Picture|, a movie shape is based on the `p:pic` element. A movie is composed of a video and a *poster frame*, the placeholder image that represents the video before it is played. rÚ _MediaFormatcCs t|j|ƒS)zThe |_MediaFormat| object for this movie. The |_MediaFormat| object provides access to formatting properties for the movie. )r=rr rrrÚ media_formatis zMovie.media_formatrcCótjS)zMember of :ref:`PpMediaType` describing this shape. The return value is unconditionally `PP_MEDIA_TYPE.MOVIE` in this case. )rÚMOVIEr rrrÚ media_typeqszMovie.media_typecCs&|j|jj}}|durdS| |¡S)zŒReturn |Image| object containing poster frame for this movie. Returns |None| if this movie has no poster frame (uncommon). N)ÚpartrÚblip_rIdÚ get_image©rÚ slide_partÚrIdrrrÚ poster_frameys zMovie.poster_framercCr?)zžReturn member of :ref:`MsoShapeType` describing this shape. The return value is unconditionally `MSO_SHAPE_TYPE.MEDIA` in this case. )rÚMEDIAr rrrÚ shape_type„szMovie.shape_typeN)rr=)rr©rr) r5r6r7r8r r>r9rArHrJrrrrr<bs    r<c@sHeZdZdZeddd„ƒZejddd„ƒZed d „ƒZedd d „ƒZdS)ÚPicturez]A picture shape, one that places an image on a slide. Based on the `p:pic` element. rúMSO_SHAPE | NonecCs|jjj}|dur dS|jS)aMember of MSO_SHAPE indicating masking shape. A picture can be masked by any of the so-called "auto-shapes" available in PowerPoint, such as an ellipse or triangle. When a picture is masked by a shape, the shape assumes the same dimensions as the picture and the portion of the picture outside the shape boundaries does not appear. Note the default value for a newly-inserted picture is `MSO_AUTO_SHAPE_TYPE.RECTANGLE`, which performs no cropping because the extents of the rectangle exactly correspond to the extents of the picture. The available shapes correspond to the members of :ref:`MsoAutoShapeType`. The return value can also be |None|, indicating the picture either has no geometry (not expected) or has custom geometry, like a freeform shape. A picture with no geometry will have no visible representation on the slide, although it can be selected. This is because without geometry, there is no "inside-the-shape" for it to appear in. N)rÚspPrÚprstGeomÚprst)rrOrrrÚauto_shape_type”s zPicture.auto_shape_typeÚmemberrcCs:t |¡|jj}|j}|dur| ¡| ¡}||_dSr)rÚvalidaterrNrOÚ_remove_custGeomÚ _add_prstGeomrP)rrRrNrOrrrrQ«s  cCs*|j|jj}}|durtdƒ‚| |¡S)z†The |Image| object for this picture. Provides access to the properties and bytes of the image in this picture shape. Nzno embedded image)rBrrCÚ ValueErrorrDrErrrÚimageµs z Picture.imagercCr?)z6Unconditionally `MSO_SHAPE_TYPE.PICTURE` in this case.)rÚPICTUREr rrrrJÀszPicture.shape_typeN)rrM)rRrrK) r5r6r7r8r9rQr:rWrJrrrrrLŽs    rLc@seZdZdZdS)r=zProvides access to formatting properties for a Media object. Media format properties are things like start point, volume, and compression type. N)r5r6r7r8rrrrr=Æsr=N)r8Ú __future__rÚtypingrÚ pptx.dml.linerÚpptx.enum.shapesrrrÚpptx.shapes.baser Ú pptx.sharedr Ú pptx.utilr Úpptx.oxml.shapes.picturer Úpptx.oxml.shapes.sharedr Ú pptx.typesrrr<rLr=rrrrÚs          O,8