o 7h5@sdZddlmZddlmZddlmZmZddlm Z ddl m Z ddl m Z ddlmZmZdd lmZdd lmZdd lmZdd lmZer`dd lmZmZmZddlmZddlmZGdddZ GdddZ!GdddZ"GdddeZ#dS)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) ProvidesPartcsleZdZdZddfd d Zedd dZejdddZedddZ edddZ edddZ Z S) Adjustmenta4An 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. Nnamestrdef_valintactual int | Nonecs$tt|||_||_||_dSN)superr__init__rrr)selfrrr __class__]/var/www/html/figdemos/bartoux_crm/venv/lib/python3.10/site-packages/pptx/shapes/autoshape.pyr#s zAdjustment.__init__returnfloatcCs |jdur|jn|j}||S)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. N)rr _normalize)r raw_valuer#r#r$effective_value)s zAdjustment.effective_valuevaluecCs,t|tstdt||||_dS)Nz&adjustment value must be numeric, got ) isinstancer ValueErrorrepr _denormalizer)r r*r#r#r$r)8s cCs t|dS)zReturn integer corresponding to normalized `raw_value` on unit basis of 100,000. See Adjustment.normalize for additional details. j@)r)r*r#r#r$r.>s zAdjustment._denormalizer(cCs|dS)a&Return 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. r/r#)r(r#r#r$r'FszAdjustment._normalizecCs|jdur|jS|jS)zvDenormalized effective value. Expressed in shape coordinates, this is suitable for using in the XML. N)rrr r#r#r$valPszAdjustment.valr)rrrrrr)r%r&)r*r&)r*r&r%r)r(rr%r&)r%r) __name__ __module__ __qualname____doc__rpropertyr)setter staticmethodr.r'r1 __classcell__r#r#r!r$rs      rcsleZdZdZd fdd Zd!d d Zd"d dZd#ddZddZe d$ddZ e d%ddZ ddZ ZS)&AdjustmentCollectionzSequence 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`. prstGeomrcs$tt||||_||_dSr)rr:r_initialized_adjustments _adjustments_ _prstGeom)r r;r!r#r$r`s  zAdjustmentCollection.__init__idxrr%r&cCs |j|jS)z1Provides indexed access, (e.g. 'adjustments[9]').)r=r))r r?r#r#r$ __getitem__e z AdjustmentCollection.__getitem__r*cCs||j|_|dS)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)r=r)_rewrite_guides)r r?r*r#r#r$ __setitem__is  z AdjustmentCollection.__setitem__CT_PresetGeometry2D | Nonelist[Adjustment]cCs8|durgSt|j}dd|D}|||j|S)zTReturn an initialized list of adjustment values based on the contents of `prstGeom`.NcSsg|] \}}t||qSr#)r).0rrr#r#r$ vszAAdjustmentCollection._initialized_adjustments..) AutoShapeTypedefault_adjustment_valuesprst _update_adjustments_with_actualsgd_lst)r r;Zdavs adjustmentsr#r#r$r<qs  z-AdjustmentCollection._initialized_adjustmentscCs dd|jD}|j|dS)zWrite `a:gd` elements to the XML, one for each adjustment value. Any existing guide elements are overwritten. cSsg|]}|j|jfqSr#)rr1rFadjr#r#r$rGsz8AdjustmentCollection._rewrite_guides..N)r=r>rewrite_guides)r guidesr#r#r$rBzsz$AdjustmentCollection._rewrite_guidesrMIterable[Adjustment]rQIterable[CT_GeomGuide]c Cs^tdd|D}|D]!}|j}t|jdd}z||}Wn ty(Yq w||_q dS)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. css|]}|j|fVqdSr)rrNr#r#r$ szHAdjustmentCollection._update_adjustments_with_actuals..N)dictrrfmlaKeyErrorr)rMrQZadjustments_by_namegdrrZ adjustmentr#r#r$rKs   z5AdjustmentCollection._update_adjustments_with_actualstuple[Adjustment, ...]cC t|jS)z9Sequence of |Adjustment| objects contained in collection.)tupler=r0r#r#r$ _adjustmentss z!AdjustmentCollection._adjustmentscCr[)z!Implement built-in function len())lenr=r0r#r#r$__len__ zAdjustmentCollection.__len__)r;r)r?rr%r&)r?rr*r&)r;rDr%rE)rMrRrQrS)r%rZ)r2r3r4r5rr@rCr<rBr8rKr6r]r_r9r#r#r!r$r:Ys      r:cs~eZdZUdZiZded<dfdd Zdd d Zedd d Z edddZ e dddZ e dddZ eddZZS)rHaProvides 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] _instancesautoshape_type_idr r%cs.||jvrtt||}||j|<|j|S)zkOnly create new instance on first call for content_type. After that, use cached instance. )rarrH__new__)clsrbinstr!r#r$rcs   zAutoShapeType.__new__cCsDt|drdS|tvrtd|t|}||_|d|_d|_dS)z:Initialize attributes from constant values in `pptx.spec`._loadedNz;no autoshape type with id '%s' in pptx.spec.autoshape_typesbasenameT)hasattrrrX_autoshape_type_id _basenamerf)r rbautoshape_typer#r#r$rs   zAutoShapeType.__init__cCs|jS)zHMSO_AUTO_SHAPE_TYPE enumeration member identifying this auto shape type.)rir0r#r#r$rbszAutoShapeType.autoshape_type_idrcCst|jddiS)awBase 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")rescaperjr0r#r#r$rgs zAutoShapeType.basenamerJtuple[AdjustmentValue, ...]cCs t|dS)zSSequence of (name, value) pair adjustment value defaults for `prst` autoshape-type.avLstr rdrJr#r#r$rI z'AutoShapeType.default_adjustment_valuescCs t|S)zSelect auto shape type with matching `prst`. e.g. `MSO_SHAPE.RECTANGLE` corresponding to preset geometry keyword `"rect"`. )r from_xmlrpr#r#r$ id_from_prsts zAutoShapeType.id_from_prstcCs t|jS)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_xmlrir0r#r#r$rJs zAutoShapeType.prst)rbr r%rH)rbr )r%r r%r)rJr r%rn)rJrr%r )r2r3r4r5ra__annotations__rcrr6rbrg classmethodrIrsrJr9r#r#r!r$rHs       rHcseZdZdZd#fdd Zed$d d Zed d ZeddZ ddZ ed%ddZ eddZ eddZ ed&ddZed'ddZejd(d dZed!d"ZZS))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). sprparentrcstt|||||_dSr)rrxr_sp)r ryrzr!r#r$rs zShape.__init__r%r:cCs t|jjS)zFRead-only reference to |AdjustmentCollection| instance for this shape.)r:r{r;r0r#r#r$rM rqzShape.adjustmentscCs|jjstd|jjS)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,rJr0r#r#r$auto_shape_typeszShape.auto_shape_typecCst|jjS)zn|FillFormat| instance for this shape. Provides access to fill properties such as fill color. )rfrom_fill_parentr{spPrr0r#r#r$fillsz Shape.fillcCs |jS)zSReturn the `a:ln` element containing the line format properties XML for this shape.)r{ get_or_add_lnr0r#r#r$r!r`zShape.get_or_add_lnboolcCsdS)zF|True| if this shape can contain text. Always |True| for an AutoShape.Tr#r0r#r#r$has_text_frame%szShape.has_text_framecCst|S)zn|LineFormat| instance for this shape. Provides access to line properties such as line color. rr0r#r#r$line*z Shape.linecC|jjS)zThe `a:ln` element containing the line format properties such as line color and width. |None| if no `a:ln` element is present. )r{lnr0r#r#r$r2rzShape.lnr cCs>|jrtjS|jjr tjS|jjrtjS|jjrtj St d)zRUnique integer identifying the type of this shape, like `MSO_SHAPE_TYPE.TEXT_BOX`.z)Shape instance of unrecognized shape type) Zis_placeholderr PLACEHOLDERr{has_custom_geometryFREEFORMr| AUTO_SHAPE is_textboxTEXT_BOXNotImplementedErrorr0r#r#r$ shape_type:szShape.shape_typercCr)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_frametextr0r#r#r$rGsz Shape.textrcCs ||j_dSrr)r rr#r#r$rXrAcCs|j}t||S)z|TextFrame| instance for this shape. Contains the text of the shape and provides access to text formatting properties. )r{get_or_add_txBodyr)r txBodyr#r#r$r\s  zShape.text_frame)ryrrzr)r%r:)r%r)r%r ru)rr)r2r3r4r5rrrMr6r}rrrrrrrr7rr9r#r#r!r$rxs0         rxN)$r5 __future__rnumbersrtypingrrZxml.saxr pptx.dml.fillr pptx.dml.liner pptx.enum.shapesr r pptx.shapes.baser pptx.specrpptx.text.textr pptx.utilrpptx.oxml.shapes.autoshaperrrr pptx.typesrrr:rHrxr#r#r#r$s(           BG_