BPc%i^dZddlmZddlmZddlmZmZmZm Z m Z m Z ddl m Z ddlmZmZddlmZdd lmZdd lmZmZdd lmZmZdd lmZdd lmZmZm Z ddl!m"Z"m#Z#m$Z$m%Z%m&Z&ddl'm(Z(m)Z)ddl*m+Z+ddl,m-Z-m.Z.e ddZ/GddeZ0e0e-_1Gdde0Z2dS)z Provide extra utility to each svg element type specific to its type. This is useful for having a common interface for each element which can give path, transform, and property access easily. ) annotations)deepcopy)AnyTupleOptionaloverloadTypeVarList)etree) IBaseElementISVGDocumentElement)SvgOutputMixin)Path)StyleClasses) Transform BoundingBox) FragmentError) convert_unit render_unit parse_unit)ChildToPropertyNSSaddNSremoveNSsplitNS)BaseStyleValueall_properties) ElementList)NodeBasedLookup SVG_PARSERT BaseElement)boundcveZdZdZdZed^dZdZefd Z ed Z ed Z e Z d efd efddeffZ edZedZedZ edZ eddZ eddZ dZfdZd_fd ZfdZdZd_dZed`d#Z edad&Z d'Z d(Z! dbdcd1Z" ddded5Z#ed6Z$ dfdgd9Z%dhd:Z&ed;Z'did<Z(d=Z)djd?Z*d@Z+dAZ,e-ffdB Z.e-ffdC Z/dDZ0dEZ1dFZ2dGZ3dHZ4dIZ5dJZ6edKZ7e7j8dLZ7edMZ9e9j8dNZ9dOZ:dkdPZ;edQZe=dTZ?dldUZ@dVZAdldWZBdldXZCdYZDdZZEd[ZFd\ZGd_d]ZHxZIS)mr%z)Provide automatic namespaces to all callsc@|jrtj|dSdSN)tag_namer"register_class)clss 6/usr/share/inkscape/extensions/inkex/elements/_base.py__init_subclass__zBaseElement.__init_subclass__7s- < 0  *3 / / / / / 0 0elem etree.ElementreturnboolcdS)zHook to do more restrictive check in addition to (ns,tag) match .. versionadded:: 1.2 The function has been made public.T)r,r0s r-is_class_elementzBaseElement.is_class_element;s tr/c|js&ttjdSt|jdS)zReturn the tag_name without NS)r*rsupertag)self __class__s r-TAGzBaseElement.TAGGs=} -EGGK((, , &&r**r/c*||}|jdi||S)z9Create a new element, converting attrs values to strings.r5)update)r,childrenattrsobjs r-newzBaseElement.newNs,c8n U r/c6t|jdS)Nr)rr*r<s r-zBaseElement.Usgdm&<&z-BaseElement.wrapped_attrs..hs+IIIsB#a&#b'*IIIr/ WRAPPED_ATTRSrFs r- wrapped_attrszBaseElement.wrapped_attrseJId6HIIIIr/c$d|jDS)z2Map properties to attribute name and wrapper classc<i|]}|d|d|dfS)rrNr9r5rOs r-rRz-BaseElement.wrapped_props..ms+IIIsAR#b'*IIIr/rSrFs r- wrapped_propszBaseElement.wrapped_propsjrVr/c*t|jSr))type__name__rFs r-rGzBaseElement.osT$ZZ%8r/cP||Sr)) getroottreegetpathrFs r-rGzBaseElement.qs T%5%5%7%7%?%?%E%Er/zsvg:descT)prependz svg:titlec|jvr\j|\}fd}|jd|}|dkr|_t |||St djd|)z9Get the attribute, but load it if it is not available yetc|r%t|dSjddSr))setstrattribpop)new_itemattrr<s r- _set_attrz*BaseElement.__getattr__.._set_attrsG0HHT3x==11111KOOD$/////r/N)callbackrIzCan't find attribute .)rYregetelementsetattrAttributeErrortypename)r<namer,rivaluerhs` @r- __getattr__zBaseElement.__getattr__~s 4% % %,T2KT3 0 0 0 0 0 0C d33iHHHEw $ D$ & & &LKT]KKTKKLLLr/c$||jvrc|j|\}}|r4t||s ||}t||j|<dS|j|ddSt ||dS)z&Set the attribute, update it if neededN)rY isinstancerdrerfr: __setattr__)r<rqrrrhr,r=s r-rvzBaseElement.__setattr__s 4% % %,T2KT3 ,!%--'CJJE$'JJ D!!! d+++++ GG  e , , , , ,r/Nc||jvr8|j|\}}t||d}|rt|n|pd}|Stt ||S)z0Get element attribute named, with addNS support.N)rUgetattrrdr:rlr)r<rhdefaultprop_rrretr=s r-rlzBaseElement.getsp 4% % %*40IT1D$--E!&<#e***GOtCJww{{5;;000r/cj||jvr>|j|\}}t||||t||}|sdS|*|jt |ddSt |}tt ||dS)z/Set element attribute named, with addNS supportN) rUrnrxrerfrrdr:rc)r<rhrrrzr,r=s r-rczBaseElement.sets 4% % %,T2KT3 D$E + + +D$''E  = KOOE$KK . . . . .JJE GGKKd U + + + + +r/c f|D]\}}||||S)a Update element attributes using keyword arguments Note: double underscore is used as namespace separator, i.e. "namespace__attr" argument name will be treated as "namespace:attr" :param kwargs: dict with name=value pairs :return: self )itemsrc)r<kwargsrqrrs r-r@zBaseElement.updates;"<<>> " "KD% HHT5 ! ! ! ! r/c||jvr<|j|\}}t||}t|||d|S|jt ||S)z>Delete/remove the element attribute named, with addNS support.N)rUrxrnrerfr)r<rhryrzr,rrs r-rfzBaseElement.popsk 4% % %,T2KT3D$''E D$D * * *L{uT{{G444r/child1child2rATuple[BaseElement]cdSr)r5)r<rrrAs r-addzBaseElement.adds  r/childr$cdSr)r5)r<rs r-rzBaseElement.adds r/cp|D]}||t|dkr|n|dS)zk Like append, but will do multiple children and will return children or only child rr)appendlen)r<rArs r-rzBaseElement.addsF   E KK    x==A--xx8A;>r/c tjdd}|||dddddS)z9Return this element as it would appear in an svg documentr)widthheights> rr9Ni)r get_templategetrootrcopytostringsplit)r<svgs r-rzBaseElement.tostringsk )!<<<DDFF 499;;||~~##J2226ss;;r/Fprefix Optional[str]size Optional[int] backlinks blacklistOptional[List[str]]c|t|n|}||j||||dS)aSets the id attribute if it is not already set. The id consists of a prefix and an appended random integer of length size. Args: prefix (str, optional): the prefix of the new ID. Defaults to the tag name. size (Optional[int], optional): number of digits of the second part of the id. If None, the length is chosen based on the amount of existing objects. Defaults to None. .. versionchanged:: 1.2 The default of this value has been changed from 4 to None. backlinks (bool, optional): Whether to update the links in existing objects that reference this element. Defaults to False. blacklist (List[str], optional): An additional list of ids that are not allowed to be used. This is useful when bulk inserting objects. Defaults to None. .. versionadded:: 1.2 N)rr)r)rdset_idroot get_unique_id)r<rrrrs r- set_random_idzBaseElement.set_random_idsY4%nT& I # #F # K K      r/r9levelsintc|||||dkr0|D]/}t|dr|||dz |.dSdS)aSame as set_random_id, but will apply also to children The id consists of a prefix and an appended random integer of length size. Args: prefix (str, optional): the prefix of the new ID. Defaults to the tag name. levels (int, optional): the depth of the tree traversion, if negative, no limit is imposed. Defaults to -1. backlinks (bool, optional): Whether to update the links in existing objects that reference this element. Defaults to False. blacklist (List[str], optional): An additional list of ids that are not allowed to be used. This is useful when bulk inserting objects. Defaults to None. .. versionadded:: 1.2 )rrrrset_random_idsr)rrrN)rhasattrr)r<rrrrrs r-rzBaseElement.set_random_idss, &ISSS Q;;  5"233((%fqjI) ;  r/c*|Sr))get_idrFs r-rGzBaseElement.-s r/rrdcd|jvr||j|d}|dkrd|z}|dkrd|d}|S)aGet the id for the element, will set a new unique id if not set. as_url - If set to 1, returns #{id} as a string If set to 2, returns url(#{id}) as a string Args: as_url (int, optional): - If set to 1, returns #{id} as a string - If set to 2, returns url(#{id}) as a string. Defaults to 0. .. versionadded:: 1.1 Returns: str: formatted id idr#rzurl())rerr>rl)r<as_urleids r-rzBaseElement.get_id0sc$ t{ " "   tx ( ( (hhtnn A::)C A::---C r/c|dd}|d||r|r|j|D] }||_ dD]J}|j||D]+}|||d,K|j|D]!}|j||dSdSdS)zASet the id and update backlinks to xlink and style urls if neededrN) clip-pathmask) attributer ) rlrcrgetElementsByHrefhrefrgetElementsByStyleUrlrI update_urls)r<new_idrold_idr0rhs r-rzBaseElement.set_idKs$%% v  7 7 33F;; ! !  - 3 3 I77$7OO33DHHT4;;q>>22223 77?? 7 7 &&vv6666 7 7 7 7  7 7r/c||}}|||}}|t|tstd|S)z9Get the root document element from any element descendentNz/Element fragment does not have a document root!) getparentrurr)r<rparents r-rzBaseElement.rootXsZTf !6#3#3#5#5&D $ 344 S QRR R r/c||}|N|tj|}|}|r|d|n|||S)aGet or create the given xpath, pre/append new node if not found. .. versionchanged:: 1.1 The ``nodeclass`` attribute is optional; if not given, it is looked up using :func:`~inkex.elements._parser.NodeBasedLookup.find_class`Nr)findoner" find_classinsertr)r<xpath nodeclassr`nodes r- get_or_createzBaseElement.get_or_createcsq ||E"" < +6u== 9;;D " At$$$$ D!!! r/cdt|jd|DS)zWalks the element tree and yields all elements, parent first .. versionchanged:: 1.1 The ``*types`` attribute was removed cJg|] }t|ttf|!Sr5)rur%rd)rPrms r- z+BaseElement.descendants..~s=   g S'9::    r/)r!riterrFs r- descendantszBaseElement.descendantsts? I  #yy{{      r/r5cVt|j|||S)a Walk the parents and yield all the ancestor elements, parent first Args: elem (BaseElement, optional): If provided, it will stop at the last common ancestor. Defaults to None. .. versionadded:: 1.1 stop_at (tuple, optional): If provided, it will stop at the first parent that is in this list. Defaults to (). .. versionadded:: 1.1 Returns: ElementList: list of ancestors )r0stop_at)r!r _ancestors)r<r0rs r- ancestorszBaseElement.ancestorss&&49doo4o&Q&QRRRr/c#Kt|tr!t|}|D] }|V||vrdSdSr))rur%listr iterancestors)r<r0rrs r-rzBaseElement._ancestorsst dK ( ( -4>>++,,G((**  FLLL  !  r/c'RK|rt||r|V|d}|ut|j|t|j|z}|D]%}t |dr|j|D]}|V$dSdS)zSGet elements which link back to this element, like ancestors but via xlinksrNr)rurlrrrrrr)r<typesmy_idelemsr0rs r-rzBaseElement.backlinkss  4// JJJ  44U;;<>>r/cD||}|r|dndS)z:Gets a single element from the given xpath or returns NonerN)r)r<rel_lists r-rzBaseElement.findones&**U##$.wqzz$.r/c|)||dSdS)z&Delete this node from it's parent nodeN)rremoverFs r-deletezBaseElement.deletes> >>   ' NN   # #D ) ) ) ) ) ( 'r/ctd|D}|D])}|rt||r||*dS)zARemove all children or child types .. versionadded:: 1.1c3>K|]}tj|VdSr))r"r)rPts r- z)BaseElement.remove_all..s-CCo033CCCCCCr/N)tuplerur)r<rrs r- remove_allzBaseElement.remove_allseCCUCCCCC # #E #Jue44 # E""" # #r/c2|||ds>|dr)|d|d|js|jr |j|_||S)z+Replace this element with the given elementr)addnextrlrclabelrr<r0s r- replace_withzBaseElement.replace_withs Txx~~ +$((4.. + HHT488D>> * * *z $dj $DJ  r/cPt|}|dd|S)z(Make a copy of the element and return itrN)rrcrs r-rzBaseElement.copys&~~ t r/c|}||||S)zLike copy(), but the copy stays in the tree and sets a random id on the duplicate. .. versionchanged:: 1.2 A random id is also set on all the duplicate's descendants)rrrrs r- duplicatezBaseElement.duplicates: yy{{ T  r/c`t|jdddS)N}r)maxsplitr9)rdr;rrFs r-__str__zBaseElement.__str__s*48}}""3"33B77r/c|d}|sdS|j|dS)zvReturns the referred-to element if available .. versionchanged:: 1.1 A setter for href was added. xlink:hrefNr)rlrgetElementByIdstripr<refs r-rzBaseElement.hrefsB hh|$$ 4y'' #777r/ct|tr|}|dd|zdS)zSet the href objectrrN)rur%rrcrs r-rzBaseElement.hrefsA dK ( ( !;;==D sTz*****r/c.|ddS)zReturns the inkscape labelinkscape:labelNrlrFs r-rzBaseElement.labelsxx($///r/cL|dt|dS)zSets the inkscape labelrN)rcrdr<rrs r-rzBaseElement.labels% !3u::.....r/c6|dddkS)zSReturn true if this element is sensitive in inkscape .. versionadded:: 1.1sodipodi:insensitiveNtruerrFs r- is_sensitivezBaseElement.is_sensitive sxx.55??r/cB|dddg|dS)zGSet the sensitivity of the element/layer .. versionadded:: 1.1rrN)rc)r< sensitives r- set_sensitivezBaseElement.set_sensitives( '&$ )BCCCCCr/c> |jjS#t$rYdSwxYw)zXReturn the unit being used by the owning document, cached .. versionadded:: 1.1px)runitrrFs r-rzBaseElement.units3  9> !   44 s  rc"t||S)z[Convert a value given in user units (px) the given unit type .. versionadded:: 1.2r)rrto_units r-to_dimensionalzBaseElement.to_dimensional"s E7+++r/c"t|dS)zJConvert a length value into user units (px) .. versionadded:: 1.2rr)rrs r-to_dimensionlesszBaseElement.to_dimensionless)s E4(((r/c0t|||jS)aConvert a unit value to a given unit. If the value does not have a unit, "Document" units are assumed. "Document units" are an Inkscape-specific concept. For most use-cases, :func:`to_dimensional` is more appropriate. .. versionadded:: 1.1)ryrr)r<rrr s r-uutounitzBaseElement.uutounit0s E7DI>>>>r/c,t||jS)aiConvert a unit value into document units. "Document unit" is an Inkscape-specific concept. For most use-cases, :func:`viewport_to_unit` (when the size of an object given in viewport units is needed) or :func:`to_dimensionless` (when the equivalent value without unit is needed) is more appropriate. .. versionadded:: 1.1rrs r-unittouuzBaseElement.unittouu8sE49---r/cn||||jjz|S)zConverts a length value to viewport units, as defined by the width/height element on the root (i.e. applies the equivalent transform of the viewport) .. versionadded:: 1.2r r requivalent_transform_scaler<rrrs r-unit_to_viewportzBaseElement.unit_to_viewportB: ""  ! !% ( (49+O OQU   r/cn||||jjz |S)zConverts a length given on the viewport to the specified unit in the user coordinate system .. versionadded:: 1.2rrs r-viewport_to_unitzBaseElement.viewport_to_unitKrr/c,t||jS)zYAdd document unit when no unit is specified in the string. .. versionadded:: 1.1)rrrs r-add_unitzBaseElement.add_unitTs5$),,,r/c*tj|S)aReturns the cascaded style of an element (all rules that apply the element itself), based on the stylesheets, the presentation attributes and the inline style using the respective specificity of the style. see https://www.w3.org/TR/CSS22/cascade.html#cascading-order .. versionadded:: 1.2 Returns: Style: the cascaded style )rcascaded_stylerFs r-rzBaseElement.cascaded_styleZs#D)))r/c*tj|S)zReturns the specified style of an element, i.e. the cascaded style + inheritance, see https://www.w3.org/TR/CSS22/cascade.html#specified-value. Returns: Style: the specified style .. versionadded:: 1.2 )rspecified_stylerFs r-rzBaseElement.specified_styleis$T***r/ct}|D]G}|tvrrD NAMESPACEr#PARSERrrrrTrUrYrpxml_pathrdesctitlersrvrlrcr@rfrrrrrrrrrrrrrrrrrrrrrrrrrsetterrrrr staticmethodr r rrrrrrrr%r' __classcell__)r=s@r-r%r%2s33000[H ++++X+ [ ??@@I" FF i % GW% M L JJXJJJXJx8899H"xEEFFH ?:t 4 4 4D OK 6 6 6EMMM* - - - - - 1 1 1 1 1 1 , , , , ,   5555   X    X ???<<<!%")-      D!%)- < (-- . .CS6 7 7 7 7X"   "SSSS* $ $ $),====== #&?????? /// *** ###   888 88X8 [++[+ 00X0 \//\/@@@ DDDDX,,,\, ))\) ????...        --- * * * + + +   r/ceZdZdZedZejdZedZejdZddZd Z d Z d Z dd Z ddZ dZdZd S) ShapeElementz:Elements which have a visible representation on the canvascDt|S)zJGets the outline or path of the element, this may be a simple bounding box)rget_pathrFs r-pathzShapeElement.pathsDMMOO$$$r/c0||dSr))set_pathr<r:s r-r:zShapeElement.paths dr/ch|d}|sdS|j|S)zBGets the clip path element (if any) .. versionadded:: 1.1rN)rlrrrs r-clipzShapeElement.clips8 hh{## 4y'',,,r/cZ|d|ddS)Nrr )r)rcrrs r-r?zShapeElement.clips* dkkk3344444r/r2rc2td|jd)zAGenerate a path for this object which can inform the bounding boxz$Path should be provided by svg elem rk)NotImplementedErrorrprFs r-r9zShapeElement.get_paths$! C4= C C C   r/c8td|jd|d)z*Set the path for this object (if possible)z%Path can not be set on this element: z <- rk)rorpr=s r-r<zShapeElement.set_paths, NDM N Nt N N N   r/cddlm}|}|j|_||_|j|_|S)z(Replace this element with a path elementr) PathElement) _polygonsrEr:effective_stylerIrH)r<rEr0s r-to_path_elementzShapeElement.to_path_elementsI******{}}I ))++  r/c|jS)z5Without parent styles, what is the effective style is)rIrFs r-rGzShapeElement.effective_styles zr/Nc||}|j}|||S||t||jzzS)z|BoundingBox of the shape .. versionchanged:: 1.1 result adjusted for element's clip path if applicable.) shape_boxr? bounding_boxrrH)r<rHrKr?s r-rLzShapeElement.bounding_boxsT NN9-- y <9, 4,,Yy-A-ADN-RSSSSr/c|j}|dur(||}n1||j}|r||}|S)zBoundingBox of the unclipped shape .. versionadded:: 1.1 Previous :func:`bounding_box` function, returning the bounding box without computing the effect of a possible clip.T)r: to_absoluterHr'rL)r<rHr:s r-rKzShapeElement.shape_boxsy$$&&   >>$"9"9";";<>$.11D 1~~i00  """r/c|jdddkrdSt|jddsdSdS)zUReturns false if the css says this object is invisible .. versionadded:: 1.1displayr7noneFopacityg?T)rIrlfloatrFs r- is_visiblezShapeElement.is_visiblesN :>>)R ( (F 2 25TZ^^Is3344 5tr/c|}|d}|d}t|}||dzS|ddkr||dzdzS||S) zXReturns the specified value of line-height, in user units .. versionadded:: 1.1z font-sizez line-heightNg333333?r%rg{Gz?)rrr )r<rI font_size line_heightparseds r-get_line_height_uuzShapeElement.get_line_height_uus$$&&E+&& eM** K(( >s? " !9  vay(4/ /$$[111r/)r2rr))r\r)r*r+r-r:r3r?r9r<rHrGrLrKrTrZr5r/r-r7r7sDD %%X% [[--X- [55[5        T T T T####  2 2 2 2 2r/r7N)3r+ __future__rrrtypingrrrrr r lxmlr interfaces.IElementr rbaserpathsrstylesrr transformsrrutilsrunitsrrr_utilsrrrrr propertiesrr _selectedr!_parserr"r#r$r%ryr7r5r/r-ris, #"""""@@@@@@@@@@@@@@@@CCCCCCCC!!!!!!########////////!!!!!!9999999999BBBBBBBBBBBBBB77777777""""""00000000 GC}%%%U U U U U ,U U U p&f2f2f2f2f2;f2f2f2f2f2r/