,h3ndZddlmZmZmZmZddlmZddlm Z ddl m Z ddl m Z mZmZmZmZmZddlmZddlmZGd d eZGd d eZGd deZGddeZGddeZGddeZGddeZGddeZGddeZ GddeZ!GddeZ"y) z"DrawingML objects related to fill.)absolute_importdivisionprint_functionunicode_literals)Sequence) ColorFormat)MSO_FILL)CT_BlipFillPropertiesCT_GradientFillPropertiesCT_GroupFillPropertiesCT_NoFillPropertiesCT_PatternFillPropertiesCT_SolidColorFillProperties) ElementProxy) lazypropertyceZdZdZfdZedZedZdZ edZ dZ edZ e jd Z ed Zed Zejd Zd ZdZedZxZS) FillFormatzq Provides access to the current fill properties object and provides methods to change the fill type. cFtt| ||_||_yN)superr__init___xPr_fill)selfeg_fill_properties_parentfill_obj __class__s O/var/www/html/Resume-Scraper/venv/lib/python3.12/site-packages/pptx/dml/fill.pyrzFillFormat.__init__s j$(*-  cF|j}t|}|||}|S)z Return a |FillFormat| instance initialized to the settings contained in *eg_fillProperties_parent*, which must be an element having EG_FillProperties in its child element sequence in the XML schema. )eg_fillProperties_Fill)clseg_fillProperties_parentfill_elmfill fill_formats rfrom_fill_parentzFillFormat.from_fill_parent!s+,==X2D9 rc.|jjS)zReturn a |ColorFormat| object representing background color. This property is only applicable to pattern fills and lines. )r back_colorrs rr*zFillFormat.back_color- zz$$$rcX|jj}t||_y)zA Sets the fill type to noFill, i.e. transparent. N)rget_or_change_to_noFill_NoFillr)rnoFills r backgroundzFillFormat.background5s!224V_ rc.|jjS)zi Return a |ColorFormat| instance representing the foreground color of this fill. )r fore_colorr+s rr3zFillFormat.fore_color<r,rcX|jj}t||_y)aSets the fill type to gradient. If the fill is not already a gradient, a default gradient is added. The default gradient corresponds to the default in the built-in PowerPoint "White" template. This gradient is linear at angle 90-degrees (upward), with two stops. The first stop is Accent-1 with tint 100%, shade 100%, and satMod 130%. The second stop is Accent-1 with tint 50%, shade 100%, and satMod 350%. N)rget_or_change_to_gradFill _GradFillrrgradFills rgradientzFillFormat.gradientDs"99668x( rc~|jtjk7r td|jj S)aAngle in float degrees of line of a linear gradient. Read/Write. May be |None|, indicating the angle should be inherited from the style hierarchy. An angle of 0.0 corresponds to a left-to-right gradient. Increasing angles represent counter-clockwise rotation of the line, for example 90.0 represents a bottom-to-top gradient. Raises |TypeError| when the fill type is not MSO_FILL_TYPE.GRADIENT. Raises |ValueError| for a non-linear gradient (e.g. a radial gradient). *Fill is not of type MSO_FILL_TYPE.GRADIENTtyper GRADIENT TypeErrorrgradient_angler+s rr@zFillFormat.gradient_angleQs2 99)) )HI Izz(((rcv|jtjk7r td||j_y)Nr;r<rvalues rr@zFillFormat.gradient_angleas, 99)) )HI I$) !rc~|jtjk7r td|jj S)z|GradientStops| object providing access to stops of this gradient. Raises |TypeError| when fill is not gradient (call `fill.gradient()` first). Each stop represents a color between which the gradient smoothly transitions. r;)r=r r>r?rgradient_stopsr+s rrEzFillFormat.gradient_stopsgs2 99)) )HI Izz(((rc.|jjS)aReturn member of :ref:`MsoPatternType` indicating fill pattern. Raises |TypeError| when fill is not patterned (call `fill.patterned()` first). Returns |None| if no pattern has been set; PowerPoint may display the default `PERCENT_5` pattern in this case. Assigning |None| will remove any explicit pattern setting, although relying on the default behavior is discouraged and may produce rendering differences across client applications. rpatternr+s rrHzFillFormat.patternsszz!!!rc&||j_yrrGr pattern_types rrHzFillFormat.patterns) rcX|jj}t||_y)aSelects the pattern fill type. Note that calling this method does not by itself set a foreground or background color of the pattern. Rather it enables subsequent assignments to properties like fore_color to set the pattern and colors. N)rget_or_change_to_pattFill _PattFillr)rpattFills r patternedzFillFormat.patterneds"99668x( rcX|jj}t||_y)a& Sets the fill type to solid, i.e. a solid color. Note that calling this method does not set a color or by itself cause the shape to appear with a solid color fill; rather it enables subsequent assignments to properties like fore_color to set the color. N)rget_or_change_to_solidFill _SolidFillr)r solidFills rsolidzFillFormat.solids"II88:  * rc.|jjS)zx Return a value from the :ref:`MsoFillType` enumeration corresponding to the type of this fill. )rr=r+s rr=zFillFormat.types zzr)__name__ __module__ __qualname____doc__r classmethodr(propertyr*r1r3r9r@setterrErHrPrUr= __classcell__rs@rrrs    %%%%% ) ) )**  ) ) " " ^^** )+rrcbeZdZdZfdZedZedZedZedZ xZ S)r"z Object factory for fill object of class matching fill element, such as _SolidFill for ````; also serves as the base class for all fill classes c\|t}nt|trt}nyt|trt }nbt|t rt}nKt|trt}n4t|trt}nt|trt}nt}tt|C|Sr) _NoneFill isinstancer _BlipFillr r6r _GrpFillr r/rrNrrSr"r__new__)r#xFillfill_clsrs rrfz _Fill.__new__s = H 4 5 H 8 9 H 5 6H 2 3H 7 8 H : ;!HHUC(22rcJd}t||jjz)=Raise TypeError for types that do not override this property.z=fill type %s has no background color, call .patterned() firstr?rrWrtmpls rr*z_Fill.back_colors$Ot~~66677rcJd}t||jjz)rjzIfill type %s has no foreground color, call .solid() or .patterned() firstrkrls rr3z_Fill.fore_colors(  t~~66677rcJd}t||jjz)z=Raise TypeError for fills that do not override this property.z4fill type %s has no pattern, call .patterned() firstrkrls rrHz _Fill.patterns$Ft~~66677rcJd}t||jjz)Nz(.type property must be implemented on %s)NotImplementedErrorrrWrls rr=z _Fill.types!9!$)@)@"@AAr) rWrXrYrZrfr\r*r3rHr=r^r_s@rr"r"s_ 3&88 8888 BBrr"ceZdZedZy)rdc"tjSr)r PICTUREr+s rr=z_BlipFill.typesrNrWrXrYr\r=rrrdrds   rrdcjeZdZdZdZedZejdZedZ edZ y)r6z Proxies an `a:gradFill` element.c |x|_|_yr)_element _gradFillr7s rrz_GradFill.__init__s)11 rc|jj}| td|jj}|y|j}|dk(rd}|Sd|z }|S)aAngle in float degrees of line of a linear gradient. Read/Write. May be |None|, indicating the angle is inherited from the style hierarchy. An angle of 0.0 corresponds to a left-to-right gradient. Increasing angles represent clockwise rotation of the line, for example 90.0 represents a top-to-bottom gradient. Raises |TypeError| when the fill type is not MSO_FILL_TYPE.GRADIENT. Raises |ValueError| for a non-linear gradient (e.g. a radial gradient). Nnot a linear gradientgv@)rzpath ValueErrorlinang)rr~rclockwise_anglecounter_clockwise_angles rr@z_GradFill.gradient_anglesw~~""  45 5nn   ;''"c)C '&160G '&rc^|jj}| tdd|z |_y)Nr|r})rzrrr)rrCrs rr@z_GradFill.gradient_angles-nn   ;45 5%-rcHt|jjS)z|_GradientStops| object providing access to gradient colors. Each stop represents a color between which the gradient smoothly transitions. )_GradientStopsrzget_or_add_gsLstr+s rrEz_GradFill.gradient_stops sdnn==?@@rc"tjSr)r r>r+s rr=z_GradFill.types   rN) rWrXrYrZrr\r@r]rrEr=rvrrr6r6sb*2''>  AA!!rr6ceZdZedZy)rec"tjSr)r GROUPr+s rr=z _GrpFill.type ~~rNrurvrrreres rreceZdZedZy)r/c"tjSr)r BACKGROUNDr+s rr=z _NoFill.types"""rNrurvrrr/r/s ##rr/ceZdZedZy)rbcyrrvr+s rr=z_NoneFill.type%srNrurvrrrbrb$s rrbceZdZdZfdZedZedZedZ e jdZ edZ xZ S)rNz-Provides access to patterned fill properties.cFtt| |x|_|_yr)rrNrry _pattFill)rrOrs rrz_PattFill.__init__-s i'))11 rc`|jj}tj|S)z;Return |ColorFormat| object that controls background color.)rget_or_add_bgClrrfrom_colorchoice_parent)rbgClrs rr*z_PattFill.back_color1'//122599rc`|jj}tj|S)z;Return |ColorFormat| object that controls foreground color.)rget_or_add_fgClrrr)rfgClrs rr3z_PattFill.fore_color7rrc.|jjS)a Return member of :ref:`MsoPatternType` indicating fill pattern. Returns |None| if no pattern has been set; PowerPoint may display the default `PERCENT_5` pattern in this case. Assigning |None| will remove any explicit pattern setting. rprstr+s rrHz_PattFill.pattern=s~~"""rc&||j_yrrrJs rrHz_PattFill.patternGs*rc"tjSr)r PATTERNEDr+s rr=z_PattFill.typeKs!!!r) rWrXrYrZrrr*r3r\rHr]r=r^r_s@rrNrN*ss72:: :: ## ^^++""rrNcBeZdZdZfdZedZedZxZ S)rSzAProvides access to fill properties such as color for solid fills.c8tt| ||_yr)rrSr _solidFill)rrTrs rrz_SolidFill.__init__Ss j$(*#rc@tj|jS)z3Return |ColorFormat| object controlling fill color.)rrrr+s rr3z_SolidFill.fore_colorWs224??CCrc"tjSr)r SOLIDr+s rr=z_SolidFill.type\rr) rWrXrYrZrrr3r\r=r^r_s@rrSrSPs5K$DDrrSc"eZdZdZdZdZdZy)ra/Collection of |GradientStop| objects defining gradient colors. A gradient must have a minimum of two stops, but can have as many more than that as required to achieve the desired effect (three is perhaps most common). Stops are sequenced in the order they are transitioned through. c||_yr)_gsLst)rgsLsts rrz_GradientStops.__init__js  rc2t|j|Sr) _GradientStopr)ridxs r __getitem__z_GradientStops.__getitem__msT[[-..rc,t|jSr)lenrr+s r__len__z_GradientStops.__len__ps4;;rN)rWrXrYrZrrrrvrrrras/ rrcfeZdZdZfdZedZedZejdZxZ S)rzQA single gradient stop. A gradient stop defines a color and a position. c:tt| |||_yr)rrr_gs)rgsrs rrz_GradientStop.__init__zs mT+B/rc@tj|jS)z3Return |ColorFormat| object controlling stop color.)rrrr+s rcolorz_GradientStop.color~s22488<rs)RR &"%"IIX2BF2Bj  8!8!vu #e#  #"#"L" X &$L$r