~Zi5 SrSSKJr SSKJr SSKJrJr SSKJ r SSK J r SSK J r SSKJrJr SS KJr SS KJr SS KJr SS KJr \(aSS KJrJrJr SSKJr SSKJr "SS5r "SS5r!"SS5r""SS\5r#g)z7Autoshape-related objects such as Shape and Adjustment.) annotations)Number) TYPE_CHECKINGIterable)saxutils) FillFormat LineFormat)MSO_AUTO_SHAPE_TYPEMSO_SHAPE_TYPE) BaseShapeautoshape_types) TextFrame) lazyproperty) CT_GeomGuideCT_PresetGeometry2DCT_Shape)AdjustmentValue) ProvidesPartc^\rSrSrSrS S U4Sjjjr\S Sj5r\RS Sj5r\ SSj5r \ SSj5r \SSj5r S r U=r$) AdjustmentaAn adjustment value for an autoshape. An adjustment value corresponds to the position of an adjustment handle on an auto shape. Adjustment handles are the small yellow diamond-shaped handles that appear on certain auto shapes and allow the outline of the shape to be adjusted. For example, a rounded rectangle has an adjustment handle that allows the radius of its corner rounding to be adjusted. Values are |float| and generally range from 0.0 to 1.0, although the value can be negative or greater than 1.0 in certain circumstances. cN>[[U] 5 XlX lX0lgN)superr__init__namedef_valactual)selfrrr __class__s o/var/www/eduai.edurigo.com/question_generate/ques_gen_env/lib/python3.13/site-packages/pptx/shapes/autoshape.pyrAdjustment.__init__#s j$(*   cnURb URO URnURU5$)aRead/write |float| representing normalized adjustment value for this adjustment. Actual values are a large-ish integer expressed in shape coordinates, nominally between 0 and 100,000. The effective value is normalized to a corresponding value nominally between 0.0 and 1.0. Intuitively this represents the proportion of the width or height of the shape at which the adjustment value is located from its starting point. For simple shapes such as a rounded rectangle, this intuitive correspondence holds. For more complicated shapes and at more extreme shape proportions (e.g. width is much greater than height), the value can become negative or greater than 1.0. )r r _normalize)r! raw_values r#effective_valueAdjustment.effective_value)s+$(;;#:DKK y))r%c[U[5(d[S[U535eUR U5Ulg)Nz&adjustment value must be numeric, got ) isinstancer ValueErrorrepr _denormalizer )r!values r#r)r*8s8%((Ed5k]ST T''. r%c[US-5$)zReturn integer corresponding to normalized `raw_value` on unit basis of 100,000. See Adjustment.normalize for additional details. j@)int)r0s r#r/Adjustment._denormalize>s 58#$$r%c US- $)aReturn normalized value for `raw_value`. A normalized value is a |float| between 0.0 and 1.0 for nominal raw values between 0 and 100,000. Raw values less than 0 and greater than 100,000 are valid and return values calculated on the same unit basis of 100,000. r2)r(s r#r'Adjustment._normalizeFs8##r%cLURb UR$UR$)zfDenormalized effective value. Expressed in shape coordinates, this is suitable for using in the XML. )r rr!s r#valAdjustment.valPs #kk5t{{G4<<Gr%)r rrr)rstrrr3r z int | None)returnfloat)r0r>)r0r>r=r3)r(r3r=r>)r=r3)__name__ __module__ __qualname____firstlineno____doc__rpropertyr)setter staticmethodr/r'r:__static_attributes__ __classcell__r"s@r#rrs~   * *// %%$$HHr%rc^\rSrSrSrS U4SjjrS SjrSSjrSSjrSr \ SSj5r \ SS j5r S rS rU=r$)AdjustmentCollectionYzSequence of |Adjustment| instances for an auto shape. Each represents an available adjustment for a shape of its type. Supports `len()` and indexed access, e.g. `shape.adjustments[1] = 0.15`. cb>[[U] 5 URU5UlXlgr)rrKr_initialized_adjustments _adjustments_ _prstGeom)r!prstGeomr"s r#rAdjustmentCollection.__init__`s) "D24!::8D!r%c4URUR$)z1Provides indexed access, (e.g. 'adjustments[9]').)rOr))r!idxs r# __getitem__ AdjustmentCollection.__getitem__es!!#&666r%cJX RUlUR5 g)zProvides item assignment via an indexed expression, e.g. `adjustments[9] = 999.9`. Causes all adjustment values in collection to be written to the XML. N)rOr)_rewrite_guides)r!rTr0s r# __setitem__ AdjustmentCollection.__setitem__is! 383/ r%cUc/$[RUR5nUVVs/sHup4[X45PM nnnUR XQR 5 U$s snnf)zTReturn an initialized list of adjustment values based on the contents of `prstGeom`.) AutoShapeTypedefault_adjustment_valuesprstr _update_adjustments_with_actualsgd_lst)r!rQdavsrr adjustmentss r#rN-AdjustmentCollection._initialized_adjustmentsqsZ  I66x}}EFJKd]Tz$0d K --k??KLsA!cURVs/sHoRUR4PM nnURR U5 gs snf)zoWrite `a:gd` elements to the XML, one for each adjustment value. Any existing guide elements are overwritten. N)rOrr:rPrewrite_guides)r!adjguidess r#rX$AdjustmentCollection._rewrite_guideszsC 261C1CD1C#88SWW%1CD %%f-Es!Ac[SU55nUH2nURn[URSS5nX$nXVlM4 g![a MDf=f)zUpdate |Adjustment| instances in `adjustments` with actual values held in `guides`. `guides` is a list of `a:gd` elements. Guides with a name that does not match an adjustment object are skipped. c3<# UHoRU4v M g7fr)r).0rfs r# HAdjustmentCollection._update_adjustments_with_actuals..s"JksHHc?ksN)dictrr3fmlaKeyErrorr )rbrgadjustments_by_namegdrr adjustments r#r_5AdjustmentCollection._update_adjustments_with_actualssj#"Jk"JJB77D%F 06 !'    sA  AAc,[UR5$)z9Sequence of |Adjustment| objects contained in collection.)tuplerOr9s r# _adjustments!AdjustmentCollection._adjustmentssT''((r%c,[UR5$)z!Implement built-in function len())lenrOr9s r#__len__AdjustmentCollection.__len__s4%%&&r%)rOrP)rQr)rTr3r=r>)rTr3r0r>)rQzCT_PresetGeometry2D | Noner=zlist[Adjustment])rbzIterable[Adjustment]rgzIterable[CT_GeomGuide])r=ztuple[Adjustment, ...])r?r@rArBrCrrUrYrNrXrFr_rDrxr|rGrHrIs@r#rKrKYsc " 7.)3I&))''r%rKc^\rSrSr%Sr0rS\S'S U4SjjrSSjr\ SSj5r \ SSj5r \ SS j5r \ SS j5r\ S 5rS rU=r$)r\aProvides access to metadata for an auto-shape of type identified by `autoshape_type_id`. Instances are cached, so no more than one instance for a particular auto shape type is in memory. Instances provide the following attributes: .. attribute:: autoshape_type_id Integer uniquely identifying this auto shape type. Corresponds to a value in `pptx.constants.MSO` like `MSO_SHAPE.ROUNDED_RECTANGLE`. .. attribute:: basename Base part of shape name for auto shapes of this type, e.g. `Rounded Rectangle` becomes `Rounded Rectangle 99` when the distinguishing integer is added to the shape name. .. attribute:: prst String identifier for this auto shape type used in the `a:prstGeom` element. z(dict[MSO_AUTO_SHAPE_TYPE, AutoShapeType] _instancesc>XR;a![[U]U5nX RU'URU$)z[Only create new instance on first call for content_type. After that, use cached instance. )rrr\__new__)clsautoshape_type_idinstr"s r#rAutoShapeType.__new__s= NN 24S9D04NN, -~~/00r%c[US5(agU[;a[SU-5e[UnXlUSUlSUlg)z:Initialize attributes from constant values in `pptx.spec`._loadedNz;no autoshape type with id '%s' in pptx.spec.autoshape_typesbasenameT)hasattrrrq_autoshape_type_id _basenamer)r!rautoshape_types r#rAutoShapeType.__init__sX 4 # #  O 3MPaa )):;"3' 3 r%cUR$)zHMSO_AUTO_SHAPE_TYPE enumeration member identifying this auto shape type.)rr9s r#rAutoShapeType.autoshape_type_ids&&&r%cH[R"URSS05$)aOBase of shape name for this auto shape type. A shape name is like "Rounded Rectangle 7" and appears as an XML attribute for example at `p:sp/p:nvSpPr/p:cNvPr{name}`. This basename value is the name less the distinguishing integer. This value is escaped because at least one autoshape-type name includes double quotes ('"No" Symbol'). "z")rescaperr9s r#rAutoShapeType.basenamest~~X??r%c[US$)zSSequence of (name, value) pair adjustment value defaults for `prst` autoshape-type.avLstrrr^s r#r]'AutoShapeType.default_adjustment_valuesst$W--r%c.[R"U5$)z|Select auto shape type with matching `prst`. e.g. `MSO_SHAPE.RECTANGLE` corresponding to preset geometry keyword `"rect"`. )r from_xmlrs r# id_from_prstAutoShapeType.id_from_prsts #++D11r%cB[R"UR5$)z Preset geometry identifier string for this auto shape. Used in the `prst` attribute of `a:prstGeom` element to specify the geometry to be used in rendering the shape, for example `'roundRect'`. )r to_xmlrr9s r#r^AutoShapeType.prsts#))$*A*ABBr%)rrr)rr r=r\)rr )r=r r=r<)r^r r=ztuple[AdjustmentValue, ...])r^r<r=r )r?r@rArBrCr__annotations__rrrDrr classmethodr]rr^rGrHrIs@r#r\r\s2<>J8= 1 ''@@..22CCr%r\c^\rSrSrSrSU4Sjjr\SSj5r\S5r \S5r Sr \SSj5r \S 5r \S 5r\SS j5r\SS j5r\R"SS j5r\S5rSrU=r$)ShapezA shape that can appear on a slide. Corresponds to the `p:sp` element that can appear in any of the slide-type parts (slide, slideLayout, slideMaster, notesPage, notesMaster, handoutMaster). c8>[[U] X5 Xlgr)rrr_sp)r!spparentr"s r#rShape.__init__s eT#B/r%c@[URR5$)zFRead-only reference to |AdjustmentCollection| instance for this shape.)rKrrQr9s r#rbShape.adjustments s$DHH$5$566r%czURR(d [S5eURR$)zEnumeration value identifying the type of this auto shape. Like `MSO_SHAPE.ROUNDED_RECTANGLE`. Raises |ValueError| if this shape is not an auto shape. zshape is not an auto shape)r is_autoshaper-r^r9s r#auto_shape_typeShape.auto_shape_types+ xx$$9: :xx}}r%cV[R"URR5$)z^|FillFormat| instance for this shape. Provides access to fill properties such as fill color. )rfrom_fill_parentrspPrr9s r#fill Shape.fills **488==99r%c6URR5$)zSReturn the `a:ln` element containing the line format properties XML for this shape.)r get_or_add_lnr9s r#rShape.get_or_add_ln!sxx%%''r%cg)zF|True| if this shape can contain text. Always |True| for an AutoShape.Tr6r9s r#has_text_frameShape.has_text_frame%sr%c[U5$)z^|LineFormat| instance for this shape. Provides access to line properties such as line color. r r9s r#line Shape.line*s $r%c.URR$)zThe `a:ln` element containing the line format properties such as line color and width. |None| if no `a:ln` element is present. )rlnr9s r#rShape.ln2s xx{{r%c\UR(a[R$URR(a[R $URR (a[R$URR(a[R$[S5e)zRUnique integer identifying the type of this shape, like `MSO_SHAPE_TYPE.TEXT_BOX`.z)Shape instance of unrecognized shape type) is_placeholderr PLACEHOLDERrhas_custom_geometryFREEFORMr AUTO_SHAPE is_textboxTEXT_BOXNotImplementedErrorr9s r# shape_typeShape.shape_type:sp   !-- - 88 ' '!** * 88 !,, , 88  !** *!"MNNr%c.URR$)aRead/write. Text in shape as a single string. The returned string will contain a newline character (`"\n"`) separating each paragraph and a vertical-tab (`"\v"`) character for each line break (soft carriage return) in the shape's text. Assignment to `text` replaces any text previously contained in the shape, along with any paragraph or font formatting applied to it. A newline character (`"\n"`) in the assigned text causes a new paragraph to be started. A vertical-tab (`"\v"`) character in the assigned text causes a line-break (soft carriage-return) to be inserted. (The vertical-tab character appears in clipboard text copied from PowerPoint as its str encoding of line-breaks.)  text_frametextr9s r#r Shape.textGs###r%c$XRlgrr)r!rs r#rrXs #r%cLURR5n[X5$)zx|TextFrame| instance for this shape. Contains the text of the shape and provides access to text formatting properties. )rget_or_add_txBodyr)r!txBodys r#rShape.text_frame\s! ++-&&r%)r)rrrr)r=rK)r=bool)r=r r)rr<)r?r@rArBrCrrrbrDrrrrrrrrrErrGrHrIs@r#rrs 77::(   O O$$  [[$$''r%rN)$rC __future__rnumbersrtypingrrxml.saxr pptx.dml.fillr pptx.dml.liner pptx.enum.shapesr r pptx.shapes.baser pptx.specrpptx.text.textr pptx.utilrpptx.oxml.shapes.autoshaperrrr pptx.typesrrrKr\rr6r%r#rso="*$$@&%$"VV)'?H?HDD'D'N\C\C~d'Id'r%