lidZddlmZddlmZddlmZddlmZm Z m Z ddl m Z ddl mZddlmZerdd lmZdd lmZdd lmZGd d e ZGddeZGddeZGddeZy)zAShapes based on the `p:pic` element, including Picture and Movie.) annotations) TYPE_CHECKING LineFormat) MSO_SHAPEMSO_SHAPE_TYPE PP_MEDIA_TYPE) BaseShape)ParentedElementProxy) lazyproperty) CT_Picture)CT_LineProperties) ProvidesPartc.eZdZdZdfd ZeddZejddZeddZejddZeddZ e jddZ edd Z e jdd Z d Z e dd Z edd ZxZS) _BasePicturez1Base class for shapes based on a `p:pic` element.c<tt| ||||_yN)superr__init___pic)selfpicparent __class__s Q/var/www/html/eduruby.in/venv/lib/python3.12/site-packages/pptx/shapes/picture.pyrz_BasePicture.__init__s lD*37 c.|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_brs r crop_bottomz_BasePicture.crop_bottomyy"""rc&||j_yrrrvalues rr!z_BasePicture.crop_bottom## rc.|jjS)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 s r crop_leftz_BasePicture.crop_left'r"rc&||j_yrr(r$s rr*z_BasePicture.crop_left0r&rc.|jjS)zu|float| representing relative portion cropped from right of shape. Read/write. 1.0 represents 100%. r srcRect_rr s r crop_rightz_BasePicture.crop_right4 yy"""rc&||j_yrr-r$s rr/z_BasePicture.crop_right<r&rc.|jjS)zp|float| representing relative portion cropped from shape top. Read/write. 1.0 represents 100%. r srcRect_tr s rcrop_topz_BasePicture.crop_top@r0rc&||j_yrr3r$s rr5z_BasePicture.crop_topHr&rc6|jjS)zReturn 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 s rr8z_BasePicture.get_or_add_lnLs yy&&((rct|S)zRProvides access to properties of the picture outline, such as its color and width.rr s rlinez_BasePicture.lineSs$rc.|jjS)zThe `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. )rlnr s rr<z_BasePicture.lnXsyy||r)rr rr)returnfloat)r%r>)r=r)r=zCT_LineProperties | None)__name__ __module__ __qualname____doc__rpropertyr!setterr*r/r5r8r r:r< __classcell__)rs@rrrs;##$$##$$##$$##__$$)  rrcVeZdZdZeddZeddZedZed dZ y) MoviezA 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. c.t|j|S)zThe |_MediaFormat| object for this movie. The |_MediaFormat| object provides access to formatting properties for the movie. ) _MediaFormatrr s r media_formatzMovie.media_formatis DIIt,,rc"tjS)zMember of :ref:`PpMediaType` describing this shape. The return value is unconditionally `PP_MEDIA_TYPE.MOVIE` in this case. )r MOVIEr s r media_typezMovie.media_typeqs """rcn|j|jj}}|y|j|S)zReturn |Image| object containing poster frame for this movie. Returns |None| if this movie has no poster frame (uncommon). N)partrblip_rId get_imager slide_partrIds r poster_framezMovie.poster_frameys4 ))TYY%7%7C ;##C((rc"tjS)zReturn member of :ref:`MsoShapeType` describing this shape. The return value is unconditionally `MSO_SHAPE_TYPE.MEDIA` in this case. )rMEDIAr s r shape_typezMovie.shape_types###rN)r=rI)r=r r=r) r?r@rArBr rJrCrMrUrXrrrGrGbsW --##))$$rrGcjeZdZdZeddZej ddZedZed dZy) Picturez]A picture shape, one that places an image on a slide. Based on the `p:pic` element. c`|jjj}|y|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)rspPrprstGeomprst)rr_s rauto_shape_typezPicture.auto_shape_types*$99>>**  }}rctj||jj}|j}| |j |j }||_yr)rvalidaterr^r__remove_custGeom _add_prstGeomr`)rmemberr^r_s rrazPicture.auto_shape_typesM6"yy~~==    ! ! #))+H rc|j|jj}}| td|j |S)zThe |Image| object for this picture. Provides access to the properties and bytes of the image in this picture shape. zno embedded image)rOrrP ValueErrorrQrRs rimagez Picture.images= ))TYY%7%7C ;01 1##C((rc"tjS)z6Unconditionally `MSO_SHAPE_TYPE.PICTURE` in this case.)rPICTUREr s rrXzPicture.shape_types%%%rN)r=zMSO_SHAPE | None)rfrrY) r?r@rArBrCrarDrirXrZrrr\r\s] ,))&&rr\ceZdZdZy)rIzProvides access to formatting properties for a Media object. Media format properties are things like start point, volume, and compression type. N)r?r@rArBrZrrrIrIsrrIN)rB __future__rtypingr pptx.dml.linerpptx.enum.shapesrrr pptx.shapes.baser pptx.sharedr pptx.utilr pptx.oxml.shapes.picturer pptx.oxml.shapes.sharedr pptx.typesrrrGr\rIrZrrrwsbG" $EE&,"39'L9L^)$L)$X5&l5&p'r