li'dZddlmZddlmZmZmZddlmZddl m Z ddl m Z m Z ddlmZddlmZdd lmZdd lmZdd lmZdd lmZmZmZdd lmZerddlmZddlm Z ddlm!Z!GddeZ"GddeZ#GddeZ$y)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"eZdZUdZedZded<edZded<eded ed ed ed ed fZ d"dZ d#dZ d$dZ d%dZ d&dZ d'dZ d(dZd)dZedZedZd*dZdZd+dZed,dZed-dZd.dZed/dZed0dZed,d Zy!)1 CT_GroupShapezQUsed for shape tree (`p:spTree`) as well as the group shape (`p:grpSp`) elements.z p:nvGrpSpPrCT_GroupShapeNonVisual nvGrpSpPrz p:grpSpPrCT_GroupShapePropertiesgrpSpPrzp:spp:grpSpzp:graphicFramezp:cxnSpzp:picz p:contentPartc `tj|||||||}|j|d|S)zLReturn new `p:sp` appended to the group/shapetree with specified attributes.p:extLst)r new_autoshape_spinsert_element_before) selfid_nameprstxycxcysps Y/var/www/html/eduruby.in/venv/lib/python3.12/site-packages/pptx/oxml/shapes/groupshape.py add_autoshapezCT_GroupShape.add_autoshape+s5 & &sD$1b" E ""2z2 c tj|} tj||| |||||| } |j | d| S)zRReturn new `p:cxnSp` appended to the group/shapetree with the specified attribues.r)rto_xmlr new_cxnSpr!) r"r#r$ type_memberr&r'r(r)flipHflipVr%cxnSps r+ add_cxnSpzCT_GroupShape.add_cxnSp3sI"((5&&sD$1b"eUS ""5*5 r-c|j}d|dz fz}tj||||||}|j|d|S)z>Append 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_idr$r*s r+add_freeform_spzCT_GroupShape.add_freeform_spEsL&&1 .  % %haB C ""2z2 r-c|j}d|dz fz}tj||}|j|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 %dr7r)r8r new_grpSpr!)r"r:r$grpSps r+ add_grpSpzCT_GroupShape.add_grpSpMsF &&X\O+''$7 ""5*5 r-c btj||||||||} |j| d| S)zUAppend a `p:pic` shape to the group/shapetree having properties as specified in call.r)rnew_picr!) r"r#r$descrIdr&r'r(r)pics r+add_piczCT_GroupShape.add_picYs7  dD#q!RD ""3 3 r-c^tj||||||}|j|d|S)zPAppend a newly-created placeholder `p:sp` shape having the specified properties.r)r new_placeholder_spr!)r"r#r$ph_typeorientszidxr*s r+add_placeholderzCT_GroupShape.add_placeholderas3 ( (dGVR M ""2z2 r-c btj||||||||} |j| d| S)zHAppend a `p:graphicFrame` shape containing a table as specified in call.r)r new_table_graphicFramer!) r"r#r$rowscolsr&r'r(r) graphicFrames r+ add_tablezCT_GroupShape.add_tableis=/EE tT1aR  ""<<r-c^tj||||||}|j|d|S)zSAppend a newly-created textbox `p:sp` shape having the specified position and size.r)r new_textbox_spr!)r"r#r$r&r'r(r)r*s r+ add_textboxzCT_GroupShape.add_textboxss1  $ $S$1b" = ""2z2 r-cR|jjjS)z.Descendent `p:grpSpPr/a:xfrm/a:chExt` element.)rget_or_add_xfrmget_or_add_chExtr"s r+chExtzCT_GroupShape.chExty ||++->>@@r-cR|jjjS)z.Descendent `p:grpSpPr/a:xfrm/a:chOff` element.)rrWget_or_add_chOffrYs r+chOffzCT_GroupShape.chOff~r[r-c6|jjS)zCReturn the `a:xfrm` grandchild element, newly-added if not present.)rrWrYs r+rWzCT_GroupShape.get_or_add_xfrms||++--r-c#XK|jD]}|js|yw)z@Generate each placeholder shape child element in document order.N)iter_shape_elms has_ph_elm)r"es r+ iter_ph_elmszCT_GroupShape.iter_ph_elmss*%%' A|| s **c#pK|jD]}|j|jvs|!yw)zGenerate each child of this `p:spTree` element that corresponds to a shape. Items appear in XML document order. N) iterchildrentag _shape_tags)r"elms r+razCT_GroupShape.iter_shape_elmss7 $$& Cww$***  s,66c|jd}|Dcgc]}|jst| }}|r t|SdScc}w)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". //@idr)xpathisdigitintmax)r" id_str_lstid_strused_idss r+ max_shape_idzCT_GroupShape.max_shape_idsIZZ( .8MFFNN apr)r r)clsr#r$xmlr>s r+r=zCT_GroupShape.new_grpSps: #3S1 2$K!"# r-cT|jtdk(sy|j\}}}}|x|j_|_|x|j_|_|x|j _|_|x|j _|_|jjy)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) rgr _child_extentsr^r&r'rZr(r) getparentrecalculate_extents)r"r&r'r(r)s r+r}z!CT_GroupShape.recalculate_extentssxx2i=( ** 1b" !! tv !! tv"$$ "$$  ,,.r-c.|jjS)z7The `a:xfrm` grandchild element or |None| if not found.)rxfrmrYs r+rzCT_GroupShape.xfrms||   r-c(t|j}|s*tdtdtdtdfSt|Dcgc]}|jc}}t|Dcgc]}|j c}}t |Dcgc]}|j|jzc}}t |Dcgc]}|j |jzc}}|}|}||z } ||z } ||| | fScc}wcc}wcc}wcc}w)z(x, y, cx, cy) tuple representing net position and size. The values are formed as a composite of the contained child shapes. r) listrarminr&r'ror(r)) r"child_shape_elmsxSpmin_xmin_ymax_xmax_yr&r'r(r)s r+r{zCT_GroupShape._child_extentss   4 4 67q63q63q63q61 1&67sSUU78&67sSUU781AB#ceecffnBC1AB#ceecffnBC   U] U]!R|87BBsD2D D  Dc|jd}|Dcgc]}|jst| }}tdt |dzD] }||vs|cSycc}w)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". rkr7N)rlrmrnrangelen)r"rprqrrns r+r8zCT_GroupShape._next_shape_idsdZZ( .8MFFNNCFLOUX !,:DGMPWZ !),47rsgF"44/$/3=/4HH/-6a$aH%-% or-