\ jgdZddlZddlZddlmZddlmZeedoejZ dZ GddZ Gd d ej Z e d e d e d Gdde ZGdde ZdZGddejZGddZGddZeZdS)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. +++++++ +++++++ "bold" ++++++ "italic" If this example were to be rendered, "The cat" and "the mat" would be in bold, and "on the" in italics. Note that the second "the" is both bold and italic. The document styles recorded for this example would be ``"bold"`` 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 ``"bold"`` 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 documented, 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: http://unicode.org/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 ``"bold"`` 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. ``bold`` Boolean. ``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. .. versionadded:: 1.1 N)event)runlistis_pyglet_doc_run indeterminatec@eZdZdZdZeddZdZdZdS) 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 a element (any of the `advance`, `ascent`, or `descent` instance 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. :Ivariables: `ascent` : int Ascent of the element above the baseline, in pixels. `descent` : int Descent of the element below the baseline, in pixels. Typically negative. `advance` : int Width of the element, in pixels. c>||_||_||_d|_dSN)ascentdescentadvance _position)selfr r r s N/DATA/AppData/hermes/venv/lib/python3.11/site-packages/pyglet/text/document.py__init__zInlineElement.__init__s"   c|jSr )rrs rzInlineElement.sT^rz]Position of the element within the document. Read-only. :type: int )docc td)aConstruct an instance of the element at the given coordinates. Called when the element's position within a layout changes, either due to the initial condition, changes in the document or changes in the layout size. It is the responsibility of the element to clip itself against the layout boundaries, and position itself appropriately with respect to the layout's position and viewport offset. The `TextLayout.top_state` graphics state implements this transform and clipping into window space. :Parameters: `layout` : `pyglet.text.layout.TextLayout` The layout the element moved within. `x` : int Position of the left edge of the element, relative to the left edge of the document, in pixels. `y` : int Position of the baseline, relative to the top edge of the document, in pixels. Note that this is typically negative. abstractNotImplementedError)rlayoutxys rplacezInlineElement.places2"*---rc td)a!Remove this element from a layout. The counterpart of `place`; called when the element is no longer visible in the given layout. :Parameters: `layout` : `pyglet.text.layout.TextLayout` The layout the element was removed from. rr)rrs rremovezInlineElement.remove"*---rN) __name__ __module__ __qualname____doc__rpropertypositionrr rrrrsn4 x33    H...6 . . . . .rrc"eZdZdZejdZejdZdfd Ze dZ e j dZ dZ d Z d Zdd Zd ZddZddZddZdZdZdZddZdZdZdZdZer dZdZdZxZ SxZ S) AbstractDocumentaAbstract document interface used by all :py:mod:`pyglet.text` classes. This class can be overridden to interface pyglet with a third-party document format. It may be easier to implement the document format in terms of one of the supplied concrete classes :py:class:`~pyglet.text.document.FormattedDocument` or :py:class:`~pyglet.text.document.UnformattedDocument`. u [^ 
]*$u[ 
]ctt|d|_g|_|r|d|dSdS)Nr+r)superr*r_text _elements insert_textrtext __class__s rrzAbstractDocument.__init__s\ %%..000   &   Q % % % % % & &rc|jS)aDocument text. For efficient incremental updates, use the :py:func:`~pyglet.text.document.AbstractDocument.insert_text` and :py:func:`~pyglet.text.document.AbstractDocument.delete_text` methods instead of replacing this property. :type: str )r.rs rr2zAbstractDocument.texts zrc||jkrdS|dt|j|d|dSNr)r. delete_textlenr0)rr2s rr2zAbstractDocument.text!sN 4:   F C OO,,, D!!!!!rc|jd|dzds%|jd|dzdr|S|j|jd|dz}|sdS|dzS)zGet the starting position of a paragraph. :Parameters: `pos` : int Character position within paragraph. :rtype: int N u
r)r.endswith_previous_paragraph_researchstartrposms rget_paragraph_startz$AbstractDocument.get_paragraph_start(s Jxax ) )$ / /  8C!G8$--i88 J  ' . .tz1cAg F F 1wwyy1}rc|j|j|}|st|jS|dzS)zGet the end position of a paragraph. :Parameters: `pos` : int Character position within paragraph. :rtype: int r:)_next_paragraph_rer>r.r8r?r@s rget_paragraph_endz"AbstractDocument.get_paragraph_end<sF  # * *4:s ; ; #tz?? "wwyy1}rc td)zGet a style iterator over the given style attribute. :Parameters: `attribute` : str Name of style attribute to query. :rtype: `AbstractRunIterator` rrr attributes rget_style_runszAbstractDocument.get_style_runsJs"*---rrc td)a;Get an attribute style at the given position. :Parameters: `attribute` : str Name of style attribute to query. `position` : int Character position of document to query. :return: The style set for the attribute at the given position. rrrrIr's r get_stylezAbstractDocument.get_styleUr!rc||}t|||\}}}||krtS|S)a Get an attribute style over the given range. If the style varies over the range, `STYLE_INDETERMINATE` is returned. :Parameters: `attribute` : str Name of style attribute to query. `start` : int Starting character position. `end` : int Ending character position (exclusive). :return: The style set for the attribute over the given range, or `STYLE_INDETERMINATE` if more than one value is set. )rJnextrangesSTYLE_INDETERMINATE)rrIr?enditerable_ value_endvalues rget_style_rangez AbstractDocument.get_style_rangebsM &&y11"8??5##>#>??9e s??& &LrNc td)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``, ``bold`` and ``italic`` style attributes. :Parameters: `dpi` : float Optional resolution to construct fonts at. See :py:func:`pyglet.font.load`. :rtype: `AbstractRunIterator` rrrdpis r get_font_runszAbstractDocument.get_font_runsy"*---rc td)aGet the font instance used at the given position. :see: `get_font_runs` :Parameters: `position` : int Character position of document to query. `dpi` : float Optional resolution to construct fonts at. See :py:func:`pyglet.font.load`. :rtype: `pyglet.font.Font` :return: The font at the given position. rr)rr'rZs rget_fontzAbstractDocument.get_fontr\rcb|||||d||dS)aTInsert text into the document. :Parameters: `start` : int Character insertion point within document. `text` : str Text to insert. `attributes` : dict Optional dictionary giving named style attributes of the inserted text. on_insert_textN) _insert_textdispatch_event)rr?r2 attributess rr0zAbstractDocument.insert_texts; %z222 ,eT:::::rcd|jd|||j|df|_t|}|jD]}|j|kr|xj|z c_dS)Nr+)joinr.r8r/r)rr?r2rclen_textelements rrazAbstractDocument._insert_texts{XXtz&5&14EFF9KLMM t99~ . .G E))!!X-!! . .rc`||||d||dS)zDelete text from the document. :Parameters: `start` : int Starting character position to delete from. `end` : int Ending character position to delete to (exclusive). on_delete_textN) _delete_textrbrr?rRs rr7zAbstractDocument.delete_texts9 %%%% ,eS99999rct|jD]P}||jcxkr|krnn|j|2|j|kr|xj||z zc_Q|jd||j|dz|_dSr )listr/rr r.)rr?rRrgs rrjzAbstractDocument._delete_textsDN++ 3 3G)////C/////%%g...."c))!!cEk2!!Z'$*STT*:: rc|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. :Parameters: `position` : int Character insertion point within document. `element` : `~pyglet.text.document.InlineElement` 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 rrz1AbstractDocument.insert_element..s!*r)key)rr0r/appendsort)rr'rgrcs rinsert_elementzAbstractDocument.insert_elementsu  ((*M((( 4444$ g&&&  4 455555rcX|jD]}|j|kr|cStd|z)zGet the element at a specified position. :Parameters: `position` : int Position in the document of the element. :rtype: :py:class:`~pyglet.text.document.InlineElement` zNo element at position %d)r/r RuntimeError)rr'rgs r get_elementzAbstractDocument.get_elementsE~  G H,,-6ABBBrcd|||||d|||dS)aJSet text style of some or all of the document. :Parameters: `start` : int Starting character position. `end` : int Ending character position (exclusive). `attributes` : dict Dictionary giving named style attributes of the text. on_style_textN) _set_stylerbrr?rRrcs r set_stylezAbstractDocument.set_styles: sJ/// OUCDDDDDrc td)Nrrr}s rr|zAbstractDocument._set_styles!*---rc||}||}|||||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). :Parameters: `start` : int Starting character position. `end` : int Ending character position (exclusive). `attributes` : dict Dictionary giving named style attributes of the paragraphs. r{N)rCrFr|rbr}s rset_paragraph_stylez$AbstractDocument.set_paragraph_styles`((//$$S)) sJ/// OUCDDDDDrcdS)a Text was inserted into the document. :Parameters: `start` : int Character insertion point within document. `text` : str The text that was inserted. :event: Nr()rr?r2s rr`zAbstractDocument.on_insert_textrcdS)a%Text was deleted from the document. :Parameters: `start` : int Starting character position of deleted text. `end` : int Ending character position of deleted text (exclusive). :event: Nr(rks rrizAbstractDocument.on_delete_textrrcdS)aText character style was modified. :Parameters: `start` : int Starting character position of modified text. `end` : int Ending character position of modified text (exclusive). `attributes` : dict Dictionary giving updated named style attributes of the text. :event: Nr(r}s rr{zAbstractDocument.on_style_text+rrr+rr )!r"r#r$r%recompiler=rErr&r2setterrCrFrJrMrWr[r^r0rar7rjrvryr~r|r_is_pyglet_doc_runr`rir{ __classcell__r3s@rr*r*s(RZ(:;;#M22&&&&&&X [""[" (    . . . . . . ......"....";;;; ... : : :;;;6666, C C C E E E...EEE(&             3&&&&rr*r`rir{cbeZdZdZd fd ZdZddZfdZdZfd Z dd Z dd Z d Z 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. r+cftt||i|_dSr )r-rrstylesr1s rrzUnformattedDocument.__init__Hs- !4((11$777 rc|j|}tjt |j|Sr )rgetrConstRunIteratorr8r2)rrIrVs rrJz"UnformattedDocument.get_style_runsLs0  **'DI>>>rNc6|j|Sr )rrrLs rrMzUnformattedDocument.get_stylePs{y)))rc|tt|dt|j|Sr6)r-rr~r8r2rr?rRrcr3s rr~zUnformattedDocument.set_styleSs5($//99 s49~~z++ +rc:|j|dSr )rupdater}s rr|zUnformattedDocument._set_styleWs :&&&&&rc|tt|dt|j|Sr6)r-rrr8r2rs rrz'UnformattedDocument.set_paragraph_styleZs5($//CC s49~~z++ +rc|||}tjt|j|S)N)rZ)r^rrr8r2)rrZfts rr[z!UnformattedDocument.get_font_runs^s0 ]]s] # #'DI;;;rcNddlm}|jd}|jd}|jdd}|jdd}|jdd}||||||| S) Nrfont font_name font_sizeboldFitalicstretchrrrrZ)pygletrrrload) rr'rZrrrrrrs rr^zUnformattedDocument.get_fontbsKOOK00 KOOK00 {vu--511+//)U33yyI"67MM MrcPtjt|jdSr )rrr8r.rs rget_element_runsz$UnformattedDocument.get_element_runsls'DJ>>>rrr )NN)r"r#r$r%rrJrMr~r|rr[r^rrrs@rrr@s???****+++++'''+++++<<<<MMMM???????rrcbeZdZdZdfd ZdZddZdZdd Zdd Z d Z fd Z 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``. r+cfi|_tt||dSr ) _style_runsr-rrr1s rrzFormattedDocument.__init__ws0 &&//55555rcp |j|S#t$r tcYSwxYwr )rget_run_iteratorKeyError_no_style_range_iteratorrHs rrJz FormattedDocument.get_style_runs{sH ,#I.??AA A , , ,+ + + + ,s !55rcL |j||S#t$rYdSwxYwr )rrrLs rrMzFormattedDocument.get_styles< #I.x8 8   44 s  ##c4|D]\}} |j|}nW#t$rJtjddx}|j|<|dt |jYnwxYw||||dSr6) itemsrrrRunListinsertr8r.set_run)rr?rRrcrIrVrunss rr|zFormattedDocument._set_styles * 0 0 2 2 , , Iu 0' 2 0 0 05<_Q5M5MMt' 2 As4:///// 0 LLU + + + +  , ,s )AA=<A=Nc t|d|d|d|d|d|S)Nrrrrr)_FontStyleRunsRangeIteratorrJrYs rr[zFormattedDocument.get_font_runssl*    , ,    , ,    ' '    ) )    * *   rc<||}||Sr )r[)rr'rZ runs_iters rr^zFormattedDocument.get_fonts &&s++ ""rcPt|jt|jSr )_ElementIteratorr/r8r.rs rrz"FormattedDocument.get_element_runssDJ@@@rctt||||t|}|jD]}|||||D]\}} |j|}nW#t$rJtj ddx}|j|<|dt|j YnwxYw| |||z|dSdSr6) r-rrar8rvaluesrrrrrr2r) rr?r2rcrfrrIrVr3s rrazFormattedDocument._insert_texts- &&33E4LLLt99$++-- ) )D KKx ( ( ( (  !$.$4$4$6$6 = = 53+I6DD3339@D9Q9QQD4+I6KK3ty>>222223 UEH$4e<<<< " ! = =s BAC+*C+ctt||||jD]}|||dSr )r-rrjrrdelete)rr?rRrr3s rrjzFormattedDocument._delete_textsc &&33E3???$++-- $ $D KKs # # # # $ $rrrr )r"r#r$r%rrJrMr|r[r^rrarjrrs@rrrps 666666,,,  ,,,####AAA===== $$$$$$$$$rrc#`Kd}|D]}|j}||dfV||dz|fV|dz} ||dfVdS)Nrr:rq)elementslengthlastrgps r_iter_elementsrso D  AtmQ1u  rceZdZdZdS)rctt|||_t|\|_|_|_dSr )r_run_list_iterrOr?rRrV)rrrs rrz_ElementIterator.__init__s0,Xv>>+/::( DHdjjjrN)r"r#r$rr(rrrrs#66666rrc eZdZdZdZdZdS)rcPtj|||||f|_||_dSr )rZipRunIteratorzip_iterrZ)r font_names font_sizesboldsitalicsrrZs rrz$_FontStyleRunsRangeIterator.__init__s+. JwX_/`aa rc #Kddlm}|j||D]O\}}}|\}}}}} |||t |t || |j} ||| fVPdSNrrr)rrrrPrboolrZ) rr?rRrrrrrrrrs rrPz"_FontStyleRunsRangeIterator.rangess"&-"6"6uc"B"B ! ! E3:@ 7Iy$9id4jjf_flpltuuBb.  ! !rcddlm}|j|\}}}}}|||t |t |||jSr)rrrrrrZ)rindexrrrrrrs r __getitem__z'_FontStyleRunsRangeIterator.__getitem__sZ6:mE6J3 9dFGyyIDJJtF||]djnjrysssrN)r"r#r$rrPrr(rrrrsF!!!tttttrrceZdZdZdZdS)_NoStyleRangeIteratorc#K||dfVdSr r(rks rrPz_NoStyleRangeIterator.rangessS$rcdSr r()rrs rrz!_NoStyleRangeIterator.__getitem__strN)r"r#r$rPrr(rrrrs2rr)r%rsysrr pyglet.textrhasattrrrrQrEventDispatcherr*register_event_typerrr RunIteratorrrrrr(rrrs HAAF WS"566P3;P&N.N.N.N.N.N.N.N.btttttu,tttn $$%5666$$%5666$$_555-?-?-?-?-?*-?-?-?`C$C$C$C$C$(C$C$C$L66666w*666 tttttttt&1022r