o 7h*@s\dZddlmZddlmZmZmZddlmZddl m Z ddl m Z ddlmZddlmZdd lmZmZmZdd lmZdd lmZdd lmZdd lmZmZmZm Z m!Z!ddl"m#Z#er|ddl$m%Z%ddl&m'Z'ddl(m)Z)ddl*m+Z+m,Z,GdddeZ-Gddde-Z.Gddde-Z/Gddde-Z0Gddde-Z1Gddde-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 ImagePartc@s<eZdZUdZded<ddd Zdd d ZedddZdS) 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 _elementrIdstrreturnrcCstd||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_partimageselfrr%X/var/www/html/figdemos/bartoux_crm/venv/lib/python3.10/site-packages/pptx/parts/slide.py get_image#szBaseSlidePart.get_image image_filestr | IO[bytes]cCs"|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_partrr%r%r&r++s z#BaseSlidePart.get_or_add_image_partcCs |jjjS)zInternal name of this slide.)rcSldnamer$r%r%r&r16s zBaseSlidePart.nameN)rrr r)r(r))r r) __name__ __module__ __qualname____doc____annotations__r'r+propertyr1r%r%r%r&rs    rc@s@eZdZdZeddZeddZeddZedd Z d S) NotesMasterPartz]Notes master part. Corresponds to package file `ppt/notesMasters/notesMaster1.xml`. cCs&||}||}||tj|S)zv Create and return a default notes master part, including creating the new theme it requires. )_new_new_theme_partr,r-THEME)clspackagenotes_master_partZ theme_partr%r%r&create_defaultBs  zNotesMasterPart.create_defaultcC t|j|S)zV Return the |NotesMaster| object that proxies this notes master part. )rrr2r%r%r& notes_masterM zNotesMasterPart.notes_mastercCsttdtj|tS)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)r9r CTPML_NOTES_MASTERr new_defaultr=r>r%r%r&r:Ts zNotesMasterPart._newcCst|dtj|tS)zCReturn new default theme-part suitable for use with a notes master.z/ppt/theme/theme%d.xml)r next_partnamerD OFC_THEMErrFrGr%r%r&r;as zNotesMasterPart._new_theme_partN) r3r4r5r6 classmethodr@rrBr:r;r%r%r%r&r9<s    r9c@s@eZdZdZeddZeddZeddZedd Z d S) 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`. cCs,|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_partr?_add_notes_slide_part notes_slideZclone_master_placeholdersrB)r=r> slide_partr?notes_slide_partrNr%r%r&newss  zNotesSlidePart.newcC|tj}|jS)z?Return the |NotesMaster| object this notes slide inherits from.)part_related_byr- NOTES_MASTERrB)r$r?r%r%r&rB zNotesSlidePart.notes_mastercCrA)zBReturn the |NotesSlide| object that proxies this notes slide part.)rrr2r%r%r&rNs zNotesSlidePart.notes_slidecCs:t|dtj|t}||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) rKrHrDPML_NOTES_SLIDEr rQr,r-rTSLIDE)r=r>rOr?rPr%r%r&rMsz$NotesSlidePart._add_notes_slide_partN) r3r4r5r6rJrQrrBrNrMr%r%r%r&rKls   rKc@seZdZdZeddZd&dd Zd'ddZd(ddZe ddZ e d)ddZ e ddZ e d*ddZe d+d!d"Zd#d$Zd%S), SlidePartzISlide part. Corresponds to package files ppt/slides/slide[1-9][0-9]*.xml.cCs&||tj|t}||tj|S)zReturn newly-created blank slide part. The new slide-part has `partname` and a relationship to `slide_layout_part`. )rD PML_SLIDEr rQr,r- SLIDE_LAYOUT)r=partnamer>slide_layout_partrOr%r%r&rQsz SlidePart.new chart_typer chart_datarcCs|t|||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`. )r,rrQr*r-CHART)r$r]r^r%r%r&add_chart_partszSlidePart.add_chart_partprog_id PROG_ID | strole_object_filer)cCs4t|trtjntj}|t||||j |S)zHReturn rId of newly-added OLE-object part formed from `ole_object_file`.) isinstancerr-PACKAGE OLE_OBJECTr,rfactory_blob_from_filer*)r$rarcZrelationship_typer%r%r&add_embedded_ole_object_partsz&SlidePart.add_embedded_ole_object_partvideorr tuple[str, str]cCs0|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_partr,r-MEDIAVIDEO)r$rj media_part media_rId video_rIdr%r%r&get_or_add_video_media_parts z%SlidePart.get_or_add_video_media_partcCs(z |tjWdStyYdSw)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)rSr- NOTES_SLIDEKeyErrorr2r%r%r&has_notes_slides  zSlidePart.has_notes_slidercCs4z |tj}W|jSty|}Y|jSw)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. )rSr-rsrtrMrNr$rPr%r%r&rNs zSlidePart.notes_slidecCrA)zB The |Slide| object representing this slide part. )rrr2r%r%r&sliderCzSlidePart.slideintcCs|jj}||S)zPReturn the slide identifier stored in the presentation part for this slide part.)r>rLslide_id)r$rLr%r%r&rys zSlidePart.slide_idrcCrR)zE|SlideLayout| object the slide in this part inherits appearance from.)rSr-rZ slide_layout)r$r\r%r%r&rzrUzSlidePart.slide_layoutcCs t|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. )rKrQr>r,r-rsrvr%r%r&rMszSlidePart._add_notes_slide_partN)r]rr^r)rarbrcr))rjrr rk)r r)r rx)r r)r3r4r5r6rJrQr`rirrr8rurrNrwryrzrMr%r%r%r&rXs$         rXc@s*eZdZdZeddZed ddZdS) SlideLayoutPartzjSlide layout part. Corresponds to package files ``ppt/slideLayouts/slideLayout[1-9][0-9]*.xml``. cCrA)zB The |SlideLayout| object representing this part. )rrr2r%r%r&rz rCzSlideLayoutPart.slide_layoutr rcCs|tjjS)z>Slide master from which this slide layout inherits properties.)rSr- SLIDE_MASTER slide_masterr2r%r%r&r}szSlideLayoutPart.slide_masterN)r r)r3r4r5r6rrzr8r}r%r%r%r&r{s  r{c@s&eZdZdZd ddZedd Zd S) SlideMasterPartzfSlide master part. Corresponds to package files ppt/slideMasters/slideMaster[1-9][0-9]*.xml. rrr rcCs ||jS)z?Return |SlideLayout| related to this slide-master by key `rId`.)r!rzr#r%r%r&related_slide_layout s z$SlideMasterPart.related_slide_layoutcCrA)zB The |SlideMaster| object representing this part. )rrr2r%r%r&r}$rCzSlideMasterPart.slide_masterN)rrr r)r3r4r5r6rrr}r%r%r%r&r~s  r~N)3r6 __future__rtypingrrrpptx.enum.shapesrpptx.opc.constantsrrDrr-pptx.opc.packager pptx.opc.packurir pptx.oxml.slider r r pptx.oxml.themerpptx.parts.chartrpptx.parts.embeddedpackager pptx.sliderrrrr pptx.utilrZpptx.chart.datarpptx.enum.chartrZ pptx.mediarpptx.parts.imagerrrr9rKrXr{r~r%r%r%r&s2             "02i