li9 d Z ddlmZ ddlmZmZmZ ddlmZm Z ddl
m Z ddl m
Z
ddlmZ ddlmZmZmZmZ dd lmZ dd
lmZmZmZmZm Z m Z erdd lm Z m Z m Z dd l!m"Z" G d
de Z# G d de Z$ G d de Z% G d de Z& G d de Z' G d de Z( G d de Z) G d d e Z* G d d e Z+ G d d e Z, G d! d"e Z- G d# d$e Z. G d% d&e Z/y')(z;lxml custom element classes for shape-related XML elements. ) annotations)
TYPE_CHECKINGCallablecast)MSO_AUTO_SHAPE_TYPEPP_PLACEHOLDER) parse_xmlnsdecls)BaseShapeElement)
ST_CoordinateST_PositiveCoordinate
XsdBoolean XsdString) CT_TextBody)BaseOxmlElement
OneAndOnlyOneOptionalAttributeRequiredAttribute
ZeroOrMore ZeroOrOne)#CT_ApplicationNonVisualDrawingPropsCT_NonVisualDrawingPropsCT_ShapeProperties)Lengthc J e Zd ZU dZ ede Zded< ede Zded< y)
CT_AdjPoint2Dz `a:pt` custom element class.xr yN) __name__
__module__ __qualname____doc__r r
r __annotations__r X/var/www/html/eduruby.in/venv/lib/python3.12/site-packages/pptx/oxml/shapes/autoshape.pyr r & s' &!#}5Av5!#}5Av5r& r c D e Zd ZU dZded< dZ ededd Zd ed
< y) CT_CustomGeometry2Dz"`a:custGeom` custom element class.zCallable[[], CT_Path2DList]get_or_add_pathLst)a:avLstza:gdLstza:ahLstza:cxnLstza:rect a:pathLstr, N
successorszCT_Path2DList | NonepathLst)r r! r" r# r$ _tag_seqr r0 r% r& r' r) r) - s- ,33SH$- %G
! r& r) c J e Zd ZU dZ ede Zded< ede Zded< y) CT_GeomGuidezz`a:gd` custom element class.
Defines a "guide", corresponding to a yellow diamond-shaped handle on an autoshape.
namestrfmlaN) r r! r" r# r r r4 r$ r6 r% r& r' r3 r3 8 s+
"&)4D#4!&)4D#4r& r3 c 6 e Zd ZU dZded< ded< ed Zy)CT_GeomGuideListz `a:avLst` custom element class.zCallable[[], CT_GeomGuide]_add_gdlist[CT_GeomGuide]gd_lstza:gdN)r r! r" r# r$ r gdr% r& r' r8 r8 B s )
'' F Br& r8 c > e Zd ZU dZ ed Z ede Zde d< y) CT_NonVisualDrawingShapePropsz!`p:cNvSpPr` custom element class.z a:spLockstxBoxz bool | NoneN)
r r! r" r# r spLocksr r r? r$ r% r& r' r> r> L s% + $G*E; r& r> c e Zd ZU dZded< ded< ded< edd
Z ed d
Z ed d
Z e d
e
Z ded
< e de
Z ded< ddZ
ddZddZy) CT_Path2Dz `a:path` custom element class.z Callable[[], CT_Path2DClose]
_add_closez Callable[[], CT_Path2DLineTo] _add_lnToz Callable[[], CT_Path2DMoveTo] _add_moveToza:closer% r. za:lnToza:moveTowz
Length | Nonehc " | j S )z{Return a newly created `a:close` element.
The new `a:close` element is appended to this `a:path` element.
)rC selfs r' add_closezCT_Path2D.add_closef s
r& c d | j }|j }||c|_ |_ |S )zReturn a newly created `a:lnTo` subtree with end point *(x, y)*.
The new `a:lnTo` element is appended to this `a:path` element.
)rD _add_ptr r )rJ r r lnTopts r' add_lnTozCT_Path2D.add_lnTom s/
~~
\\^
bd r& c d | j }|j }||c|_ |_ |S )zReturn a newly created `a:moveTo` subtree with point `(x, y)`.
The new `a:moveTo` element is appended to this `a:path` element.
)rE rM r r )rJ r r moveTorO s r'
add_moveTozCT_Path2D.add_moveTow s2
!!#
^^
bd
r& N)returnCT_Path2DClose)r r r r rT CT_Path2DLineTo)r r r r )r r! r" r# r$ r closerN rR r r rF rG rK rP rS r% r& r' rB rB U sz (,,,,.. yR 0E h2 .D
r
2F(
"A} )
"A} !r& rB c e Zd ZdZy)rU z `a:close` custom element class.N)r r! r" r# r% r& r' rU rU s )r& rU c 0 e Zd ZU dZded< edd Zy)rV z `a:lnTo` custom element class.Callable[[], CT_AdjPoint2D]rM a:ptr% r. Nr r! r" r# r$ r rO r% r& r' rV rV s (
(( 6b )Br& rV c 8 e Zd ZU dZded< edd Zd dZy)
CT_Path2DListz!`a:pathLst` custom element class.zCallable[[], CT_Path2D] _add_pathza:pathr% r. c D | j }||c|_ |_ |S )z.Return a newly created `a:path` child element.)r_ rF rG )rJ rF rG paths r' add_pathzCT_Path2DList.add_path s" ~~ A r& N)rF r rG r )r r! r" r# r$ r ra rb r% r& r' r^ r^ s +&& h2 .Dr& r^ c 0 e Zd ZU dZded< edd Zy)CT_Path2DMoveToz `a:moveTo` custom element class.rZ rM r[ r% r. Nr\ r% r& r' rd rd s *
(( 6b )Br& rd c v e Zd ZU dZded< ded< ed Zded< ed e Z d
ed < e
dd Z dd Z y
)CT_PresetGeometry2Dz"`a:prstGeom` custom element class.z Callable[[], CT_GeomGuideList]
_add_avLstzCallable[[], None]
_remove_avLstr+ zCT_GeomGuideList | NoneavLstprstr c : | j }|g S |j S )zLSequence of `a:gd` element children of `a:avLst`. Empty if none are present.)ri r; )rJ ri s r' r; zCT_PresetGeometry2D.gd_lst s!
=I||r& c | j | j }|D ]& \ }}|j }||_ d|z |_ ( y)zOReplace any `a:gd` element children of `a:avLst` with ones forme from `guides`.zval %dN)rh rg r9 r4 r6 )rJ guidesri r4 valr< s r' rewrite_guidesz"CT_PresetGeometry2D.rewrite_guides sJ ! %ID# BBG nBG %r& N)rT r: )rm zlist[tuple[str, int]])
r r! r" r# r$ r ri r r rj propertyr; ro r% r& r' rf rf sR ,..%%%.y%9E "9 1#!D
%r& rf c n e Zd ZU dZded< ed Zded< ed Zded < ed
d Z d
ed< d dZ
d Z e d Z
e d Ze d Ze d Ze d d Zed d Ze d!d Zed Ze d Ze d"d Zd Zed Zy )#CT_Shapez `p:sp` custom element class.zCallable[[], CT_TextBody]get_or_add_txBodyzp:nvSpPrCT_ShapeNonVisualnvSpPrzp:spPrr spPrzp:txBody)zp:extLstr. zCT_TextBody | NonetxBodyc | j j }| t d |j }|j || S )Nzshape must be freeform)rF rG )rv custGeom
ValueErrorr* rb )rJ rF rG ry r0 s r' rb zCT_Shape.add_path sG 99%% 56 6--/ !q ))r& c 6 | j j S )zAReturn the `a:ln` grandchild element, newly added if not present.)rv
get_or_add_lnrI s r' r| zCT_Shape.get_or_add_ln s yy&&((r& c 2 | j j duS )zTrue if this shape has custom geometry, i.e. is a freeform shape.
A shape has custom geometry if it has a `p:spPr/a:custGeom`
descendant (instead of `p:spPr/a:prstGeom`).
N)rv ry rI s r' has_custom_geometryz CT_Shape.has_custom_geometry s yy!!--r& c d | j }|y| j j j duS )zTrue if this shape is an auto shape.
A shape is an auto shape if it has a `a:prstGeom` element and does not have a txBox="1"
attribute on cNvSpPr.
FT)prstGeomru cNvSpPrr? rJ r s r' is_autoshapezCT_Shape.is_autoshape s1 == {{""((44r& c F | j j j du S )zTrue if this shape is a text box.
A shape is a text box if it has a `txBox` attribute on cNvSpPr that resolves to |True|.
The default when the txBox attribute is missing is |False|.
T)ru r r? rI s r'
is_textboxzCT_Shape.is_textbox s {{""((D00r& c . | j j S )z4`a:ln` grand-child element or |None| if not present.)rv lnrI s r' r z CT_Shape.ln s yy||r& c dt dd ddddddd dd
dd dd dd
| ||||||fz }t t t | S )zAReturn a new `p:sp` element tree configured as a base auto shape.
r r rr r )id_r4 rj lefttopwidthheightxmls r' new_autoshape_spzCT_Shape.new_autoshape_sp sV T !c*D$dD$PTI$
VJ $c5&$ 7M&8N Hin--r& c dt dd ddddddd dd
dd dd | |||||fz }t t t | S )
zReturn new `p:sp` element tree configured as freeform shape.
The returned shape has a `a:custGeom` subtree but no paths in its
path list.
r r r r r r r r r r r a "/>
r )shape_idr4 r r cxcyr s r' new_freeform_spzCT_Shape.new_freeform_sp& sQ b !c*D$dD$S)
PT tQ2r *W++X Hin--r& c t t t dt dd d| d| d }|j j
j
}||_ ||_ ||_ ||_
t j t j t j t j t j f}||v r#|j# t% j& |S )zCReturn a new `p:sp` element tree configured as a placeholder shape.r r r r r zq"/>
)r rr r r ru nvPr
get_or_add_phtypeidxorientszr TITLE CENTER_TITLESUBTITLEBODYOBJECTappendr new) r r4 ph_typer r r spph(placeholder_types_that_have_a_text_frames r' new_placeholder_spzCT_Shape.new_placeholder_sp[ s
c*+ ,$$'5 7
YY^^
)
)
+
' ' # # ! ! 4
0 > > IIkoo' ( r& c Z t j }|| |||||fz }t | }|S )zDReturn a new `p:sp` element tree configured as a base textbox shape.)rr _textbox_sp_tmplr ) r r4 r r r r tmplr r s r' new_textbox_spzCT_Shape.new_textbox_sp s7 ((*c4sE6::
s^ r& c 8 | j }|y|j S )zKValue of `prst` attribute of `a:prstGeom` element or |None| if not present.N)r rj r s r' rj z
CT_Shape.prst s == }} r& c . | j j S )zReference to `a:prstGeom` child element.
|None| if this shape doesn't have one, for example, if it's a placeholder shape.
)rv r rI s r' r zCT_Shape.prstGeom s yy!!!r& c * t j S )N)r new_p_txBodyrI s r' _new_txBodyzCT_Shape._new_txBody s ''))r& c F dt dd ddddddd dd
dd dd S )
Nr r r r r r r zc"/>
r
r% r& r' r zCT_Shape._textbox_sp_tmpl s% 4 !c*D$dD$/
P
r& N)rF r rG r rT rB )r intr4 r5 rj r5 r r r r r r r r rT rr ) r r r4 r5 r r r r r r r r )
r r r4 r5 r r r r5 rT rr )rT rf )r r! r" r# r$ r ru rv r rw rb r| rp r~ r r r staticmethodr r r r rj r r r r% r& r' rr rr s &00 -j 9F 9 ,X 6D
6!*:-!PF P*) . . 5 5 1 1 +.
+.+.#&+..1+.8;+.DG+.QT+. +. +.Z 2. 2.h %
%%&4%>A% % %N " "*
r& rr c ` e Zd ZU dZ ed Zded< ed Zded< ed Zd ed
< y ) rt z `p:nvSpPr` custom element class.zp:cNvPrr cNvPrz p:cNvSpPrr> r zp:nvPrr r N) r r! r" r# r r r$ r r r% r& r' rt rt sH *&3'E # .;.G
* h
- r& rt N)0r#
__future__r typingr r r pptx.enum.shapesr r pptx.oxmlr pptx.oxml.nsr pptx.oxml.shapes.sharedr pptx.oxml.simpletypesr
r r r pptx.oxml.textr pptx.oxml.xmlchemyr r r r r r r r r pptx.utilr r r) r3 r8 r> rB rU rV r^ rd rf rr rt r% r& r' r s B " 0 0 @ 4 '
!6O 6/ 5? 5 $4 * *Z*_ **o * O *o *%/ %:x
x
v ( r&