hi*dZddlmZddlmZmZmZddlmZddl m Z ddl m Z ddlmZddlmZdd lmZmZmZdd lmZdd lmZdd lmZdd lmZmZmZm Z m!Z!ddl"m#Z#erddl$m%Z%ddl&m'Z'ddl(m)Z)ddl*m+Z+m,Z,GddeZ-Gdde-Z.Gdde-Z/Gdde-Z0Gdde-Z1Gdde-Z2dS) zSlide and related objects.) annotations)IO TYPE_CHECKINGcast)PROG_ID) CONTENT_TYPE)RELATIONSHIP_TYPE)XmlPart)PackURI)CT_NotesMaster CT_NotesSlideCT_Slide)CT_OfficeStyleSheet) ChartPart)EmbeddedPackagePart) NotesMaster NotesSlideSlide SlideLayout SlideMaster) lazyproperty) ChartData) XL_CHART_TYPE)Video)Image ImagePartcFeZdZUdZded<ddZdd Zedd Zd S) BaseSlidePartzBase class for slide parts. This includes slide, slide-layout, and slide-master parts, but also notes-slide, notes-master, and handout-master parts. r_elementrIdstrreturnrcRtd||jS)zReturn an |Image| object containing the image related to this slide by *rId*. Raises |KeyError| if no image is related by that id, which would generally indicate a corrupted .pptx file. r)r related_partimageselfr s h/var/www/development/aibuddy-work/election-extract/venv/lib/python3.11/site-packages/pptx/parts/slide.py get_imagezBaseSlidePart.get_image#s% K!2!23!7!788>> image_filestr | IO[bytes]c~|j|}||tj}||fS)a@Return `(image_part, rId)` pair corresponding to `image_file`. The returned |ImagePart| object contains the image in `image_file` and is related to this slide with the key `rId`. If either the image part or relationship already exists, they are reused, otherwise they are newly created. )_packageget_or_add_image_part relate_toRTIMAGE)r'r+ image_partr s r(r/z#BaseSlidePart.get_or_add_image_part+s8]88DD nnZ223r*c$|jjjS)zInternal name of this slide.)rcSldnamer's r(r6zBaseSlidePart.name6s}!&&r*N)r r!r"r)r+r,)r"r!) __name__ __module__ __qualname____doc____annotations__r)r/propertyr6r*r(rrsv ????    '''X'''r*rcjeZdZdZedZedZedZedZ dS)NotesMasterPartz]Notes master part. Corresponds to package file `ppt/notesMasters/notesMaster1.xml`. c||}||}||tj|S)zv Create and return a default notes master part, including creating the new theme it requires. )_new_new_theme_partr0r1THEME)clspackagenotes_master_part theme_parts r(create_defaultzNotesMasterPart.create_defaultBsG  HHW--((11 ##J999  r*c,t|j|S)zV Return the |NotesMaster| object that proxies this notes master part. )rrr7s r( notes_masterzNotesMasterPart.notes_masterM 4=$///r*cvttdtj|t jS)z Create and return a standalone, default notes master part based on the built-in template (without any related parts, such as theme). z"/ppt/notesMasters/notesMaster1.xml)r@r CTPML_NOTES_MASTERr new_defaultrErFs r(rBzNotesMasterPart._newTs7  8 9 9     & ( (    r*ct|dtj|t jS)zCReturn new default theme-part suitable for use with a notes master.z/ppt/theme/theme%d.xml)r next_partnamerN OFC_THEMErrPrQs r(rCzNotesMasterPart._new_theme_partas<  ! !": ; ; L   + - -    r*N) r8r9r:r; classmethodrIrrKrBrCr>r*r(r@r@<s !![!00\0    [    [   r*r@cjeZdZdZedZedZedZedZ dS)NotesSlidePartzNotes slide part. Contains the slide notes content and the layout for the slide handout page. Corresponds to package file `ppt/notesSlides/notesSlide[1-9][0-9]*.xml`. c|jj}||||}|j}||j|S)a'Return new |NotesSlidePart| for the slide in `slide_part`. The new notes-slide part is based on the (singleton) notes master and related to both the notes-master part and `slide_part`. If no notes-master is present, one is created based on the default template. )presentation_partrG_add_notes_slide_part notes_slideclone_master_placeholdersrK)rErF slide_partrGnotes_slide_partr[s r(newzNotesSlidePart.newssO$5G44WjJ[\\&2 --.?.LMMMr*cN|tj}|jS)z?Return the |NotesMaster| object this notes slide inherits from.)part_related_byr1 NOTES_MASTERrK)r'rGs r(rKzNotesSlidePart.notes_master#!00AA --r*c,t|j|S)zBReturn the |NotesSlide| object that proxies this notes slide part.)rrr7s r(r[zNotesSlidePart.notes_slides$-...r*ct|dtj|t j}||tj||tj |S)zCreate and return a new notes-slide part. The return part is fully related, but has no shape content (i.e. placeholders not cloned). z!/ppt/notesSlides/notesSlide%d.xml) rWrSrNPML_NOTES_SLIDEr r_r0r1rbSLIDE)rErFr]rGr^s r(rZz$NotesSlidePart._add_notes_slide_partst*  ! !"E F F           ""#4boFFF"":rx888r*N) r8r9r:r;rUr_rrKr[rZr>r*r(rWrWls    [  ..\. //\/  [   r*rWceZdZdZedZddZdd ZddZe dZ e ddZ e dZ e d dZe d!dZdZdS)" SlidePartzISlide part. Corresponds to package files ppt/slides/slide[1-9][0-9]*.xml.c||tj|tj}||t j|S)zReturn newly-created blank slide part. The new slide-part has `partname` and a relationship to `slide_layout_part`. )rN PML_SLIDErr_r0r1 SLIDE_LAYOUT)rEpartnamerFslide_layout_partr]s r(r_z SlidePart.news@ S2<(,..II .@@@r* chart_typer chart_datarct|tj|||jtjS)zReturn str rId of new |ChartPart| object containing chart of `chart_type`. The chart depicts `chart_data` and is related to the slide contained in this part by `rId`. )r0rr_r.r1CHART)r'rorps r(add_chart_partzSlidePart.add_chart_parts, ~~imJ DMRRTVT\]]]r*prog_id PROG_ID | strole_object_filer,ct|tr tjn tj}|t j||||j |S)zHReturn rId of newly-added OLE-object part formed from `ole_object_file`.) isinstancerr1PACKAGE OLE_OBJECTr0rfactory_blob_from_filer.)r'rtrvrelationship_types r(add_embedded_ole_object_partz&SlidePart.add_embedded_ole_object_partsc+5Wg*F*FYBJJBM~~  '--o>>        r*videorr"tuple[str, str]c|j|}||tj}||tj}||fS)aReturn rIds for media and video relationships to media part. A new |MediaPart| object is created if it does not already exist (such as would occur if the same video appeared more than once in a presentation). Two relationships to the media part are created, one each with MEDIA and VIDEO relationship types. The need for two appears to be for legacy support for an earlier (pre-Office 2010) PowerPoint media embedding strategy. )r.get_or_add_media_partr0r1MEDIAVIDEO)r'r media_part media_rId video_rIds r(get_or_add_video_media_partz%SlidePart.get_or_add_video_media_partsN]88?? NN:rx88 NN:rx88 )##r*cj |tjn#t$rYdSwxYwdS)a Return True if this slide has a notes slide, False otherwise. A notes slide is created by the :attr:`notes_slide` property when one doesn't exist; use this property to test for a notes slide without the possible side-effect of creating one. FT)rar1 NOTES_SLIDEKeyErrorr7s r(has_notes_slidezSlidePart.has_notes_slidesG    0 0 0 0   55 ts " 00rc |tj}n$#t$r|}YnwxYw|jS)zThe |NotesSlide| instance associated with this slide. If the slide does not have a notes slide, a new one is created. The same single instance is returned on each call. )rar1rrrZr[r'r^s r(r[zSlidePart.notes_slides\ <#33BNCC   < < <#99;;    <++s"AAc,t|j|S)zB The |Slide| object representing this slide part. )rrr7s r(slidezSlidePart.slides T]D)))r*intcD|jj}||S)zPReturn the slide identifier stored in the presentation part for this slide part.)rFrYslide_id)r'rYs r(rzSlidePart.slide_ids#!L: ))$///r*rcN|tj}|jS)zE|SlideLayout| object the slide in this part inherits appearance from.)rar1rl slide_layout)r'rns r(rzSlidePart.slide_layoutrcr*ct|j|}||tj|S)z Return a newly created |NotesSlidePart| object related to this slide part. Caller is responsible for ensuring this slide doesn't already have a notes slide part. )rWr_rFr0r1rrs r(rZzSlidePart._add_notes_slide_parts9 *--dlDAA '888r*N)rorrpr)rtrurvr,)rrr"r)r"r)r"r)r"r)r8r9r:r;rUr_rsr~rr=rrr[rrrrZr>r*r(ririsSS[^^^^      $ $ $ $  X  , , ,\ ,**\* 000X0 ...X.      r*ric@eZdZdZedZeddZdS)SlideLayoutPartzjSlide layout part. Corresponds to package files ``ppt/slideLayouts/slideLayout[1-9][0-9]*.xml``. c,t|j|S)zB The |SlideLayout| object representing this part. )rrr7s r(rzSlideLayoutPart.slide_layout rLr*r"rcJ|tjjS)z>Slide master from which this slide layout inherits properties.)rar1 SLIDE_MASTER slide_masterr7s r(rzSlideLayoutPart.slide_masters##BO44AAr*N)r"r)r8r9r:r;rrr=rr>r*r(rrs_ 00\0 BBBXBBBr*rc0eZdZdZd dZedZdS) SlideMasterPartzfSlide master part. Corresponds to package files ppt/slideMasters/slideMaster[1-9][0-9]*.xml. r r!r"rc6||jS)z?Return |SlideLayout| related to this slide-master by key `rId`.)r$rr&s r(related_slide_layoutz$SlideMasterPart.related_slide_layout s  %%22r*c,t|j|S)zB The |SlideMaster| object representing this part. )rrr7s r(rzSlideMasterPart.slide_master$rLr*N)r r!r"r)r8r9r:r;rrrr>r*r(rrsM 333300\000r*rN)3r; __future__rtypingrrrpptx.enum.shapesrpptx.opc.constantsrrNr r1pptx.opc.packager pptx.opc.packurir pptx.oxml.slider r rpptx.oxml.themerpptx.parts.chartrpptx.parts.embeddedpackager pptx.sliderrrrr pptx.utilrpptx.chart.datarpptx.enum.chartr pptx.mediarpptx.parts.imagerrrr@rWrirrr>r*r(rs """"""**********$$$$$$111111666666$$$$$$$$$$$$CCCCCCCCCC//////&&&&&&::::::OOOOOOOOOOOOOO""""""2))))))------      11111111'''''G'''D- - - - - m- - - `/ / / / / ]/ / / df f f f f f f f RBBBBBmBBB&00000m00000r*