hi4dZddlmZddlZddlZddlmZmZmZm Z m Z m Z ddl m Z mZddlmZmZddlmZddlmZdd lmZdd lmZdd lmZdd lmZdd lm Z m!Z!ddl"m#Z#ddl$m%Z%ddl&m'Z'ddl(m)Z)ddl*m+Z+ddl,m-Z-m.Z.ddl/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5m6Z6m7Z7m8Z8ddl9m:Z:ddl;mm?Z?ddl@mAZAddlBmCZCddl mDZDmEZEddlFmGZGddlHmIZIddlJmKZKddlLmMZMddlNmOZOdd lPmQZQmRZRdd!lSmTZTdd"l;mUZUGd#d$e:ZVGd%d&eVZWGd'd(eWZXGd)d*eWZYGd+d,eVZZGd-d.eVZ[Gd/d0eVZ\Gd1d2eVZ]Gd3d4e]Z^Gd5d6e]Z_Gd7d8e_Z`Gd9d:e:ZadKdAZbdKdBZcdKdCZddKdDZedLdEZfdKdFZgGdGdHehZiGdIdJehZjdS)Mz:The shape tree, the structure that holds a slide's shapes.) annotationsN)IO TYPE_CHECKINGCallableIterableIteratorcast)PP_PLACEHOLDERPROG_ID)SPEAKER_IMAGE_BYTESVideo) CONTENT_TYPE)qn)CT_Shape)CT_GraphicalObjectFrame) CT_Picture) ST_Direction) AutoShapeTypeShape) BaseShape) Connector)FreeformBuilder) GraphicFrame) GroupShape)MoviePicture) ChartPlaceholderLayoutPlaceholderMasterPlaceholderNotesSlidePlaceholderPicturePlaceholderPlaceholderGraphicFramePlaceholderPictureSlidePlaceholderTablePlaceholder)ParentedElementProxy)Emu lazyproperty)Chart) ChartData) XL_CHART_TYPE)MSO_CONNECTOR_TYPE MSO_SHAPE) ShapeElement) CT_Connector) CT_GroupShape) ImagePart) SlidePart)Slide SlideLayout) ProvidesPart)LengthceZdZdZd%fd Zd&d Zd'd Zd(dZd)dZd*dZ e d+dZ e j d,dZ e d-dZd.dZd/d"Ze d(d#Zd0d$ZxZS)1 _BaseShapeszBase class for a shape collection appearing in a slide-type object. Subclasses include Slide, SlideLayout, and SlideMaster. Provides common methods. spTreer0parentr5cvtt|||||_d|_dSN)superr8__init___spTree_cached_max_shape_id)selfr9r: __class__s m/var/www/development/aibuddy-work/election-extract/venv/lib/python3.11/site-packages/pptx/shapes/shapetree.pyr>z_BaseShapes.__init__Ss8 k4  ))&&999 $(!!!idxintreturnrct|} ||}n#t$rtdwxYw||S)z4Return shape at `idx` in sequence, e.g. `shapes[2]`.zshape index out of range)list_iter_member_elms IndexError_shape_factory)rArE shape_elms shape_elms rC __getitem__z_BaseShapes.__getitem__Xsi$002233  9"3II 9 9 9788 8 9""9---s ,AIterator[BaseShape]c#fK|D]}||VdS)zBGenerate a reference to each shape in the collection, in sequence.N)rJrLrArNs rC__iter__z_BaseShapes.__iter__asH//11 1 1I%%i00 0 0 0 0 1 1rDcbt|}t|S)zReturn count of shapes in this shape tree. A group shape contributes 1 to the total, without regard to the number of shapes contained in the group. )rIrJlen)rArMs rC__len__z_BaseShapes.__len__fs) $002233 :rD placeholderrNonec|j}|j|j|j|jf\}}}}|j}||||}|j||||||dS)z3Add a new placeholder shape based on `placeholder`.N) elementph_type ph_orientph_szph_idx_next_shape_id _next_ph_namer?add_placeholder) rArWspr[orientszrEid_names rCclone_placeholderz_BaseShapes.clone_placeholderosn  $&J bh #R S!!!'377 $$S$SIIIIIrDr[r strcztjdtjdtjdtjdtjdtjdtjdtjdtj d tj d tj d tj d tj d tjdtjdi|S)a Return the base name for a placeholder of `ph_type` in this shape collection. There is some variance between slide types, for example a notes slide uses a different name for the body placeholder, so this method can be overriden by subclasses. zClipArt PlaceholderzText PlaceholderTitlezChart PlaceholderDate PlaceholderFooter PlaceholderHeader PlaceholderzMedia PlaceholderzContent PlaceholderzSmartArt PlaceholderzPicture PlaceholderSlide Number PlaceholderSubtitlezTable Placeholder)r BITMAPBODY CENTER_TITLECHARTDATEFOOTERHEADER MEDIA_CLIPOBJECT ORG_CHARTPICTURE SLIDE_NUMBERSUBTITLETABLETITLErAr[s rC ph_basenamez_BaseShapes.ph_basenamews  !#8  !3  '  "5  !3  !#7  !#7  %':  !#8  $&<  "$9  ')C  #Z  "5  ' ! rDboolc|jduS)aTrue if "turbo-add" mode is enabled. Read/Write. EXPERIMENTAL: This feature can radically improve performance when adding large numbers (hundreds of shapes) to a slide. It works by caching the last shape ID used and incrementing that value to assign the next shape id. This avoids repeatedly searching all shape ids in the slide each time a new ID is required. Performance is not noticeably improved for a slide with a relatively small number of shapes, but because the search time rises with the square of the shape count, this option can be useful for optimizing generation of a slide composed of many shapes. Shape-id collisions can occur (causing a repair error on load) if more than one |Slide| object is used to interact with the same slide in the presentation. Note that the |Slides| collection creates a new |Slide| object each time a slide is accessed (e.g. `slide = prs.slides[0]`, so you must be careful to limit use to a single |Slide| object. N)r@rAs rCturbo_add_enabledz_BaseShapes.turbo_add_enableds$(44rDvaluecNt|}|r |jjnd|_dSr<)rr? max_shape_idr@)rArenables rCrz_BaseShapes.turbo_add_enableds*eAG$QDL$=$=T!!!rDrNr.cdS)zSReturn true if `shape_elm` represents a member of this collection, False otherwise.TrNs rC_is_member_elmz_BaseShapes._is_member_elms trDIterator[ShapeElement]c#tK|jD]}||r|VdS)zGenerate each child of the `p:spTree` element that corresponds to a shape. Items appear in XML document order. N)r?iter_shape_elmsrrRs rCrJz_BaseShapes._iter_member_elmssO 5577  I""9--   rDidrcc||}|tjkrd|z}|dz }|jd} d||fz}||vrn|dz }|S)aNext unique placeholder name for placeholder shape of type `ph_type`. Usually will be standard placeholder root name suffixed with id-1, e.g. _next_ph_name(ST_PlaceholderType.TBL, 4, 'horz') ==> 'Table Placeholder 3'. The number is incremented as necessary to make the name unique within the collection. If `orient` is `'vert'`, the placeholder name is prefixed with `'Vertical '`. z Vertical %sz//p:cNvPr/@nameT%s %d)rrVERTr?xpath)rAr[rrcbasenamenumpartnamesrfs rCr`z_BaseShapes._next_ph_names##G,, \& & &$x/Hq& ""#455 h00D5   qLG    rDc\|j|xjdz c_|jS|jjdzS)zReturn a unique shape id suitable for use with a new shape. The returned id is 1 greater than the maximum shape id used so far. In practice, the minimum id is 2 because the spTree element is always assigned id="1". Nr)r@r?rrs rCr_z_BaseShapes._next_shape_ids:  $ 0  % % * % %, ,|(1,,rDc"t||SHReturn an instance of the appropriate shape proxy class for `shape_elm`.)BaseShapeFactoryrRs rCrLz_BaseShapes._shape_factorys 4000rD)r9r0r:r5)rErFrGr)rGrPrGrF)rWrrGrXr[r rGrh)rGr)rrrNr.rGr)rGr)r[r rrFrcrhrGrhrNr.rGr)__name__ __module__ __qualname____doc__r>rOrSrVrgrpropertyrsetter staticmethodrrJr`r_rL __classcell__rBs@rCr8r8Mss )))))) ....1111 JJJJ0555X5&RRRR\    2 - - -X -11111111rDr8ceZdZUdZded<ded<dXfd ZdYdZdZdZd[d\d"Z d]d^d2Z d_d`d5Z dad9Z dbd:Z dcdddCZ dedGZdfdJZdgdLZdhdPZdidTZdjdUZdkdWZxZS)l_BaseGroupShapesz/Base class for shape-trees that can add shapes.r2partr0_elementgrpSpr:r5chtt|||||_dSr<)r=rr>_grpSp)rArr:rBs rCr>z_BaseGroupShapes.__init__s/ %%..uf=== rD chart_typer+xr6ycxcy chart_datar*rGr)c|j||}||||||}|t d||S)aBAdd a new chart of `chart_type` to the slide. The chart is positioned at (`x`, `y`), has size (`cx`, `cy`), and depicts `chart_data`. `chart_type` is one of the :ref:`XlChartType` enumeration values. `chart_data` is a |ChartData| object populated with the categories and series values for the chart. Note that a |GraphicFrame| shape object is returned, not the |Chart| object contained in that graphic frame shape. The chart object may be accessed using the :attr:`chart` property of the returned |GraphicFrame| object. r))radd_chart_part_add_chart_graphicFrame_recalculate_extentsr rL) rArrrrrrrId graphicFrames rC add_chartz_BaseGroupShapes.add_chartsf&i&&z:>>33CAr2FF  !!###GT00>>???rDconnector_typer,begin_xbegin_yend_xend_yrc||||||}|tt||S)a@Add a newly created connector shape to the end of this shape tree. `connector_type` is a member of the :ref:`MsoConnectorType` enumeration and the end-point values are specified as EMU values. The returned connector is of type `connector_type` and has begin and end points as specified. ) _add_cxnSprr rrL)rArrrrrcxnSps rC add_connectorz_BaseGroupShapes.add_connectorsM%OO !!###It22599:::rDrshapesIterable[BaseShape]rct|}|j}|D]}||jd|r|t t ||S)aReturn a |GroupShape| object newly appended to this shape tree. The group shape is empty and must be populated with shapes using methods on its shape tree, available on its `.shapes` property. The position and extents of the group shape are determined by the shapes it contains; its position and extents are recalculated each time a shape is added to it. zp:extLst)tupler add_grpSpinsert_element_beforerecalculate_extentsr rrL)rArrshapes rCadd_group_shapez _BaseGroupShapes.add_group_shapesv ''))  E  ' '       (  % % ' ' 'J 3 3E : :;;;rDN object_filestr | IO[bytes]prog_idrhlefttopwidth Length | Noneheight icon_filestr | IO[bytes] | None icon_width icon_heightrc t||j||||||||| } |j| |t t|| S)aqReturn newly-created GraphicFrame shape embedding `object_file`. The returned graphic-frame shape contains `object_file` as an embedded OLE object. It is displayed as an icon at `left`, `top` with size `width`, `height`. `width` and `height` may be omitted when `prog_id` is a member of `PROG_ID`, in which case the default icon size is used. This is advised for best appearance where applicable because it avoids an icon with a "stretched" appearance. `object_file` may either be a str path to a file or file-like object (such as `io.BytesIO`) containing the bytes of the object to be embedded (such as an Excel file). `prog_id` can be either a member of `pptx.enum.shapes.PROG_ID` or a str value like `"Adobe.Exchange.7"` determined by inspecting the XML generated by PowerPoint for an object of the desired type. `icon_file` may either be a str path to an image file or a file-like object containing the image. The image provided will be displayed in lieu of the OLE object; double-clicking on the image opens the object (subject to operating-system limitations). The image file can be any supported image file. Those produced by PowerPoint itself are generally EMF and can be harvested from a PPTX package that embeds such an object. PNG and JPG also work fine. `icon_width` and `icon_height` are `Length` values (e.g. Emu() or Inches()) that describe the size of the icon image within the shape. These should be omitted unless a custom `icon_file` is provided. The dimensions must be discovered by inspecting the XML. Automatic resizing of the OLE-object shape can occur when the icon is double-clicked if these values are not as set by PowerPoint. This behavior may only manifest in the Windows version of PowerPoint. ) _OleObjectElementCreatorrr_r?appendrr rrL) rArrrrrrrrrrs rCadd_ole_objectz_BaseGroupShapes.add_ole_object(sP0<<                L))) !!###L$"5"5l"C"CDDDrD image_filerc|j|\}}|||||||}|t t ||S)a3Add picture shape displaying image in `image_file`. `image_file` can be either a path to a file (a string) or a file-like object. The picture is positioned with its top-left corner at (`top`, `left`). If `width` and `height` are both |None|, the native size of the image is used. If only one of `width` or `height` is used, the unspecified dimension is calculated to preserve the aspect ratio of the image. If both are specified, the picture is stretched to fit, without regard to its native aspect ratio. )rget_or_add_image_part_add_pic_from_image_partrr rrL) rArrrrr image_partrpics rC add_picturez_BaseGroupShapes.add_pictureasj")99*EE C++JT3vVV !!###GT0055666rDautoshape_type_idr-rct|}||||||}|tt||S)aReturn new |Shape| object appended to this shape tree. `autoshape_type_id` is a member of :ref:`MsoAutoShapeType` e.g. `MSO_SHAPE.RECTANGLE` specifying the type of shape to be added. The remaining arguments specify the new shape's position and size. )r_add_sprr rrL)rArrrrrautoshape_typerbs rC add_shapez_BaseGroupShapes.add_shapews[''899 \\.$UF C C !!###E4..r22333rDc|||||}|tt||S)zReturn newly added text box shape appended to this shape tree. The text box is of the specified size, located at the specified position on the slide. )_add_textbox_sprr rrL)rArrrrrbs rC add_textboxz_BaseGroupShapes.add_textboxsM  ! !$UF ; ; !!###E4..r22333rDr?start_xfloatstart_yscaletuple[float, float] | floatrcnt|tr|n||f\}}tj|||||S)aReturn |FreeformBuilder| object to specify a freeform shape. The optional `start_x` and `start_y` arguments specify the starting pen position in local coordinates. They will be rounded to the nearest integer before use and each default to zero. The optional `scale` argument specifies the size of local coordinates proportional to slide coordinates (EMU). If the vertical scale is different than the horizontal scale (local coordinate units are "rectangular"), a pair of numeric values can be provided as the `scale` argument, e.g. `scale=(1.0, 2.0)`. In this case the first number is interpreted as the horizontal (X) scale and the second as the vertical (Y) scale. A convenient method for calculating scale is to divide a |Length| object by an equivalent count of local coordinate units, e.g. `scale = Inches(1)/1000` for 1000 local units per inch. ) isinstancerrnew)rArrrx_scaley_scales rCbuild_freeformz_BaseGroupShapes.build_freeforms>&%/ue$<$<P555%."4'7GLLLrDrrrFct|j}||jS)zxReturn the index of `shape` in this sequence. Raises |ValueError| if `shape` is not in the collection. )rIrrindexrZ)rArrMs rCrz_BaseGroupShapes.indexs5 $-7799::  ...rDrrc |j}d|dz z}tj|||||||}|j||S)zReturn new `p:graphicFrame` element appended to this shape tree. The `p:graphicFrame` element has the specified position and size and refers to the chart part identified by `rId`. zChart %dr)r_rnew_chart_graphicFramer?r) rArrrrrshape_idrfrs rCrz(_BaseGroupShapes._add_chart_graphicFramesY&X\*.E dCAr2   L)))rDr/c |j}d|dz z}||k||k} }t||t||} } t||z t||z } } |j|||| | | | || S)zReturn a newly-added `p:cxnSp` element as specified. The `p:cxnSp` element is for a connector of `connector_type` beginning at (`begin_x`, `begin_y`) and extending to (`end_x`, `end_y`). z Connector %dr)r_minabsr add_cxnSp)rArrrrrrerfflipHflipVrrrrs rCrz_BaseGroupShapes._add_cxnSps!q)%u7E""C$7$71UW_%%s57?';';B}&&sD.!QBPUW\]]]rDrr1rc |j}|||\}} d|dz z} |j} |j|| | ||||| } | S)a1Return a newly appended `p:pic` element as specified. The `p:pic` element displays the image in `image_part` with size and position specified by `x`, `y`, `cx`, and `cy`. The element is appended to the shape tree, causing it to be displayed first in z-order on the slide. z Picture %dr)r_rdescradd_pic) rArrrrrrre scaled_cx scaled_cyrfrrs rCrz)_BaseGroupShapes._add_pic_from_image_partsc!)//B77 9sQw'k!!#tT31iSS rDrrrc ||j}d|j|dz fz}|j|||j||||}|S)zReturn newly-added `p:sp` element as specified. `p:sp` element is of `autoshape_type` at position (`x`, `y`) and of size (`cx`, `cy`). rr)r_rr add_autoshapeprst) rArrrrrrerfrbs rCrz_BaseGroupShapes._add_spsL!.137;; [ & &sD.2Eq!RQS T T rDcb|j}d|dz z}|j||||||}|S)zvReturn newly-appended textbox `p:sp` element. Element has position (`x`, `y`) and size (`cx`, `cy`). z TextBox %dr)r_r?r)rArrrrrerfrbs rCrz _BaseGroupShapes._add_textbox_sps> !sQw' \ % %c4Ar2 > > rDrXcdSzAdjust position and size to incorporate all contained shapes. This would typically be called when a contained shape is added, removed, or its position or size updated. Nrrs rCrz%_BaseGroupShapes._recalculate_extentss  rD)rr0r:r5)rr+rr6rr6rr6rr6rr*rGr)) rr,rr6rr6rr6rr6rGr)r)rrrGr)NNNNN)rrrrhrr6rr6rrrrrrrrrrrGr)NN) rrrr6rr6rrrrrGr) rr-rr6rr6rr6rr6rGr) rr6rr6rr6rr6rGr)rrr)rrrrrrrGr)rrrGrF) rrhrr6rr6rr6rr6rGr) rr,rr6rr6rr6rr6rGr/)rr1rrhrr6rr6rrrrrGr) rrrr6rr6rr6rr6rGr) rr6rr6rr6rr6rGrrGrX)rrrr__annotations__r>rrrrrrrrrrrrrrrrrs@rCrrs99OOO@@@@0;;;;$<<<<<0 $ $,0$(%)7E7E7E7E7E| $ $ 77777, 4 4 4 44444\_MMMMM.//// ^^^^,,            rDrceZdZdZddZdS) GroupShapeszThe sequence of child shapes belonging to a group shape. Note that this collection can itself contain a group shape, making this part of a recursive, tree data structure (acyclic graph). rGrXc8|jdSr)rrrs rCrz GroupShapes._recalculate_extentss '')))))rDNr)rrrrrrrDrCrr s2 ******rDrceZdZUdZded<dejfd,dZd-dZd.dZ e d/dZ e d0dZ d1d$Z d2d'Zd3d+ZdS)4 SlideShapeszSequence of shapes appearing on a slide. The first shape in the sequence is the backmost in z-order and the last shape is topmost. Supports indexed access, len(), index(), and iteration. r3r:N movie_filerrr6rrrposter_frame_imager mime_typerhrGrc t||j||||||| }|j|||t t||S)aReturn newly added movie shape displaying video in `movie_file`. **EXPERIMENTAL.** This method has important limitations: * The size must be specified; no auto-scaling such as that provided by :meth:`add_picture` is performed. * The MIME type of the video file should be specified, e.g. 'video/mp4'. The provided video file is not interrogated for its type. The MIME type `video/unknown` is used by default (and works fine in tests as of this writing). * A poster frame image must be provided, it cannot be automatically extracted from the video file. If no poster frame is provided, the default "media loudspeaker" image will be used. Return a newly added movie shape to the slide, positioned at (`left`, `top`), having size (`width`, `height`), and containing `movie_file`. Before the video is started, `poster_frame_image` is displayed as a placeholder for the video. ) _MoviePicElementCreator new_movie_picr_r?r_add_video_timingr rrL) rArrrrrrr movie_pics rC add_moviezSlideShapes.add_movie#s6,99              I&&& y)))L$"5"5i"@"@AAArDrowsrFcolsc|||||||}tt||S)aAdd a |GraphicFrame| object containing a table. The table has the specified number of `rows` and `cols` and the specified position and size. `width` is evenly distributed between the columns of the new table. Likewise, `height` is evenly distributed between the rows. Note that the `.table` property on the returned |GraphicFrame| shape must be used to access the enclosed |Table| object. )"_add_graphicFrame_containing_tabler rrL)rAr"r#rrrrrs rC add_tablezSlideShapes.add_tableMsB>>tT4QTV[]cdd L$"5"5l"C"CDDDrD slide_layoutr4rXc^|D]}||dS)zAdd placeholder shapes based on those in `slide_layout`. Z-order of placeholders is preserved. Latent placeholders (date, slide number, and footer) are not cloned. N)iter_cloneable_placeholdersrg)rAr'rWs rCclone_layout_placeholdersz%SlideShapes.clone_layout_placeholdersZs@ (CCEE 0 0K  " "; / / / / 0 0rDSlidePlaceholdersc|jjS)z-Sequence of placeholder shapes in this slide.)r: placeholdersrs rCr-zSlideShapes.placeholderscs{''rD Shape | Nonec|jD]7}|jdkr*tt||cS8dS)ziThe title placeholder shape on the slide. |None| if the slide has no title placeholder. rN)r? iter_ph_elmsr^r rrL)rAelms rCtitlezSlideShapes.titlehsZ <,,.. = =CzQE4#6#6s#;#;<<<<<trDrrrrrc f|j}d|dz z}|j||||||||} | S)zNReturn a newly added `p:graphicFrame` element containing a table as specified.zTable %dr)r_r?r&) rAr"r#rrrr_idrfrs rCr%z.SlideShapes._add_graphicFrame_containing_tablessC!S1W%|--c4tQ2rRR rDrrc|jdd}|}||jdS)zAdd a `p:video` element under `p:sld/p:timing`. The element will refer to the specified `pic` element by its shape id, and cause the video play controls to appear for that video. z/p:sldrN)r?rget_or_add_childTnLst add_videor)rArsld childTnLsts rCrzSlideShapes._add_video_timing|sK l  **1-..00 S\*****rDrNr.rc"t||SrSlideShapeFactoryrRs rCrLzSlideShapes._shape_factorys D111rD)rrrr6rr6rr6rr6rrrrhrGr)r"rFr#rFrr6rr6rr6rr6rGr)r'r4rGrX)rGr+)rGr.)r"rFr#rFrr6rr6rr6rr6rGr)rrrGrXr)rrrrrCTVIDEOr!r&r*rr-r2r%rrLrrDrCrrs MMM6:(B(B(B(B(BT E E E E0000(((X(X++++222222rDrceZdZdZddZdS) LayoutShapeszSequence of shapes appearing on a slide layout. The first shape in the sequence is the backmost in z-order and the last shape is topmost. Supports indexed access, len(), index(), and iteration. rNr.rGrc"t||Sr_LayoutShapeFactoryrRs rCrLzLayoutShapes._shape_factory"9d333rDNrrrrrrLrrDrCr@r@2 444444rDr@ceZdZdZddZdS) MasterShapeszSequence of shapes appearing on a slide master. The first shape in the sequence is the backmost in z-order and the last shape is topmost. Supports indexed access, len(), and iteration. rNr.rGrc"t||Sr)_MasterShapeFactoryrRs rCrLzMasterShapes._shape_factoryrDrDNrrErrDrCrHrHrFrDrHc"eZdZdZd dZd d Zd S)NotesSlideShapeszSequence of shapes appearing on a notes slide. The first shape in the sequence is the backmost in z-order and the last shape is topmost. Supports indexed access, len(), index(), and iteration. r[r rGrhc tjdtjdtjdtjdtjdtjdi|S)aReturn the base name for a placeholder of `ph_type` in this shape collection. A notes slide uses a different name for the body placeholder and has some unique placeholder types, so this method overrides the default in the base class. zNotes PlaceholderrkrlrmzSlide Image Placeholderrn)r rqrtrurv SLIDE_IMAGEr{rs rCrzNotesSlideShapes.ph_basenamesN  !4  !3  !#7  !#7  &(A  ')C    rDrNr.rc"t||S)zKReturn appropriate shape object for `shape_elm` appearing on a notes slide.)_NotesSlideShapeFactoryrRs rCrLzNotesSlideShapes._shape_factorys&y$777rDNrr)rrrrrrLrrDrCrLrLsF    888888rDrLc*eZdZdZeddZdS) BasePlaceholdersaBase class for placeholder collections. Subclasses differentiate behaviors for a master, layout, and slide. By default, placeholder shapes are constructed using |BaseShapeFactory|. Subclasses should override :method:`_shape_factory` to use custom placeholder classes. rNr.rGrc|jS)z$$$\$$$rDrRc0eZdZUdZded<ddd ZddZdS)LayoutPlaceholderszVSequence of |LayoutPlaceholder| instance for each placeholder shape on a slide layout.z)Callable[[], Iterator[LayoutPlaceholder]]rSNrErFdefaultLayoutPlaceholder | NonerGc8|D]}|jj|kr|cS|S)zQThe first placeholder shape with matching `idx` value, or `default` if not found.)rZr^)rArErWrWs rCgetzLayoutPlaceholders.gets8 # #K")S00""""1rDrNr.rc"t||SrrBrRs rCrLz!LayoutPlaceholders._shape_factoryrDrDr<)rErFrWrXrGrXrrrrrrrZrLrrDrCrVrVs]``444444rDrVc0eZdZUdZded<ddd ZddZdS)MasterPlaceholderszTSequence of MasterPlaceholder representing the placeholder shapes on a slide master.z)Callable[[], Iterator[MasterPlaceholder]]rSNr[r rWMasterPlaceholder | Nonec.|D]}|j|kr|cS|S)zReturn the first placeholder shape with type `ph_type` (e.g. 'body'). Returns `default` if no such placeholder shape is present in the collection. )r[)rAr[rWrWs rCrZzMasterPlaceholders.gets7   # #K"g--"""".rDplaceholder_elmrrGrcHttt||Sr)r rrJrAras rCrLz!MasterPlaceholders._shape_factorys %':?D'Q'QRRRrDr<)r[r rWr_)rarrGrr\rrDrCr^r^sc^^SSSSSSrDr^c&eZdZUdZded<d dZd S) NotesSlidePlaceholdersz0Sequence of placeholder shapes on a notes slide.z-Callable[[], Iterator[NotesSlidePlaceholder]]rSrarrGr cHttt||S)zTReturn an instance of the appropriate placeholder proxy class for `placeholder_elm`.)r r rPrcs rCrLz%NotesSlidePlaceholders._shape_factorys!)+B?TX+Y+YZZZrDN)rarrGr )rrrrrrLrrDrCreresJ::[[[[[[rDrec4eZdZUdZded<d dZdZd d Zd S) r+zCollection of placeholder shapes on a slide. Supports iteration, :func:`len`, and dictionary-style lookup on the `idx` value of the placeholders it contains. r0rrErFc|jD]}|j|krt||cS t d|z)zAccess placeholder shape having `idx`. Note that while this looks like list access, idx is actually a dictionary key and will raise |KeyError| if no placeholder with that idx value is in the collection. z+no placeholder on this slide with idx == %d)rr0r^r<KeyError)rArEes rCrOzSlidePlaceholders.__getitem__s[ ++-- 2 2Ax3(D11111DsJKKKrDctdjDd}fd|DS)z+Generate placeholder shapes in `idx` order.cg|]}|Srr).0rjs rC z.SlidePlaceholders.__iter__..sBBB!BBBrDc|jSr<)r^)rjs rCz,SlidePlaceholders.__iter__..s RSRZrD)keyc38K|]}t|VdSr<r;)rmrjrAs rC z-SlidePlaceholders.__iter__..s.<)X&&49+?4 F333 Iv . ..rDczt|tr|jrt||St ||S)zBReturn appropriate shape object for `shape_elm` on a slide master.)rrrTrrr~s rCrJrJ>rrDczt|tr|jrt||St ||S)zAReturn appropriate shape object for `shape_elm` on a notes slide.)rrrTr rr~s rCrPrPEs>)X&&89+?8$Y777 Iv . ..rDc|j}|tdkretjttjt tjttjti |j t}n=|tdkrt}n"|tdkrt}nt}|||S)zCReturn a placeholder shape of the appropriate type for `shape_elm`.rxryzp:pic)rzrr rpr!rsrrzr}r%rZr[r$r"r#r)rNr:rz Constructors rC_SlidePlaceholderFactoryrLs -C bjj  !#5  "2  "$6  "2  #i!1 2 2  #$$ $ $- 7  ( & ;y& ) ))rDcP|jrt||St||S)z;Return appropriate shape object for `shape_elm` on a slide.)rTrrr~s rCr<r<_s-;' 6::: Iv . ..rDceZdZdZd#fd Zed$dZed%dZe d&dZ e d'dZ e d%dZ ed%dZ ed(dZe d)dZe d*d!Zed%d"ZxZS)+raFunctional service object for creating a new movie p:pic element. It's entire external interface is its :meth:`new_movie_pic` class method that returns a new `p:pic` element containing the specified video. This class is not intended to be constructed or an instance of it retained by the caller; it is a "one-shot" object, really a function wrapped in a object such that its helper methods can be organized here. rrrrFrrrr6rrrposter_frame_filerr str | Nonec tt|||_||_||_||||f\|_|_|_|_ ||_ | |_ dSr<) r=rr>_shapes _shape_id _movie_file_x_y_cx_cy_poster_frame_file _mime_type) rArrrrrrrrrrBs rCr>z _MoviePicElementCreator.__init__osi %t,,55777 !%/0!R|,$(DH"3#rDrrGrc 2|||||||||| jS)zReturn a new `p:pic` element containing video in `movie_file`. If `mime_type` is None, 'video/unknown' is used. If `poster_frame_file` is None, the default "media loudspeaker" image is used. )_pic) clsrrrrrrrrrs rCrz%_MoviePicElementCreator.new_movie_pics)$s68ZAr2?QS\]]bbrDrhc|jdS)zReturn the rId of RT.MEDIA relationship to video part. For historical reasons, there are two relationships to the same part; one is the video rId and the other is the media rId. r_video_part_rIdsrs rC _media_rIdz"_MoviePicElementCreator._media_rId$Q''rDc tj|j|j|j|j|j|j|j|j |j S)z5Return the new `p:pic` element referencing the video.) r new_video_picr _shape_name _video_rIdr_poster_frame_rIdrrrrrs rCrz_MoviePicElementCreator._picsH' N   O O  " G G H H   rDcJ|j}|tjtS|S)zReturn the image file for video placeholder image. If no poster frame file is provided, the default "media loudspeaker" image is used. )rioBytesIOr )rArs rC_poster_frame_image_filez0_MoviePicElementCreator._poster_frame_image_files* !3  $:122 2  rDcJ|j|j\}}|S)zReturn the rId of relationship to poster frame image. The poster frame is the image used to represent the video before it's played. ) _slide_partrr)rA_poster_frame_rIds rCrz)_MoviePicElementCreator._poster_frame_rIds) #.DDTEbcc rDc|jjS)zReturn the appropriate shape name for the p:pic shape. A movie shape is named with the base filename of the video. )_videofilenamers rCrz#_MoviePicElementCreator._shape_names {##rDr2c|jjS)z8Return SlidePart object for slide containing this movie.rrrs rCrz#_MoviePicElementCreator._slide_part|  rDr c@tj|j|jS)z2Return a |Video| object containing the movie file.)r from_path_or_file_likerrrs rCrz_MoviePicElementCreator._videos+D, classmethodrrrr(rrrrrrrrrrs@rCrrfs$$$$$$(ccc[c&(((X(    \  !!!\!   \ $$$X$!!!X!OOO\O$$$\$(((X(((((rDrc:eZdZdZd&dZed'dZed(dZed)dZ ed)dZ ed)dZ ed*dZ ed+dZ ed)dZed+d Zed+d!Zed+d"Zed,d$Zd%S)-raFunctional service object for creating a new OLE-object p:graphicFrame element. It's entire external interface is its :meth:`graphicFrame` class method that returns a new `p:graphicFrame` element containing the specified embedded OLE-object shape. This class is not intended to be constructed or an instance of it retained by the caller; it is a "one-shot" object, really a function wrapped in a object such that its helper methods can be organized here. rrrrFole_object_filerr PROG_ID | strrr6rrrrrrrrc ||_||_||_||_||_||_||_||_| |_| |_ | |_ dSr<) rr_ole_object_file _prog_id_argrr_cx_arg_cy_arg_icon_file_arg_icon_width_arg_icon_height_arg) rArrrrrrrrrrrs rCr>z!_OleObjectElementCreator.__init__s\ ! /#  ') +rDrGrc 6|||||||||| | | jS)zJReturn new `p:graphicFrame` element containing embedded `ole_object_file`.) _graphicFrame) rrrrrrrrrrrrs rCrz%_OleObjectElementCreator.graphicFrame s> s              rDc tj|j|j|j|j|j|j|j|j |j |j |j S)zGNewly-created `p:graphicFrame` element referencing embedded OLE-object.) rnew_ole_object_graphicFramerr_ole_object_rId_progId _icon_rIdrrrr _icon_width _icon_heightrs rCrz&_OleObjectElementCreator._graphicFrame*sT'B N    L N G G H H       rDc|j|jSt|jtrt |jjnt dS)zBEmu object specifying width of "show-as-icon" image for OLE shape.NP)rrrr r'rrs rCrz_OleObjectElementCreator._cx;sM < #<  -7t7H',R,R cC!' ( ( (X[\bXcXc rDc|j|jSt|jtrt |jjnt dS)zCEmu object specifying height of "show-as-icon" image for OLE shape.N@M )rrrr r'rrs rCrz_OleObjectElementCreator._cyHsM < #<  .88I7-S-S dC!( ) ) )Y\]cYdYd rDc<|j|jntdS)aVertical size of enclosed EMF icon within the OLE graphic-frame. This must be specified when a custom icon is used, to avoid stretching of the image and possible undesired resizing by PowerPoint when the OLE shape is double-clicked to open it. The correct size can be determined by creating an example PPTX using PowerPoint and then inspecting the XML of the OLE graphics-frame (p:oleObj.imgH). Nr)rr'rs rCrz%_OleObjectElementCreator._icon_heightUs!)-(=(It$$sSY{{ZrDc@|j|jSt|jtr |jjnd}t jtd}t j t j |dd|S)zReference to image file containing icon to show in lieu of this object. This can be either a str path or a file-like object (io.BytesIO typically). Nzgeneric-icon.emfrz.. templates) rrrr icon_filenameospathsplit__file__abspathjoin)rAr_thisdirs rC_icon_image_filez)_OleObjectElementCreator._icon_image_fileas   *& & $+W55 $D  + +#  7==**1-wrw||HdKWWXXXrDrhcJ|j|j\}}|S)zHstr rId like "rId7" of rel to icon (image) representing OLE-object part.)rrr)rArrs rCrz"_OleObjectElementCreator._icon_rIdvs&!778MNN3 rDc<|j|jntdS)aWidth of enclosed EMF icon within the OLE graphic-frame. This must be specified when a custom icon is used, to avoid stretching of the image and possible undesired resizing by PowerPoint when the OLE shape is double-clicked to open it. Nr)rr'rs rCrz$_OleObjectElementCreator._icon_width|s!(,';'Gt##SQW[[XrDcL|j|j|jS)zstr rId like "rId6" of relationship to embedded ole_object part. This is where the ole_object part and its relationship to the slide are actually created. )radd_embedded_ole_object_partrrrs rCrz(_OleObjectElementCreator._ole_object_rIds* <<  t4   rDcL|j}t|tr|jn|S)zstr like "Excel.Sheet.12" identifying program used to open object. This value appears in the `progId` attribute of the `p:oleObj` element for the object. )rrr progId)rA prog_id_args rCrz _OleObjectElementCreator._progIds+ ' &0 W%E%EV{!!;VrDcd|jdz zS)zstr name like "Object 1" for the embedded ole_object shape. The name is formed from the prefix "Object " and the shape-id decremented by 1. z Object %dr)rrs rCrz$_OleObjectElementCreator._shape_names dnq011rDr2c|jjS)z SlidePart object for this slide.rrs rCrz$_OleObjectElementCreator._slide_partrrDN)rrrrFrrrrrr6rr6rrrrrrrrrr)rrrrFrrrrrr6rr6rrrrrrrrrrrGr)rGr)rGr6rrr)rrrrr>rrr(rrrrrrrrrrrrrDrCrrs,,,,4[:   \     \      \   [ [ [\ [YYY\Y(\ YYY\Y   \  W W W\ W222\2!!!\!!!rDr)rNr.r:r5rGr)rNr.r:r5)kr __future__rrrtypingrrrrrr pptx.enum.shapesr r pptx.mediar r pptx.opc.constantsrr= pptx.oxml.nsrpptx.oxml.shapes.autoshaperpptx.oxml.shapes.graphfrmrpptx.oxml.shapes.picturerpptx.oxml.simpletypesrpptx.shapes.autoshaperrpptx.shapes.baserpptx.shapes.connectorrpptx.shapes.freeformrpptx.shapes.graphfrmrpptx.shapes.grouprpptx.shapes.picturerrpptx.shapes.placeholderrrrr r!r"r#r$r% pptx.sharedr& pptx.utilr'r(pptx.chart.chartr)pptx.chart.datar*pptx.enum.chartr+r,r-pptx.oxml.shapesr.pptx.oxml.shapes.connectorr/pptx.oxml.shapes.groupshaper0pptx.parts.imager1pptx.parts.slider2 pptx.slider3r4 pptx.typesr5r6r8rrrr@rHrLrRrVr^rer+rrCrJrPrr<objectrrrrDrCrs@@"""""" HHHHHHHHHHHHHHHH4444444411111111111111//////======//////......66666666&&&&&&++++++000000------((((((........                      -,,,,,'''''''' !&&&&&&))))))------>>>>>>>>------777777999999************--------''''''      6R1R1R1R1R1&R1R1R1je e e e e {e e e P * * * * *" * * * n2n2n2n2n2"n2n2n2b 4 4 4 4 4; 4 4 4 4 4 4 4 4; 4 4 488888{8886 $ $ $ $ ${ $ $ $44444)444&SSSSS)SSS0 [ [ [ [ [/ [ [ [77777,777<(((((////////////****&////(((((f(((D~!~!~!~!~!v~!~!~!~!~!rD