o bL@sddlmZddlmZddlmZmZmZmZm Z m Z ddl m Z m Z ddlmZddlmZddlmZmZmZddlmZdd lmZdd lmZdd lmZdd lmZdd l m!Z!m"Z"m#Z#m$Z$ddl%m&Z&m'Z'm(Z(m)Z)ddl*m+Z+ddl,m-Z-m.Z.e GdddZ/dS)) annotations)deepcopy)AnyIteratorListMappingOptionalcast)definefield) Transform) AbstractPen)AbstractPointPenPointToSegmentPenSegmentToPointPen)Anchor) Component)Contour) Guideline)Image)Lib _convert_Lib_get_lib_set_lib) BoundingBox _object_lib getBoundsgetControlBounds GlyphPointPen)GlyphSet HasIdentifierc@seZdZUdZdZded<dZded< dZded< ee d Z d ed < ee d Z d ed <ee edZded< dZded< ee d Zded<ee d Zded< ee d Zded< ee d Zded<dddZdd d!Zdd$d%Zdd'd(Zdd*d+ZeeeZedd-d.Zejdd1d.Zedd3d4Z e jdd5d4Z edd7d8Z!edd:d;Z"e"jddZ#e#jddAd>Z#ddEdFZ$ddGdHZ%ddIdJZ&ddKdLZ'ddMdNZ(ddOdPZ)ddSdTZ*ddWdXZ+dd[d\Z,dd]d^Z-ddd`daZ.ddcddZ/ddgdhZ0ddkdlZ1ddodpZ2ddqdrZ3ddsdtZ4eddudvZ5e5jddwdvZ5eddydzZ6e6jdd{dzZ6ddddZ7ddddZ8ddddZ9ddddZ:ddddZ;ddddZddddZ?ddddZ@dS)Glypha0Represents a glyph, containing contours, components, anchors and various other bits of data concerning it. See http://unifiedfontobject.org/versions/ufo3/glyphs/glif/. Behavior: The Glyph object has list-like behavior. This behavior allows you to interact with contour data directly. For example, to get a particular contour:: contour = glyph[0] To iterate over all contours:: for contour in glyph: ... To get the number of contours:: contourCount = len(glyph) To check if a :class:`.Contour` object is in glyph:: exists = contour in glyph To interact with components or anchors in a similar way, use the :attr:`.Glyph.components` and :attr:`.Glyph.anchors` attributes. Nz Optional[str]_namerfloatwidthheight)factoryz List[int]unicodesr_image)r'Z converterr_libnotez List[Anchor]_anchorszList[Component] componentsz List[Contour]contourszList[Guideline] _guidelinesreturnintcC t|jSN)lenr.selfr77/usr/lib/python3/dist-packages/ufoLib2/objects/glyph.py__len__U z Glyph.__len__indexrcCs |j|Sr3r.)r6r;r7r7r8 __getitem__Xr:zGlyph.__getitem__contourboolcCs ||jvSr3r<r6r>r7r7r8 __contains__[r:zGlyph.__contains__Iterator[Contour]cCr2r3)iterr.r5r7r7r8__iter__^r:zGlyph.__iter__strcCs8d|jj|jj|jdurd|jdndtt|S)Nz<{}.{} {}at {}>'z' )format __class__ __module____name__r#hexidr5r7r7r8__repr__as  zGlyph.__repr__ list[Anchor]cC|jS)aThe list of anchors the glyph contains. Getter: Returns a list of anchors the glyph contains. Modifications of the list modify the Glyph object. Setter: Clears current anchors and sets the new ones. r,r5r7r7r8anchorsk z Glyph.anchorsvalueNonecC ||D]}||qdSr3) clearAnchors appendAnchor)r6rTanchorr7r7r8rRx list[Guideline]cCrP)aThe list of guidelines the glyph contains. Getter: Returns a list of guidelines the glyph contains. Modifications of the list modify the Glyph object. Setter: Clears current guidelines and sets the new ones. r/r5r7r7r8 guidelines~rSzGlyph.guidelinescCrVr3)clearGuidelinesappendGuideline)r6rT guideliner7r7r8r]rZ str | NonecCrP)zThe name of the glyph.)r#r5r7r7r8namesz Glyph.name int | NonecCs|jr|jdSdS)aYThe first assigned Unicode code point or None. See http://unifiedfontobject.org/versions/ufo3/glyphs/glif/#unicode. Setter: Sets the value to be the first of the assigned Unicode code points. Will remove a duplicate if exists. Will clear the list of Unicode points if value is None. rN)r(r5r7r7r8unicodes z Glyph.unicodecCsp|dur g|_dS|jr0|jd|krdSz|j|Wn ty&Ynw|jd|dS|j|dS)Nr)r(remove ValueErrorinsertappendr6rTr7r7r8rds  cCrP)zThe background image reference associated with the glyph. See http://unifiedfontobject.org/versions/ufo3/glyphs/glif/#image. Setter: Sets the background image reference. Clears it if value is None. )r)r5r7r7r8images z Glyph.imagerj Image | Mapping[str, Any] | Nonec Csn|dur |jdSt|tr||_dSt|dt|d|d|d|d|d|d|dd |_dS) NfileNameZxScaleZxyScaleZyxScaleZyScaleZxOffsetZyOffsetcolor)rlZtransformationrm)r)clear isinstancerr get)r6rjr7r7r8rjs    objectr!dict[str, Any]cCs t|j|S)a$Return the lib for an object with an identifier, as stored in a glyph's lib. If the object does not yet have an identifier, a new one is assigned to it. If the font lib does not yet contain the object's lib, a new one is inserted and returned. .. doctest:: >>> from ufoLib2.objects import Font, Guideline >>> font = Font() >>> glyph = font.newGlyph("a") >>> glyph.guidelines = [Guideline(x=100)] >>> guideline_lib = glyph.objectLib(glyph.guidelines[0]) >>> guideline_lib["com.test.foo"] = 1234 >>> guideline_id = glyph.guidelines[0].identifier >>> assert guideline_id is not None >>> assert glyph.lib["public.objectLibs"][guideline_id] is guideline_lib )rlib)r6rqr7r7r8 objectLibs zGlyph.objectLibcCs>|jdd=|jdd=|jdd=|jdd=|jdS)zRClears out anchors, components, contours, guidelines and image references.N)r,r-r.r/rjrnr5r7r7r8rns    z Glyph.clearcC|jdd=dS)zClears out anchors.NrQr5r7r7r8rWzGlyph.clearAnchorscCru)zClears out contours.Nr<r5r7r7r8 clearContoursrvzGlyph.clearContourscCru)zClears out components.N)r-r5r7r7r8clearComponentsrvzGlyph.clearComponentscCru)zClears out guidelines.Nr\r5r7r7r8r^rvzGlyph.clearGuidelines componentrcCs|j|dS)zGRemoves :class:`.Component` object from the glyph's list of components.N)r-re)r6ryr7r7r8removeComponentrvzGlyph.removeComponentrYAnchor | Mapping[str, Any]cCHt|tst|tstddt|jtdi|}|j|dS)zAppends an :class:`.Anchor` object to glyph's list of anchors. Args: anchor: An :class:`.Anchor` object or mapping for the Anchor constructor. z,Expected Anchor object or a Mapping for the zAnchor constructor, found Nr7)rorr TypeErrortyperKrRrh)r6rYr7r7r8rXs  zGlyph.appendAnchorr`Guideline | Mapping[str, Any]cCr|)zAppends a :class:`.Guideline` object to glyph's list of guidelines. Args: guideline: A :class:`.Guideline` object or a mapping for the Guideline constructor. z/Expected Guideline object or a Mapping for the zGuideline constructor, found Nr7)rorrr}r~rKr/rh)r6r`r7r7r8r_s  zGlyph.appendGuidelinecCs.t|tstdt|j|j|dS)z?Appends a :class:`.Contour` object to glyph's list of contours.zExpected Contour, found N)rorr}r~rKr.rhr@r7r7r8 appendContour&s zGlyph.appendContourrbcCst|}|dur ||_|S)zPReturns a new Glyph (deep) copy, optionally override the new glyph name.N)rr#)r6rbotherr7r7r8copy,sz Glyph.copyglyphcCsz|j|_|j|_t|j|_t|j|_|j|_t|j|_t|j|_t|j |_ | | | }| |dS)zDeep-copies everything from the other glyph into self, except for the name. Existing glyph data is overwritten. |defcon_compat| N)r%r&listr(rrjr+rsrRr]rwrx getPointPen drawPoints)r6rpointPenr7r7r8copyDataFromGlyph4s     zGlyph.copyDataFromGlyphdeltatuple[float, float]cCsF|jD]}||q|jD]}||q|jD]}||qdS)z@Moves all contours, components and anchors by (x, y) font units.N)r.mover-rR)r6rr>ryrYr7r7r8rKs      z Glyph.movepenr cCst|}||dS)zDraws glyph into given pen.N)rr)r6rrr7r7r8drawXsz Glyph.drawrrcCs0|jD]}||q|jD]}||qdS)z+Draws points of glyph into given point pen.N)r.rr-)r6rr>ryr7r7r8r^s    zGlyph.drawPointscCst|}|S)z+Returns a pen for others to draw into self.)rr)r6rr7r7r8getPenes z Glyph.getPencCs t|}|S)z8Returns a point pen for others to draw points into self.r)r6rr7r7r8rjszGlyph.getPointPencCttt|jdS)a5The color assigned to the glyph. See http://unifiedfontobject.org/versions/ufo3/glyphs/glif/#publicmarkcolor. Getter: Returns the mark color or None. Setter: Sets the mark color. If value is None, deletes the key from the lib if present. public.markColor)r rrErsrpr5r7r7r8 markColorq zGlyph.markColorcC0|dur ||jd<dSd|jvr|jd=dSdS)Nrrsrir7r7r8r    float | NonecCr)aEThe vertical origin of the glyph. See http://unifiedfontobject.org/versions/ufo3/glyphs/glif/#publicverticalorigin. Getter: Returns the vertical origin or None. Setter: Sets the vertical origin. If value is None, deletes the key from the lib if present. public.verticalOrigin)r rr$rsrpr5r7r7r8verticalOriginrzGlyph.verticalOrigincCr)Nrrrir7r7r8rrlayerGlyphSet | NoneBoundingBox | NonecC |dur |jr tdt||S)aReturns the (xMin, yMin, xMax, yMax) bounding box of the glyph, taking the actual contours into account. Args: layer: The layer of the glyph to look up components, if any. Not needed for pure-contour glyphs. N1layer is required to compute bounds of components)r-r}rr6rr7r7r8r zGlyph.getBoundscCr)a Returns the (xMin, yMin, xMax, yMax) bounding box of the glyph, taking only the control points into account. Args: layer: The layer of the glyph to look up components, if any. Not needed for pure-contour glyphs. Nr)r-r}rrr7r7r8rrzGlyph.getControlBoundscCs||}|dur dS|jS)zReturns the the space in font units from the point of origin to the left side of the glyph. Args: layer: The layer of the glyph to look up components, if any. Not needed for pure-contour glyphs. N)rxMinr6rboundsr7r7r8 getLeftMargins zGlyph.getLeftMargincCsH||}|dur dS||j}|r"|j|7_||dfdSdS)a/Sets the the space in font units from the point of origin to the left side of the glyph. Args: value: The desired left margin in font units. layer: The layer of the glyph to look up components, if any. Not needed for pure-contour glyphs. Nr)rrr%r)r6rTrrdiffr7r7r8 setLeftMargins  zGlyph.setLeftMargincCs"||}|dur dS|j|jS)zReturns the the space in font units from the glyph's advance width to the right side of the glyph. Args: layer: The layer of the glyph to look up components, if any. Not needed for pure-contour glyphs. N)rr%xMaxrr7r7r8getRightMargins  zGlyph.getRightMargincCs&||}|dur dS|j||_dS)a7Sets the the space in font units from the glyph's advance width to the right side of the glyph. Args: value: The desired right margin in font units. layer: The layer of the glyph to look up components, if any. Not needed for pure-contour glyphs. N)rrr%)r6rTrrr7r7r8setRightMargins zGlyph.setRightMargincCs8||}|dur dS|jdur|jS|j|j|jS)zReturns the the space in font units from the bottom of the canvas to the bottom of the glyph. Args: layer: The layer of the glyph to look up components, if any. Not needed for pure-contour glyphs. NrrZyMinr&rr7r7r8getBottomMargins  zGlyph.getBottomMargincCsd||}|dur dS|jdur|j}|j|_n |j|j|j}||}|r0|j|7_dSdS)a3Sets the the space in font units from the bottom of the canvas to the bottom of the glyph. Args: value: The desired bottom margin in font units. layer: The layer of the glyph to look up components, if any. Not needed for pure-contour glyphs. Nrr6rTrrZoldValuerr7r7r8setBottomMargins   zGlyph.setBottomMargincCs8||}|dur dS|jdur|j|jS|j|jS)zReturns the the space in font units from the top of the canvas to the top of the glyph. Args: layer: The layer of the glyph to look up components, if any. Not needed for pure-contour glyphs. Nrrr&ZyMaxrr7r7r8 getTopMargins    zGlyph.getTopMargincCsl||}|dur dS|jdur|j|j}n|j|j}||}||kr4|j||_|j|7_dSdS)a*Sets the the space in font units from the top of the canvas to the top of the glyph. Args: value: The desired top margin in font units. layer: The layer of the glyph to look up components, if any. Not needed for pure-contour glyphs. Nrrr7r7r8 setTopMargin(s    zGlyph.setTopMargin)r0r1)r;r1r0r)r>rr0r?)r0rB)r0rE)r0rO)rTrOr0rU)r0r[)rTr[r0rU)r0ra)r0rc)rTrcr0rU)r0r)rjrkr0rU)rqr!r0rr)r0rU)ryrr0rU)rYr{r0rU)r`rr0rU)r>rr0rUr3)rbrar0r")rr"r0rU)rrr0rU)rr r0rU)rrr0rU)r0r )r0r)rTrar0rU)r0r)rTrr0rU)rrr0r)rrr0r)rTr$rrr0rU)ArKrJ __qualname____doc__r#__annotations__r%r&r rr(rr)rrr*r+r,r-r.r/r9r=rArDrNpropertyrrrsrRsetterr]rbrdrjrtrnrWrwrxr^rzrXr_rrrrrrrrrrrrrrrrrrrrr7r7r7r8r"s                                            r"N)0Z __future__rrrtypingrrrrrr attrr r ZfontTools.misc.transformr ZfontTools.pens.basePenr ZfontTools.pens.pointPenrrrZufoLib2.objects.anchorrZufoLib2.objects.componentrZufoLib2.objects.contourrZufoLib2.objects.guidelinerZufoLib2.objects.imagerZufoLib2.objects.librrrrZufoLib2.objects.miscrrrrZufoLib2.pointPens.glyphPointPenrZufoLib2.typingr r!r"r7r7r7r8s$