o 7h'@sdZddlmZddlmZmZmZddlmZddl m Z ddl m Z m Z ddlmZddlmZdd lmZdd lmZdd lmZdd lmZmZmZdd lmZerhddlmZddlm Z ddlm!Z!GdddeZ"GdddeZ#GdddeZ$dS)z@lxml custom element classes for shape-tree-related XML elements.) annotations) TYPE_CHECKINGCallableIterator)MSO_CONNECTOR_TYPE) parse_xml)nsdeclsqn)CT_Shape) CT_Connector)CT_GraphicalObjectFrame) CT_Picture)BaseShapeElement)BaseOxmlElement OneAndOnlyOne ZeroOrOne)Emu)PP_PLACEHOLDER) ShapeElement)CT_Transform2Dc@s.eZdZUdZedZded<edZded<eded ed ed ed ed fZ dVddZ dWd!d"Z dXd#d$Z dYd%d&Z dZd*d+Zd[d1d2Zd\d6d7Zd]d8d9Zed:d;ZedAppend a new freeform `p:sp` with specified position and size.z Freeform %dr&)_next_shape_idr new_freeform_spr()r)r!r"r#r$shape_idrr*r+r+r,add_freeform_spEs  zCT_GroupShape.add_freeform_spcCs0|j}d|df}t||}||d|S)zReturn `p:grpSp` element newly appended to this shape tree. The element contains no sub-shapes, is positioned at (0, 0), and has width and height of zero. zGroup %dr5r&)r6r new_grpSpr()r)r8rgrpSpr+r+r, add_grpSpMs   zCT_GroupShape.add_grpSpdescrIdr c C(t||||||||} || d| S)zUAppend a `p:pic` shape to the group/shapetree having properties as specified in call.r&)r Znew_picr() r)rrr=r>r!r"r#r$picr+r+r,add_picYs zCT_GroupShape.add_picph_typerorientszidxcC$t||||||}||d|S)zPAppend a newly-created placeholder `p:sp` shape having the specified properties.r&)r new_placeholder_spr()r)rrrBrCrDrEr*r+r+r,add_placeholderas zCT_GroupShape.add_placeholderrowscolsr c Cr?)zHAppend a `p:graphicFrame` shape containing a table as specified in call.r&)r new_table_graphicFramer() r)rrrIrJr!r"r#r$ graphicFramer+r+r, add_tableis  zCT_GroupShape.add_tablecCrF)zSAppend a newly-created textbox `p:sp` shape having the specified position and size.r&)r new_textbox_spr()r)rrr!r"r#r$r*r+r+r, add_textboxss zCT_GroupShape.add_textboxcC|jS)z.Descendent `p:grpSpPr/a:xfrm/a:chExt` element.)rget_or_add_xfrmget_or_add_chExtr)r+r+r,chExtyzCT_GroupShape.chExtcCrP)z.Descendent `p:grpSpPr/a:xfrm/a:chOff` element.)rrQget_or_add_chOffrSr+r+r,chOff~rUzCT_GroupShape.chOffrcCs |jS)zCReturn the `a:xfrm` grandchild element, newly-added if not present.)rrQrSr+r+r,rQs zCT_GroupShape.get_or_add_xfrmccs |D]}|jr |VqdS)z@Generate each placeholder shape child element in document order.N)iter_shape_elms has_ph_elm)r)er+r+r, iter_ph_elmss  zCT_GroupShape.iter_ph_elmsIterator[ShapeElement]ccs&|D] }|j|jvr|VqdS)zGenerate each child of this `p:spTree` element that corresponds to a shape. Items appear in XML document order. N) iterchildrentag _shape_tags)r)elmr+r+r,rXs   zCT_GroupShape.iter_shape_elmscCs(|d}dd|D}|rt|SdS)aiMaximum int value assigned as @id in this slide. This is generally a shape-id, but ids can be assigned to other objects so we just check all @id values anywhere in the document (XML id-values have document scope). In practice, its minimum value is 1 because the spTree element itself is always assigned id="1". //@idcSg|] }|rt|qSr+isdigitr.0Zid_strr+r+r, z.CT_GroupShape.max_shape_id..r)xpathmax)r) id_str_lstused_idsr+r+r, max_shape_ids zCT_GroupShape.max_shape_idcCs$dtddd||f}t|}|S)z=Return new "loose" `p:grpSp` element having `id_` and `name`.a) apr)rr)clsrrxmlr;r+r+r,r:s zCT_GroupShape.new_grpSpNonecCsh|jtdks dS|j\}}}}||j_|_||j_|_||j_|_||j_|_| dS)aNAdjust x, y, cx, and cy to incorporate all contained shapes. This would typically be called when a contained shape is added, removed, or its position or size updated. This method is recursive "upwards" since a change in a group shape can change the position and size of its containing group. rN) r^r _child_extentsrWr!r"rTr#r$ getparentrecalculate_extents)r)r!r"r#r$r+r+r,rvs z!CT_GroupShape.recalculate_extentsCT_Transform2D | NonecCs|jjS)z7The `a:xfrm` grandchild element or |None| if not found.)rxfrmrSr+r+r,rxszCT_GroupShape.xfrmtuple[int, int, int, int]c Cst|}|stdtdtdtdfStdd|D}tdd|D}tdd|D}tdd|D}|}|}||}||} |||| fS)z(x, y, cx, cy) tuple representing net position and size. The values are formed as a composite of the contained child shapes. rcSg|]}|jqSr+)r!rfZxSpr+r+r,rgz0CT_GroupShape._child_extents..cSrzr+)r"r{r+r+r,rgr|cSg|]}|j|jqSr+)r!r#r{r+r+r,rgcSr}r+)r"r$r{r+r+r,rgr~)listrXrminrj) r)Zchild_shape_elmsZmin_xZmin_yZmax_xZmax_yr!r"r#r$r+r+r,rts  zCT_GroupShape._child_extentscCsD|d}dd|D}tdt|dD] }||vr|SqdS)aZReturn unique shape id suitable for use with a new shape element. The returned id is the next available positive integer drawing object id in shape tree, starting from 1 and making use of any gaps in numbering. In practice, the minimum id is 2 because the spTree element itself is always assigned id="1". racSrbr+rcrer+r+r,rgrhz0CT_GroupShape._next_shape_id..r5N)rirangelen)r)rkrlnr+r+r,r6s zCT_GroupShape._next_shape_idN)rrrrr rr!rr"rr#rr$rr%r )rrrrr.rr!rr"rr#rr$rr/r0r1r0r%r ) r!rr"rr#rr$rr%r )r%r)rrrrr=rr>rr!rr"rr#rr$rr%r )rrrrrBrrCrrDrrErr%r )rrrrrIrrJrr!rr"rr#rr$rr%r )rrrrr!rr"rr#rr$rr%r )r%r)r%r\)r%r)rrrrr%r)r%rs)r%rw)r%ry)__name__ __module__ __qualname____doc__rr__annotations__rr r_r-r4r9r<rArHrMrOpropertyrTrWrQr[rXrm classmethodr:rvrxrtr6r+r+r+r,rsR                  rc@seZdZdZedZdS)rz`p:nvGrpSpPr` element.zp:cNvPrN)rrrrrcNvPrr+r+r+r,rs rc@sPeZdZUdZded<dZededddZd ed <ed ed ddZ[dS) rzp:grpSpPr elementzCallable[[], CT_Transform2D]rQ) a:xfrmza:noFillz a:solidFillz a:gradFillz a:blipFillz a:pattFillz a:grpFill a:effectLstz a:effectDagz a:scene3dza:extLstrr5N) successorsrwrxr) rrrrr_tag_seqrrx effectLstr+r+r+r,rs  rN)%r __future__rtypingrrrpptx.enum.shapesr pptx.oxmlr pptx.oxml.nsrr pptx.oxml.shapes.autoshaper pptx.oxml.shapes.connectorr pptx.oxml.shapes.graphfrmr pptx.oxml.shapes.picturer pptx.oxml.shapes.sharedrpptx.oxml.xmlchemyrrr pptx.utilrrZpptx.oxml.shapesrrrrrr+r+r+r,s*            e