^ jdg.dZddlmZddlZddlZddlmZmZddlm Z m Z m Z ddl m Z ddlmZe r ddlmZdd lmZeed oejZd ZGd d eZGdde jZedededGddeZGddeZd$dZGddejZ Gd d!ejZ!Gd"d#ejZ"e"Z#dS)%aFormatted and unformatted document interfaces used by text layout. Abstract representation ======================= Styled text in pyglet is represented by one of the :py:class:`~pyglet.text.document.AbstractDocument` classes, which manage the state representation of text and style independently of how it is loaded or rendered. A document consists of the document text (a Unicode string) and a set of named style ranges. For example, consider the following (artificial) example:: 0 5 10 15 20 The cat sat on the mat. +++++++ +++++++ "weight" ++++++ "italic" If this example were to be rendered, "The cat" and "the mat" would have a weight set ("bold", "thin", etc.), and "on the" would be in italics. Note that the second "the" is both weighted and italic. The document styles recorded for this example would be a specific ``"weight"`` over ranges (0-7) & (15-22) and ``"italic"`` over range (12-18). Overlapping styles are permitted; unlike HTML and other structured markup, the ranges need not be nested. The document has no knowledge of the semantics of ``"weight"`` names or ``"italic"``, it stores only the style names. The pyglet layout classes give meaning to these style names in the way they are rendered; but you are also free to invent your own style names (which will be ignored by the layout classes). This can be useful to tag areas of interest in a document, or maintain references back to the source material. As well as text, the document can contain arbitrary elements represented by :py:class:`~pyglet.text.document.InlineElement`. An inline element behaves like a single character in the document, but can be rendered by the application. Paragraph breaks ================ Paragraph breaks are marked with a "newline" character (U+0010). The Unicode paragraph break (U+2029) can also be used. Line breaks (U+2028) can be used to force a line break within a paragraph. See Unicode recommendation UTR #13 for more information: https://www.unicode.org/standard/reports/tr13/tr13-5.html. Document classes ================ Any class implementing :py:class:`~pyglet.text.document.AbstractDocument` provides an interface to a document model as described above. In theory a structured document such as HTML or XML could export this model, though the classes provided by pyglet implement only unstructured documents. The :py:class:`~pyglet.text.document.UnformattedDocument` class assumes any styles set are set over the entire document. So, regardless of the range specified when setting a ``"weight"`` style attribute, for example, the entire document will receive that style. The :py:class:`~pyglet.text.document.FormattedDocument` class implements the document model directly, using the `RunList` class to represent style runs efficiently. Style attributes ================ The following character style attribute names are recognised by pyglet: ``font_name`` Font family name, as given to :py:func:`pyglet.font.load`. ``font_size`` Font size, in points. ``weight`` String. ``italic`` Boolean. ``underline`` 4-tuple of ints in range (0, 255) giving RGBA underline color, or None (default) for no underline. ``kerning`` Additional space to insert between glyphs, in points. Defaults to 0. ``baseline`` Offset of glyph baseline from line baseline, in points. Positive values give a superscript, negative values give a subscript. Defaults to 0. ``color`` 4-tuple of ints in range (0, 255) giving RGBA text color ``background_color`` 4-tuple of ints in range (0, 255) giving RGBA text background color; or ``None`` for no background fill. The following paragraph style attribute names are recognised by pyglet. Note that paragraph styles are handled no differently from character styles by the document: it is the application's responsibility to set the style over an entire paragraph, otherwise results are undefined. ``align`` ``left`` (default), ``center`` or ``right``. ``indent`` Additional horizontal space to insert before the first ``leading`` Additional space to insert between consecutive lines within a paragraph, in points. Defaults to 0. ``line_spacing`` Distance between consecutive baselines in a paragraph, in points. Defaults to ``None``, which automatically calculates the tightest line spacing for each line based on the font ascent and descent. ``margin_left`` Left paragraph margin, in pixels. ``margin_right`` Right paragraph margin, in pixels. ``margin_top`` Margin above paragraph, in pixels. ``margin_bottom`` Margin below paragraph, in pixels. Adjacent margins do not collapse. ``tab_stops`` List of horizontal tab stops, in pixels, measured from the left edge of the text layout. Defaults to the empty list. When the tab stops are exhausted, they implicitly continue at 50 pixel intervals. ``wrap`` Boolean. If True (the default), text wraps within the width of the layout. Other attributes can be used to store additional style information within the document; it will be ignored by the built-in text classes. All style attributes (including those not present in a document) default to ``None`` (including the so-called "boolean" styles listed above). The meaning of a ``None`` style is style- and application-dependent. ) annotationsN)ABCabstractmethod) TYPE_CHECKINGAny Generator)event)runlist)Font) TextLayoutis_pyglet_doc_run indeterminateceZdZUdZded<ded<ded<ded<d&d Zed'd Zed(dZ ed)dZ ed*dZ ed+d Z ed,d!Z ed-d"Zed.d#Zed/d$Zd%S)0 InlineElementaArbitrary inline element positioned within a formatted document. Elements behave like a single glyph in the document. They are measured by their horizontal advance, ascent above the baseline, and descent below the baseline. The pyglet layout classes reserve space in the layout for elements and call the element's methods to ensure they are rendered at the appropriate position. If the size of an element (any of the ``advance``, ``ascent``, or ``descent`` variables) is modified it is the application's responsibility to trigger a reflow of the appropriate area in the affected layouts. This can be done by forcing a style change over the element's position. intadvancedescentascent int | None _positionreturnNonec>||_||_||_d|_dS)a=Initialize the element. Args: ascent: Ascent of the element above the baseline, in pixels. descent: Descent of the element below the baseline, in pixels. Typically negative. advance: Width of the element, in pixels. N)rrrr)selfrrrs O/home/agentuser/manim-venv/lib/python3.11/site-packages/pyglet/text/document.py__init__zInlineElement.__init__s$   c|jS)zCharacter position within the document. Determined by the layout it is in. Will return ``None`` if it has not been placed. )rrs rpositionzInlineElement.positions ~rlayoutr xfloatyzline_xline_yrotationvisibleboolanchor_xanchor_yc dSN) rr!r"r$r%r&r'r(r)r+r,s rplacezInlineElement.places  rcdSr.r/)rr"r$r%s rupdate_translationz InlineElement.update_translation rcolor list[int]cdSr.r/)rr4s r update_colorzInlineElement.update_colorr3r translate_x translate_ycdSr.r/)rr8r9s rupdate_view_translationz%InlineElement.update_view_translationr3rcdSr.r/)rr(s rupdate_rotationzInlineElement.update_rotationr3rcdSr.r/)rr)s rupdate_visibilityzInlineElement.update_visibilityr3rcdSr.r/)rr+r,s r update_anchorzInlineElement.update_anchorr3rcdSr.r/)rr!s rremovezInlineElement.remover3rN)rrrrrrrr)rr)r!r r"r#r$r#r%r#r&r#r'r#r(r#r)r*r+r#r,r#rr)r"r#r$r#r%r#rr)r4r5rr)r8r#r9r#rr)r(r#rr)r)r*rr)r+r#r,r#rr)r!r rr)__name__ __module__ __qualname____doc____annotations__rpropertyr rr0r2r7r;r=r?rArCr/rrrrs}LLLLLLKKK X   ^    ^    ^    ^    ^    ^    ^    ^   rrceZdZUdZejdZded<ejdZded<d4d5fd Z e d6d Z e j d5dZ d7dZ d7dZed8dZed9d:dZd;dZedd"Zd#>??9e s??& & rNdpircdS)aGet a style iterator over the `pyglet.font.Font` instances used in the document. The font instances are created on-demand by inspection of the ``font_name``, ``font_size``, ``weight`` and ``italic`` style attributes. Args: dpi: Optional resolution to construct fonts at. :see: :py:func:`~pyglet.font.load`. Nr/rr|s r get_font_runszAbstractDocument.get_font_runsOrnrr cdS)a7Get the font instance used at the given position. :see: `get_font_runs` Args: position: Character position of document to query. dpi: Optional resolution to construct fonts at. :see: :py:func:`~pyglet.font.load`. Nr/)rr r|s rget_fontzAbstractDocument.get_font]rnr attributesdict[str, Any] | Nonecb|||||d||dS)aInsert text into the document. Dispatches an :py:meth:`~pyglet.text.document.AbstractDocument.on_insert_text` event. Args: start: Character insertion point within document. text: Text to insert. attributes: Optional dictionary giving named style attributes of the inserted text. on_insert_textN) _insert_textdispatch_event)rrcrOrs rrUzAbstractDocument.insert_textks; %z222 ,eT:::::rcd|jd|||j|df|_t|}|jD]&}|jJ|j|kr|xj|z c_'dS)NrN)joinrSr\rTr)rrcrOrlen_textelements rrzAbstractDocument._insert_text{sWWdj%0$ 5668JKLL t99~ . .G$000 E))!!X-!! . .rc`||||d||dS)aDelete text from the document. Dispatches an :py:meth:`on_delete_text` event. Args: start: Starting character position to delete from. end: Ending character position to delete to (exclusive). on_delete_textN) _delete_textrrrcrrs rr[zAbstractDocument.delete_texts9 %%%% ,eS99999rc*t|jD]Y}|jJ||jcxkr|krnn|j|;|j|kr|xj||z zc_Z|jd||j|dz|_dSr.)listrTr rrCrS)rrcrrrs rrzAbstractDocument._delete_textsDN++ 3 3G#///)////C/////%%g...."c))!!cEk2!!Z'$*STT*:: rrrc|j Jd||d|||_|j||jddS)aInsert a element into the document. See the :py:class:`~pyglet.text.document.InlineElement` class documentation for details of usage. Args: position: Character insertion point within document. element: Element to insert. attributes: dict Optional dictionary giving named style attributes of the inserted text. Nz!Element is already in a document.c|jSr.r )ds rz1AbstractDocument.insert_element..s!*r)key)r rUrrTappendsort)rr rrs rinsert_elementzAbstractDocument.insert_elementsw'')L''' 4444$ g&&&  4 455555rc\|jD]}|j|kr|cSd|}t|)zGet the element at a specified position. Args: position: Position in the document of the element. zNo element at position )rTr RuntimeError)rr rmsgs r get_elementzAbstractDocument.get_elementsL~  G H,,-2223rdict[str, Any]cd|||||d|||dS)aSet text style of a range between start and end of the document. Dispatches an :py:meth:`~pyglet.text.document.AbstractDocument.on_style_text` event. Args: start: Starting character position. end: Ending character position (exclusive). attributes: Dictionary giving named style attributes of the text. on_style_textN) _set_stylerrrcrrrs r set_stylezAbstractDocument.set_styles: sJ/// OUCDDDDDrcdSr.r/rs rrzAbstractDocument._set_styler3rc||}||}|||||d|||dS)aSet the style for a range of paragraphs. This is a convenience method for `set_style` that aligns the character range to the enclosing paragraph(s). Dispatches an :py:meth:`~pyglet.text.document.AbstractDocument.on_style_text` event. Args: start: Starting character position. end: Ending character position (exclusive). attributes: Dictionary giving named style attributes of the paragraphs. rN)rfrhrrrs rset_paragraph_stylez$AbstractDocument.set_paragraph_styles` ((//$$S)) sJ/// OUCDDDDDrcdS)zText was inserted into the document. Args: start: Character insertion point within document. text: The text that was inserted. :event: Nr/)rrcrOs rrzAbstractDocument.on_insert_textrnrcdS)aText was deleted from the document. Args: start: Starting character position of deleted text. end: Ending character position of deleted text (exclusive). :event: Nr/rs rrzAbstractDocument.on_delete_textrnrcdS)aText character style was modified. Args: start: Starting character position of modified text. end: Ending character position of modified text (exclusive). attributes: Dictionary giving updated named style attributes of the text. :event: Nr/rs rrzAbstractDocument.on_style_textrnrrNrOrPrr)rrP)r]rrr)rirPrrjr)rirPr rrr)rirPrcrrrrrrr.)r|rrrjr rr|rrr )rcrrOrPrrrrrcrrrrrr)r rrrrrrr)r rrrrcrrrrrrrr)rcrrOrPrr)rcrrrrrrrr)#rDrErFrGrecompilerLrHrMrrIrOsetterrfrhrrmrqr{rrrUrr[rrrrrr_is_pyglet_doc_runrrr __classcell__rWs@rrKrKs/9bj9J.K.KKKKK*4"*\*B*BBBBB & & & & & & &X ["""["       ^      ^  0     ^       ^  ;;;;; .... : : : :;;;;<@66666.     EEEE"   ^ EEEE*%                3%%%%rrKrrrcteZdZdZddfd Zdd Zd d!dZd"fd Zd"dZd"fd Z d d#dZ d$d%dZ d&dZ xZ S)'UnformattedDocumentzA document having uniform style over all text. Changes to the style of text within the document affects the entire document. For convenience, the ``position`` parameters of the style methods may therefore be omitted. rNrOrPrrcXt|i|_dS)z*Create unformatted document with a string.N)rRrstylesrVs rrzUnformattedDocument.__init__ s& &( rrirunlist.ConstRunIteratorc|j|}tjt |j|Sr.)rgetr ConstRunIteratorr\rO)rrirzs rrmz"UnformattedDocument.get_style_runs%s0  **'DI>>>rNr rrc6|j|Sr.)rrrps rrqzUnformattedDocument.get_style)s{y)))rrcrrrrrcntdt|j|SrZ)rRrr\rOrrcrrrrWs rrzUnformattedDocument.set_style,s'ww  C NNJ???rc:|j|dSr.)rupdaters rrzUnformattedDocument._set_style/s :&&&&&rcntdt|j|SrZ)rRrr\rOrs rrz'UnformattedDocument.set_paragraph_style2s'ww**1c$)nnjIIIrr|c|||}tjt|j|S)N)r|)rr rr\rO)rr|fts rrz!UnformattedDocument.get_font_runs5s0==S=))'DI;;;rr cNddlm}|jd}|jd}|jdd}|jdd}|jd d}||||||| S) Nrfont font_name font_sizeweightnormalitalicFstretchrrrr|)pygletrrrload) rr r|rrrrrrs rrzUnformattedDocument.get_font9sKOOK00 KOOK00 844511+//)U33yyIfVU\beyfffrcPtjt|jdSr.)r rr\rSrs rget_element_runsz$UnformattedDocument.get_element_runsBs'DJ>>>rrr)rirPrrr.)rirPr rrrr)r|rrr)NN)r rr|rrr )rr)rDrErFrGrrmrqrrrrrrrrs@rrrs ))))))) ????*****@@@@@@''''JJJJJJ<<<<<ggggg????????rrcteZdZdZd d!fd Zd"d Zd#d$dZd%dZd&d'dZd&d(dZ d)dZ d*fd Z d+fd Z xZ S),FormattedDocumentzSimple implementation of a document that maintains text formatting. Changes to text style are applied according to the description in :py:class:`~pyglet.text.document.AbstractDocument`. All styles default to ``None``. rNrOrPrrcXi|_t|dSr.) _style_runsrRrrVs rrzFormattedDocument.__init__Ms)79 rri+runlist.RunIterator | _NoStyleRangeIteratorcp |j|S#t$r tcYSwxYwr.)rget_run_iteratorKeyError_no_style_range_iteratorrls rrmz FormattedDocument.get_style_runsQsH ,#I.??AA A , , ,+ + + + ,s !55rr r Any | NonecL |j||S#t$rYdSwxYwr.)rrrps rrqzFormattedDocument.get_styleWs< #I.x8 8   44 s  ##rcrrrrc4|D]\}} |j|}nW#t$rJtjddx}|j|<|dt |jYnwxYw||||dSrZ) itemsrrr RunListinsertr\rSset_run)rrcrrrrirzrunss rrzFormattedDocument._set_style]s * 0 0 2 2 , , Iu 0' 2 0 0 05<_Q5M5MMt' 2 As4:///// 0 LLU + + + +  , ,s )AA=<A=Nr|r_FontStyleRunsRangeIteratorc t|d|d|d|d|d|S)Nrrrrr)rrmr~s rrzFormattedDocument.get_font_runsfsl*    , ,    , ,    ) )    ) )    * *   rr c<||}||Sr.)r)rr r| runs_iters rrzFormattedDocument.get_fontos &&s++ ""r_ElementIteratorcPt|jt|jSr.)rrTr\rSrs rrz"FormattedDocument.get_element_runsssDJ@@@rc t|||t|}|jD]}|||||D]\}} |j|}nW#t$rJtj ddx}|j|<|dt|j YnwxYw| |||z|dSdSrZ) rRrr\rvaluesrrrr rrOr) rrcrOrrrrirzrWs rrzFormattedDocument._insert_textvs& UD*555t99$++-- ) )D KKx ( ( ( (  !$.$4$4$6$6 = = 53+I6DD3339@D9Q9QQD4+I6KK3ty>>222223 UEH$4e<<<< " ! = =s BAC$#C$ct|||jD]}|||dSr.)rRrrrdelete)rrcrrrrWs rrzFormattedDocument._delete_texts\ UC((($++-- $ $D KKs # # # # $ $rrr)rirPrrr)rirPr rrrrr.)r|rrrr)rr)rcrrOrPrrrrr)rDrErFrGrrmrqrrrrrrrrs@rrrFs ,,,,  ,,,,#####AAAA====== $$$$$$$$$$rrelementslist[InlineElement]lengthrr>+/::( DHdjjjrN)rrrrrr)rDrErFrr/rrrrs(666666rrc&eZdZdd ZddZddZdS)r font_namesrunlist.RunIterator font_sizesweightsitalicsrr|rrrcPtj|||||f|_||_dSr.)r ZipRunIteratorzip_iterr|)rrrrrrr|s rrz$_FontStyleRunsRangeIterator.__init__s,. JQXZa/bcc rrcrrr,Generator[tuple[int, int, Font], None, None]c #Kddlm}|j||D]F\}}}|\}}} } } |||| pdt | | pd|j} ||| fVGdSNrrrFr)rrrrurr*r|) rrcrrrstart_end_rrrrrrrs rruz"_FontStyleRunsRangeIterator.rangess$(M$8$8$D$D # # FD&rs@#""""" ########0000000000.%%%%%%------WS"566P3;P&L L L L L CL L L ^lllllu,lll^ $$%5666$$%5666$$_555+?+?+?+?+?*+?+?+?\C$C$C$C$C$(C$C$C$L    66666w*666 GGGGG'"5GGG(G/1022r