^ j^P d Z ddlmZ ddlmZ ddlmZ ddlmZ ddlm
Z ddl m
Z
mZmZmZ ddlZdd lmZmZmZ e
r(dd
lmZmZmZ dd lmZm Z dd l m Z dd
l m Z ddl!m"Z"m#Z#m$Z$ G d de% Z& G d d Z'ed Z( G d de)e Z*d/d0dZ+ d1d2d Z,d/d3d$Z-d4d%Z.d5d'Z/ G d( d)ej0 Z1 G d* d+e1 Z2 G d, d-e1 Z3g d.Z4dS )6ar Text formatting, layout and display.
This module provides classes for loading styled documents from text files,
HTML files and a pyglet-specific markup format. Documents can be styled with
multiple fonts, colours, styles, text sizes, margins, paragraph alignments,
and so on.
Using the layout classes, documents can be laid out on a single line or
word-wrapped to fit a rectangle. A layout can then be efficiently drawn in
a window or updated incrementally (for example, to support interactive text
editing).
The label classes provide a simple interface for the common case where an
application simply needs to display some text in a window.
A plain text label can be created with::
label = pyglet.text.Label('Hello, world',
font_name='Times New Roman',
font_size=36,
x=10, y=10)
Alternatively, a styled text label using HTML can be created with::
label = pyglet.text.HTMLLabel('Hello, world',
x=10, y=10)
Either label can then be drawn at any time with::
label.draw()
For details on the subset of HTML supported, see `pyglet.text.formats.html`.
Refer to the Programming Guide for advanced usage of the document and layout
classes, including interactive editing, embedding objects within documents and
creating scrollable layouts.
) annotations)abstractmethod)Enum)dirname)splitext)
TYPE_CHECKINGAnyBinaryIOLiteralN)caretdocumentlayout)AnchorXAnchorYHorizontalAlign)BatchGroup)
ShaderProgram)Location)AbstractDocumentFormattedDocumentUnformattedDocumentc e Zd ZdZdS )DocumentDecodeExceptionz)An error occurred decoding document text.N)__name__
__module__ __qualname____doc__ O/home/agentuser/manim-venv/lib/python3.11/site-packages/pyglet/text/__init__.pyr r ; s 3333r r c , e Zd ZdZed
d d ZdS ) DocumentDecoderzAbstract document decoder.NtextstrlocationLocation | Nonereturnr c dS )a Decode document text.
Args:
text:
Text to decode
location:
Location to use as base path for additional resources referenced within the document (for example,
HTML images).
Nr )selfr$ r& s r! decodezDocumentDecoder.decodeB s r N)r$ r% r& r' r( r )r r r r r r+ r r r! r# r# ? s= $$ ^ r r# )
text/plain text/htmltext/vnd.pyglet-attributedc B e Zd ZdZdZdZdZdZ dZdZ dZ
d Z d
Z dd
Z
dS )WeightaY An :py:class:`~enum.Enum` of known cross-platform font weight strings.
Each value is both an :py:class:`~enum.Enum` and a :py:class:`str`.
This is not a built-in Python :py:class:`~enum.StrEnum` to ensure
compatibility with Python < 3.11.
.. important:: Fonts will use the closest match if they lack a weight!
The values of this enum imitate the string names for font weights
as used in CSS and the OpenType specification. Numerical font weights
are not supported because:
* Integer font weight support and behavior varies by back-end
* Some font renderers do not support or round :py:class:`float` values
* Some font renderers lack support for variable-width fonts
Additional weight strings may be supported by certain font-rendering
back-ends. To learn more, please see your platform's API documentation
and the following:
#. `The MDN article on CSS font weights `_
#. `The OpenType specification `_
thin
extralightlightnormalmediumsemiboldbold extrabold ultraboldr( r% c | j S r, )valuer* s r! __str__zWeight.__str__x s
zr Nr( r% )r r r r THIN
EXTRALIGHTLIGHTNORMALMEDIUMSEMIBOLDBOLD EXTRABOLD ULTRABOLDr> r r r! r1 r1 R sg 2 D J E
F(
FH D0II r r1 filename
str | NonemimetypeSupportedMimeTypes | Noner( c J |-t | \ }}| dv rd}nd}|dk rddlm} | S |dk rddlm} | S |dk rdd lm} | S d
| d }t | ) a Get a document decoder for the given filename and MIME type.
If ``mimetype`` is omitted it is guessed from the filename extension.
The following MIME types are supported:
``text/plain``
Plain text
``text/html``
HTML 4 Transitional
``text/vnd.pyglet-attributed``
Attributed text; see `pyglet.text.formats.attributed`
Args:
filename:
Filename to guess the MIME type from. If a MIME type is given, the filename is ignored.
mimetype:
MIME type to lookup, or ``None`` to guess the type from the filename.
Raises:
DocumentDecodeException: If MIME type is not from the supported types.
N)z.htmz.htmlz.xhtmlr. r- r ) plaintext)htmlr/ )
attributedzUnknown format "")
_splitextlowerpyglet.text.formatsrN PlainTextDecoderrO HTMLDecoderrP AttributedTextDecoderr )rI rK _extrN rO rP msgs r! get_decoderr[ | s . 8$$3 99;;5 5 5"HH#H< 111111))+++; ,,,,,, !!!///222222//111
(X
(
(
(C
!#
&
&&r r% fileBinaryIO | Noner c t | | }|s,>??H >>- 2 22s AA
Ar$ r& r c N t dd }| | | S )zCreate a document directly from some HTML formatted text.
Args:
text:
HTML data to decode.
location:
Location giving the base path for additional resources referenced from the document (e.g., images).
Nr. r[ r+ )r$ r& rg s r! decode_htmlrm s' $ ,,G >>$ ) ))r c L t dd }| | S )zCreate a document directly from some attributed text.
See `pyglet.text.formats.attributed` for a description of attributed text.
Nr/ rl r$ rg s r! decode_attributedrp s&
$ <==G >>$ r r c L t dd }| | S )z0Create a document directly from some plain text.Nr- rl ro s r! decode_textrr s# $ --G >>$ r c e Zd ZdZ dCdD fd"
ZedEd$ Zej dFd& ZedGd( Zej dHd* ZedId, Z e j dJd. Z edKd0 Z
e
j dLd2 Z
edMd3 Z e j dNd5 Z edEd6 Z e j dOd8 Z edPd: Z
e
j dQd< Z
dRd?ZdSdAZdTdBZ xZS )U
DocumentLabelz~Base label class.
A label is a layout that exposes convenience methods for manipulating the
associated document.
NleftbaselineFTr
r xfloatyzwidth
int | Noneheightanchor_xr anchor_yr rotation multilinebooldpibatch Batch | Nonegroup Group | NoneprogramShaderProgram | None
init_documentr( Nonec h t ||||||||| |
| | |
|| dS )a Create a label for a given document.
Args:
document: Document to attach to the layout.
x: X coordinate of the label.
y: Y coordinate of the label.
z: Z coordinate of the label.
width: Width of the label in pixels, or ``None``
height: Height of the label in pixels, or ``None``
anchor_x:
Anchor point of the X coordinate: one of
``"left"``, `"center"`` or ``"right"``.
anchor_y:
Anchor point of the Y coordinate: one of
``"bottom"``, ``"baseline"``, ``"center"`` or ``"top"``.
rotation:
The amount to rotate the label in degrees. A
positive amount will be a clockwise rotation, negative
values will result in counter-clockwise rotation.
multiline:
If ``True``, the label will be word-wrapped and
accept newline characters. You must also set the width
of the label.
dpi: Resolution of the fonts in this layout. Defaults to 96.
batch: Optional graphics batch to add the label to.
group: Optional graphics group to use.
program: Optional graphics shader to use. Will affect all glyphs.
init_document:
If ``True``, the document will be initialized. If you
are passing an already-initialized document, then you can
avoid duplicating work by setting this to ``False``.
r N)super__init__)r* r
rx rz r{ r| r~ r r r r r r r r r __class__s r! r zDocumentLabel.__init__ sU T 1aE68Xx"Cwm ] ] ] ] ]r r% c | j j S )zThe text of the label.r
r$ r= s r! r$ zDocumentLabel.text s }!!r r$ c || j _ d S r, r r* r$ s r! r$ zDocumentLabel.text s !
r tuple[int, int, int, int]c 6 | j d S )z\Text color.
Color is a 4-tuple of RGBA components, each in range [0, 255].
colorr
get_styler= s r! r zDocumentLabel.color s }&&w///r r c |^}}}}||||r|d ndf}| j dt | j j d|i d S )Nr r r
set_stylelenr$ )r* r rgbas r! r zDocumentLabel.color( s\ 1a!1a+1+
3t}'9#:#:WeB,0"&+] +] +] +] +] +] +]Z " " " X"
[" " " [" 0 0 0 X0 \N N N \N
X
^B B B ^B 4 4 4 X4 V V V V 4 4 4 X4 V V V V 1 1 1 X1 ]U U U ]U 1 1 1 X1 ]P P P ]P
O
O
O
O
K
K
K
K r rt c < e Zd ZdZ d0d1 fd/
Z xZS )2LabelzPlain text label. ru Nrv rw Fr5 r r r r r$ r% rx ry rz r{ r| r} r~ r r r r r r r r r str | list[str] | Noner float | Noner r r stretchr 0tuple[int, int, int, int] | tuple[int, int, int]alignr r r r r r r r( r c ( t | }|^}}}}||||r|d ndf}t ||||||||| |
| |||d | j dt | j j | |
|||||d dS )a Create a plain text label.
Args:
text:
Text to display.
x:
X coordinate of the label.
y:
Y coordinate of the label.
z:
Z coordinate of the label.
width:
Width of the label in pixels, or None
height:
Height of the label in pixels, or None
anchor_x:
Anchor point of the X coordinate: one of ``"left"``,
``"center"`` or ``"right"``.
anchor_y:
Anchor point of the Y coordinate: one of ``"bottom"``,
``"baseline"``, ``"center"`` or ``"top"``.
rotation:
The amount to rotate the label in degrees. A positive amount
will be a clockwise rotation, negative values will result in
counter-clockwise rotation.
multiline:
If True, the label will be word-wrapped and accept newline
characters. You must also set the width of the label.
dpi:
Resolution of the fonts in this layout. Defaults to 96.
font_name:
Font family name(s). If more than one name is given, the
first matching name is used. A list of names can optionally
be given: the first matching font will be used.
font_size:
Font size, in points.
weight:
The 'weight' of the font (boldness). See the :py:class:`~Weight`
enum for valid cross-platform weight names.
italic:
Italic font style.
stretch:
Stretch font style.
color:
Font color as RGBA or RGB components, each within
``0 <= component <= 255``.
align:
Horizontal alignment of text on a line, only applies if
a width is supplied. One of ``"left"``, ``"center"``
or ``"right"``.
batch:
Optional graphics batch to add the label to.
group:
Optional graphics group to use.
program:
Optional graphics shader to use. Will affect all glyphs.
r r Fr )r r r r r r r N)rr r r r
r r r$ ) r* r$ rx rz r{ r| r~ r r r r r r r r r r r r r r r docr r r r rgbar s r! r zLabel.__init__ s L $ 1a!!Q*!s*
aAufh("Cwe U U U
3t}'9#:#:"" =
=
r )r ru ru ru NNrv rw ru FNNNr5 FFr rv NNN),r$ r% rx ry rz ry r{ ry r| r} r~ r} r r r r r ry r r r r} r r r r r r% r r r r r r r r r r r r r r r( r )r r r r r r r s @r! r r sv !7:;?Z]7;PTV[FZ%+>B,0U U U U U U U U U U U r r c n e Zd ZdZ d'd( fd$
Zed)d% Zej d*d& Z xZS )+ HTMLLabelzyHTML formatted text label.
A subset of HTML 4.01 is supported. See `pyglet.text.formats.html` for
details.
r ru Nrv rw Fr$ r% rx ry rz r{ r| r} r~ r r r r r r r r r r& r' r r r r r r r( r c || _ | | _ t || }t ||||||||| |
| |
||d dS )aB Create a label with an HTML string.
Args:
text:
Text to display.
x:
X coordinate of the label.
y:
Y coordinate of the label.
z:
Z coordinate of the label.
width:
Width of the label in pixels, or None
height:
Height of the label in pixels, or None
anchor_x:
Anchor point of the X coordinate: one of ``"left"``,
``"center"`` or ``"right"``.
anchor_y:
Anchor point of the Y coordinate: one of ``"bottom"``,
``"baseline"``, ``"center"`` or ``"top"``.
rotation:
The amount to rotate the label in degrees. A positive amount
will be a clockwise rotation, negative values will result in
counter-clockwise rotation.
multiline:
If True, the label will be word-wrapped and accept newline
characters. You must also set the width of the label.
dpi:
Resolution of the fonts in this layout. Defaults to 96.
location:
Location object for loading images referred to in the document.
By default, the working directory is used.
batch:
Optional graphics batch to add the label to.
group:
Optional graphics group to use.
program:
Optional graphics shader to use. Will affect all glyphs.
Tr N)_text _locationrm r r )r* r$ rx rz r{ r| r~ r r r r r r& r r r r r s r! r zHTMLLabel.__init__ sr `
!$))
aAufh("Cwd T T T T Tr c | j S )z!HTML formatted text of the label.)r r= s r! r$ zHTMLLabel.text s zr c H || _ t || j | _ d S r, )r rm r r
r s r! r$ zHTMLLabel.text% s
#D$.99
r )r ru ru ru NNrv rw ru FNNNNN) r$ r% rx ry rz ry r{ ry r| r} r~ r} r r r r r ry r r r r r& r' r r r r r r r( r r? r ) r r r r r r r$ r r r s @r! r r s $&pt_b>B-1CG15
4T 4T 4T 4T 4T 4T 4Tl X
[: : : [: : : : :r r )
r r# SupportedMimeTypesr[ rj rm rp rr rt r r r
r r, )rI rJ rK rL r( r# )NN)rI r% r\ r] rK rL r( r )r$ r% r& rJ r( r )r$ r% r( r )r$ r% r( r )5r
__future__r abcr enumr os.pathr rf r rR typingr r r
r rc pyglet.textr r
r pyglet.customtypesr r r pyglet.graphicsr r pyglet.graphics.shaderr pyglet.resourcer pyglet.text.documentr r r Exceptionr r# r r% r1 r[ rj rm rp rr
TextLayoutrt r r __all__r r r! r s $ $J # " " " " " ' ' ' ' ' ' ) ) ) ) ) ) 8 8 8 8 8 8 8 8 8 8 8 8
/ / / / / / / / / / ^DDDDDDDDDD,,,,,,,,444444((((((]]]]]]]]]]4 4 4 4 4i 4 4 4
TU ' ' ' ' 'S$ ' ' 'T)' )' )' )' )'Z "&/3 3 3 3 3 3>
*
*
*
*
* b b b b bF% b b bJX X X X X M X X X vE: E: E: E: E:
E: E: E:P r