,h6dZddlmZmZmZmZddlmZddlm cm Z ddl m Z ddl mZddlmZmZddlmZdd lmZdd lmZdd lmZGd d eZGddeZGddeZGddeZy)z7Autoshape-related objects such as Shape and Adjustment.)absolute_importdivisionprint_functionunicode_literals)NumberN) FillFormat LineFormat)MSO_AUTO_SHAPE_TYPEMSO_SHAPE_TYPE) BaseShapeautoshape_types) TextFrame) lazypropertyceZdZdZdfd ZedZejdZedZ edZ edZ xZ S) Adjustmenta= An 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. cTtt| ||_||_||_yN)superr__init__namedef_valactual)selfrrr __class__s W/var/www/html/Resume-Scraper/venv/lib/python3.12/site-packages/pptx/shapes/autoshape.pyrzAdjustment.__init__!s% j$(*   cX|j}| |j}|j|S)a Read/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. )rr _normalize)r raw_values reffective_valuezAdjustment.effective_value's+KK   Iy))rcpt|tsd}t||z|j||_y)Nz*adjustment value must be numeric, got '%s') isinstancer ValueError _denormalizer)rvaluetmpls rr"zAdjustment.effective_value:s2%(?DTE\* *''. rct|dzS)z Return integer corresponding to normalized *raw_value* on unit basis of 100,000. See Adjustment.normalize for additional details. j@)int)r's rr&zAdjustment._denormalizeAs 58#$$rc |dz S)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!s rr zAdjustment._normalizeIs8##rcJ|j |jS|jS)zw Denormalized effective value (expressed in shape coordinates), suitable for using in the XML. )rrrs rvalzAdjustment.valSs #kk5t{{G4<<Grr) __name__ __module__ __qualname____doc__rpropertyr"setter staticmethodr&r r0 __classcell__rs@rrrsy  **$// %%$$HHrrc`eZdZdZfdZdZdZdZdZe dZ e dZ d Z xZS) AdjustmentCollectionz Sequence of |Adjustment| instances for an auto shape, each representing an available adjustment for a shape of its type. Supports ``len()`` and indexed access, e.g. ``shape.adjustments[1] = 0.15``. cdtt| |j||_||_yr)rr;r_initialized_adjustments _adjustments_ _prstGeom)rprstGeomrs rrzAdjustmentCollection.__init__cs+ "D24!::8D!rc4|j|jS)z1Provides indexed access, (e.g. 'adjustments[9]').)r>r")rkeys r __getitem__z AdjustmentCollection.__getitem__hs!!#&666rcL||j|_|jy)z Provides 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)rrBr's r __setitem__z AdjustmentCollection.__setitem__ls# 383/ rc|gStj|j}|Dcgc]\}}t||}}}|j ||j |Scc}}w)zm Return an initialized list of adjustment values based on the contents of *prstGeom* ) AutoShapeTypedefault_adjustment_valuesprstr _update_adjustments_with_actualsgd_lst)rr@davsrr adjustmentss rr=z-AdjustmentCollection._initialized_adjustmentsusa  I66x}}EFJK]T7z$0K K --k8??KLsA c|jDcgc]}|j|jf}}|jj |ycc}w)z Write ```` elements to the XML, one for each adjustment value. Any existing guide elements are overwritten. N)r>rr0r?rewrite_guides)radjguidess rrEz$AdjustmentCollection._rewrite_guidessB 261C1CD#388SWW%DD %%f-EsA ctd|D}|D]3}|j}t|jdd} ||}||_5y#t$rYBwxYw)z Update |Adjustment| instances in *adjustments* with actual values held in *guides*, a list of ```` elements. Guides with a name that does not match an adjustment object are skipped. c38K|]}|j|fywr)r).0rQs r zHAdjustmentCollection._update_adjustments_with_actuals..s"JsCHHc?"JsN)dictrr+fmlaKeyErrorr)rNrRadjustments_by_namegdrr adjustments rrKz5AdjustmentCollection._update_adjustments_with_actualsss#"Jk"JJ 'B77D%F 06 !'J  '   sA  AAc,t|jS)zt Sequence containing direct references to the |Adjustment| objects contained in collection. )tupler>r/s r _adjustmentsz!AdjustmentCollection._adjustmentss T''((rc,t|jS)z!Implement built-in function len())lenr>r/s r__len__zAdjustmentCollection.__len__s4%%&&r)r1r2r3r4rrCrFr=rEr7rKr5r`rcr8r9s@rr;r;\sN " 7 ."))'rr;ceZdZdZiZfdZdZedZedZ e dZ edZ e dZ ed ZxZS) rHa Return an instance of |AutoShapeType| containing 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 ```` element. .. attribute:: desc Informal string description of auto shape. c||jvr"tt||}||j|<|j|S)zs Only create new instance on first call for content_type. After that, use cached instance. ) _instancesrrH__new__)clsautoshape_type_idinstrs rrgzAutoShapeType.__new__sA CNN 24S9D04CNN, -~~/00rct|dry|tvrtd|zt|}||_|d|_d|_y)z7Initialize attributes from constant values in pptx.spec_loadedNz;no autoshape type with id '%s' in pptx.spec.autoshape_typesbasenameT)hasattrrrZ_autoshape_type_id _basenamerl)rriautoshape_types rrzAutoShapeType.__init__sY 4 #  O 3M#$  )):;"3' 3 rc|jS)zP MSO_AUTO_SHAPE_TYPE enumeration value for this auto shape type )ror/s rrizAutoShapeType.autoshape_type_ids &&&rcFtj|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")saxutilsescaperpr/s rrmzAutoShapeType.basenamest~~X??rct|dS)z Return sequence of name, value tuples representing the adjustment value defaults for the auto shape type identified by *prst*. avLstrrhrJs rrIz'AutoShapeType.default_adjustment_valuess t$W--rc|jS)z,Informal description of this auto shape type)_descr/s rdesczAutoShapeType.descszzrc,tj|S)z~ Return auto shape id (e.g. ``MSO_SHAPE.RECTANGLE``) corresponding to preset geometry keyword *prst*. )r from_xmlrys r id_from_prstzAutoShapeType.id_from_prsts #++D11rc@tj|jS)z Preset geometry identifier string for this auto shape. Used in the ``prst`` attribute of ```` element to specify the geometry to be used in rendering the shape, for example ``'roundRect'``. )r to_xmlror/s rrJzAutoShapeType.prst s#))$*A*ABBr)r1r2r3r4rfrgrr5rirm classmethodrIr|rrJr8r9s@rrHrHs:J 1"'' @@..22CCrrHceZdZdZfdZedZedZedZ dZ edZ edZ ed Z ed Zed Zej d Zed ZxZS)ShapezA shape that can appear on a slide. Corresponds to the ```` element that can appear in any of the slide-type parts (slide, slideLayout, slideMaster, notesPage, notesMaster, handoutMaster). c<tt| ||||_yr)rrr_sp)rspparentrs rrzShape.__init__s eT#B/rc@t|jjS)z_ Read-only reference to |AdjustmentCollection| instance for this shape )r;rr@r/s rrNzShape.adjustments!s $DHH$5$566rcp|jjs td|jjS)z Enumeration 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%rJr/s rauto_shape_typezShape.auto_shape_type)s+xx$$9: :xx}}rcTtj|jjS)zw |FillFormat| instance for this shape, providing access to fill properties such as fill color. )rfrom_fill_parentrspPrr/s rfillz Shape.fill4s **488==99rc6|jjS)zq Return the ```` element containing the line format properties XML for this shape. )r get_or_add_lnr/s rrzShape.get_or_add_ln<s xx%%''rcy)z` |True| if this shape can contain text. Always |True| for an AutoShape. Tr-r/s rhas_text_framezShape.has_text_frameCs rct|S)zw |LineFormat| instance for this shape, providing access to line properties such as line color. r r/s rlinez Shape.lineKs $rc.|jjS)z The ```` element containing the line format properties such as line color and width. |None| if no ```` element is present. )rlnr/s rrzShape.lnSs xx{{rc8|jrtjS|jjrtj S|jj rtjS|jjrtjSd}t|)zn Unique 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_BOXNotImplementedError)rmsgs r shape_typezShape.shape_type[st   !-- - 88 ' '!** * 88 !,, , 88  !** *9!#&&rc.|jjS)a Read/write. Unicode (str in Python 3) representation of shape text. 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 all 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 encoding of line-breaks.) Either bytes (Python 2 str) or unicode (Python 3 str) can be assigned. Bytes can be 7-bit ASCII or UTF-8 encoded 8-bit bytes. Bytes values are converted to unicode assuming UTF-8 encoding (which also works for ASCII).  text_frametextr/s rrz Shape.textls&###rc&||j_yrr)rrs rrz Shape.texts#rcN|jj}t||S)z|TextFrame| instance for this shape. Contains the text of the shape and provides access to text formatting properties. )_elementget_or_add_txBodyr)rtxBodys rrzShape.text_frames#002&&r)r1r2r3r4rrrNr5rrrrrrrrr6rr8r9s@rrrs 77::(  '' $$( [[$$''rr)r4 __future__rrrrnumbersrxml.sax.saxutilssaxru pptx.dml.fillr pptx.dml.liner pptx.enum.shapesr r pptx.shapes.baser pptx.specrpptx.text.textr pptx.utilrobjectrr;rHrr-rrrsm>RR##$$@&%$"FHFHRI'6I'XkCFkC\w'Iw'r