*h9 S r SSKJr SSKJrJrJr SSKJrJ r SSK
J r SSK J
r
SSKJr SSKJrJrJrJr SS KJr SS
KJrJrJrJrJ r J r \( a SS KJ r J r J r SS K!J"r" " S
S\5 r# " S S\5 r$ " S S\5 r% " S S\5 r& " S S\5 r' " S S\5 r( " S S\5 r) " S S \5 r* " S S \5 r+ " S S \5 r, " S! S"\5 r- " S# S$\5 r. " S% S&\5 r/g')(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 R \ rS rSr% Sr\" S\5 rS\S' \" S\5 r S\S' Sr
g)
CT_AdjPoint2D& z `a:pt` custom element class.xr y N) __name__
__module__ __qualname____firstlineno____doc__r r
r __annotations__r __static_attributes__r! W/home/mande/repo/quber/.venv/lib/python3.13/site-packages/pptx/oxml/shapes/autoshape.pyr r & s' &!#}5Av5!#}5Av5r) r c F \ rS rSr% SrS\S' Sr\" S\SS S 9rS
\S ' S r g)
CT_CustomGeometry2D- z"`a:custGeom` custom element class.zCallable[[], CT_Path2DList]get_or_add_pathLst)a:avLstza:gdLstza:ahLstza:cxnLstza:rect a:pathLstr0 N
successorszCT_Path2DList | NonepathLstr! )
r" r# r$ r% r& r' _tag_seqr r4 r( r! r) r* r, r, - s- ,33SH$- %G
! r) r, c R \ rS rSr% Sr\" S\5 rS\S' \" S\5 r S\S' Sr
g) CT_GeomGuide8 zr`a:gd` custom element class.
Defines a "guide", corresponding to a yellow diamond-shaped handle on an autoshape.
namestrfmlar! N) r" r# r$ r% r& r r r9 r' r; r( r! r) r* r7 r7 8 s+
"&)4D#4!&)4D#4r) r7 c > \ rS rSr% SrS\S' S\S' \" S5 rSrg )
CT_GeomGuideListB z `a:avLst` custom element class.zCallable[[], CT_GeomGuide]_add_gdlist[CT_GeomGuide]gd_lstza:gdr! N) r" r# r$ r% r& r' r gdr( r! r) r* r= r= B s )
'' F Br) r= c F \ rS rSr% Sr\" S5 r\" S\5 r S\
S' Sr g) CT_NonVisualDrawingShapePropsL z!`p:cNvSpPr` custom element class.z a:spLockstxBoxz bool | Noner! N) r" r# r$ r% r& r spLocksr r rF r' r( r! r) r* rD rD L s% + $G*E; r) rD c \ rS rSr% SrS\S' S\S' S\S' \" S S
S 9r\" S S
S 9r\" S
S
S 9r \
" S\ 5 r S\S' \
" S\ 5 r
S\S' SS jrSS jrSS jrS
rg) CT_Path2DU z `a:path` custom element class.z Callable[[], CT_Path2DClose]
_add_closez Callable[[], CT_Path2DLineTo] _add_lnToz Callable[[], CT_Path2DMoveTo] _add_moveToza:closer! r2 za:lnToza:moveTowz
Length | Nonehc " U R 5 $ )zkReturn a newly created `a:close` element.
The new `a:close` element is appended to this `a:path` element.
)rK selfs r* add_closeCT_Path2D.add_closef s
r) c b U R 5 nUR 5 nXsUl Ul U$ )zReturn a newly created `a:lnTo` subtree with end point *(x, y)*.
The new `a:lnTo` element is appended to this `a:path` element.
)rL _add_ptr r )rR r r lnTopts r* add_lnToCT_Path2D.add_lnTom s-
~~
\\^
bd r) c b U R 5 nUR 5 nXsUl Ul U$ )zReturn a newly created `a:moveTo` subtree with point `(x, y)`.
The new `a:moveTo` element is appended to this `a:path` element.
)rM rV r r )rR r r moveTorX s r*
add_moveToCT_Path2D.add_moveTow s0
!!#
^^
bd
r) N)returnCT_Path2DClose)r r r r r_ CT_Path2DLineTo)r r r r )r" r# r$ r% r& r' r closerW r\ r r rN rO rS rY r] r( r! r) r* rI rI U sz (,,,,.. yR 0E h2 .D
r
2F(
"A} )
"A} !r) rI c \ rS rSrSrSrg)r` z `a:close` custom element class.r! N)r" r# r$ r% r& r( r! r) r* r` r` s )r) r` c 2 \ rS rSr% SrS\S' \" SSS9rSrg) ra z `a:lnTo` custom element class.Callable[[], CT_AdjPoint2D]rV a:ptr! r2 N r" r# r$ r% r& r' r rX r( r! r) r* ra ra s (
(( 6b )Br) ra c < \ rS rSr% SrS\S' \" SSS9rS
S jrSr g )
CT_Path2DList z!`a:pathLst` custom element class.zCallable[[], CT_Path2D] _add_pathza:pathr! r2 c B U R 5 nXsUl Ul U$ )z.Return a newly created `a:path` child element.)rm rN rO )rR rN rO paths r* add_pathCT_Path2DList.add_path s ~~ r) N)rN r rO r )
r" r# r$ r% r& r' r ro rp r( r! r) r* rk rk s +&& h2 .Dr) rk c 2 \ rS rSr% SrS\S' \" SSS9rSrg) CT_Path2DMoveTo z `a:moveTo` custom element class.rg rV rh r! r2 Nri r! r) r* rs rs s *
(( 6b )Br) rs c \ rS rSr% SrS\S' S\S' \" S5 rS\S ' \" S
\ 5 r
S \S
' \ SS j5 r SS
jr
Srg)CT_PresetGeometry2D z"`a:prstGeom` custom element class.z Callable[[], CT_GeomGuideList]
_add_avLstzCallable[[], None]
_remove_avLstr/ zCT_GeomGuideList | NoneavLstprstr c < U R nUc / $ UR $ )zLSequence of `a:gd` element children of `a:avLst`. Empty if none are present.)rz rA )rR rz s r* rA CT_PresetGeometry2D.gd_lst s!
=I||r) c U R 5 U R 5 nU H% u p4UR 5 nX5l SU- Ul M' g)zOReplace any `a:gd` element children of `a:avLst` with ones forme from `guides`.zval %dN)ry rx r? r9 r; )rR guidesrz r9 valrB s r* rewrite_guides"CT_PresetGeometry2D.rewrite_guides sA ! ID BG nBG r) r! N)r_ r@ )r zlist[tuple[str, int]])r" r# r$ r% r& r' r rz r r r{ propertyrA r r( r! r) r* rv rv sR ,..%%%.y%9E "9 1#!D
%r) rv c z \ rS rSr% SrS\S' \" S5 rS\S' \" S5 rS \S
' \ " S S S
9r
S\S' S S jr S r \
S 5 r\
S 5 r\
S 5 r\
S 5 r\ S!S j5 r\S"S j5 r\ S#S j5 r\S 5 r\
S 5 r\
S$S j5 rS r\S 5 rS rg )%CT_Shape z `p:sp` custom element class.zCallable[[], CT_TextBody]get_or_add_txBodyzp:nvSpPrCT_ShapeNonVisualnvSpPrzp:spPrr spPrzp:txBody)zp:extLstr2 zCT_TextBody | NonetxBodyc U R R nUc [ S5 eUR 5 nUR XS9$ )Nzshape must be freeform)rN rO )r custGeom
ValueErrorr. rp )rR rN rO r r4 s r* rp CT_Shape.add_path sE 99%% 56 6--/ ! ))r) c 6 U R R 5 $ )zAReturn the `a:ln` grandchild element, newly added if not present.)r
get_or_add_lnrQ s r* r CT_Shape.get_or_add_ln s yy&&((r) c 2 U R R SL$ )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)r r rQ s r* has_custom_geometry CT_Shape.has_custom_geometry s yy!!--r) c f U R nUc gU R R R SL$ )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)prstGeomr cNvSpPrrF rR r s r* is_autoshapeCT_Shape.is_autoshape s1 == {{""((44r) c F U R R R SL $ )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)r r rF rQ s r*
is_textboxCT_Shape.is_textbox s {{""((D00r) c . U R R $ )z4`a:ln` grand-child element or |None| if not present.)r lnrQ s r* r CT_Shape.ln s yy||r) c S[ SS5 < SS< SS< SS< S S< S
S< S S< S S< S
3XX4XVU4- n[ [ [ U5 5 $ )zAReturn a new `p:sp` element tree configured as a base auto shape.
r r r r )id_r9 r{ lefttopwidthheightxmls r* new_autoshape_spCT_Shape.new_autoshape_sp sP T !c*D$dD$PTI$
VJ 5$ 7M&8N Hin--r) c S[ SS5 < SS< SS< SS< S S< S
S< S S< S 3XX#XE4- n[ [ [ U5 5 $ )
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_idr9 r r cxcyr s r* new_freeform_spCT_Shape.new_freeform_sp& sK b !c*D$dD$S)
PT Q2 *W++X Hin--r) c [ [ [ S[ SS5 SU SU S35 5 nUR R
R
5 nX'l XWl X7l XGl
[ R [ R [ R [ R [ R 4nX(; a$ UR# [$ R& " 5 5 U$ )zCReturn a new `p:sp` element tree configured as a placeholder shape.r r r r r zq"/>
)r r r r r nvPr
get_or_add_phtypeidxorientszr TITLE CENTER_TITLESUBTITLEBODYOBJECTappendr new) r r9 ph_typer r r spph(placeholder_types_that_have_a_text_frames r* new_placeholder_spCT_Shape.new_placeholder_sp[ s
c*+ ,$$'5 7
YY^^
)
)
+
' ' # # ! ! 4
0 > IIkoo' ( r) c T [ R 5 nX`XX4U4- n[ U5 nU$ )zDReturn a new `p:sp` element tree configured as a base textbox shape.)r _textbox_sp_tmplr ) r r9 r r r r tmplr r s r* new_textbox_spCT_Shape.new_textbox_sp s1 ((*4s6::
s^ r) c : U R nUc gUR $ )zKValue of `prst` attribute of `a:prstGeom` element or |None| if not present.N)r r{ r s r* r{
CT_Shape.prst s == }} r) c . U R R $ )z{Reference to `a:prstGeom` child element.
|None| if this shape doesn't have one, for example, if it's a placeholder shape.
)r r rQ s r* r CT_Shape.prstGeom s yy!!!r) c , [ R " 5 $ )N)r new_p_txBodyrQ s r* _new_txBodyCT_Shape._new_txBody s ''))r) c T S[ SS5 < SS< SS< SS< S S< S
S< S S< S 3$ )
Nr r r r r r r zc"/>
r
r! r) r* r CT_Shape._textbox_sp_tmpl s% 4 !c*D$dD$/
P
r) r! N)rN r rO r r_ rI )r intr9 r: r{ r: r r r r r r r r r_ r ) r r r9 r: r r r r r r r r )
r r r9 r: r r r r: r_ r )r_ rv ) r" r# r$ r% r& r' r r r r r rp r r r r r r staticmethodr r r r r{ r r r r( r! r) r* r r 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) r c h \ rS rSr% Sr\" S5 rS\S' \" S5 rS\S' \" S 5 r S
\S ' S r
g
)r i z `p:nvSpPr` custom element class.zp:cNvPrr cNvPrz p:cNvSpPrrD r zp:nvPrr r r! N) r" r# r$ r% r& r r r' r r r( r! r) r* r r sH *&3'E # .;.G
* h
- r) r 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, r7 r= rD rI r` ra rk rs rv r r r! r) r* r s B " 0 0 @ 4 '
!6O 6/ 5? 5 $4 * *Z*_ **o * O *o *%/ %:x
x
v ( r)