^ j0DdZddlmZddlmZmZmZddlZddlm Z dZ ddl m Z ddl mZd Z n #e$rYnwxYwerdd lmZmZdd lmZGd d e jZGdde jZGddeZGddeZGddeZddZdZdS)a This module defines the usage and creation of user defined fonts in Pyglet. Previously, pyglet only supported font renderers that are built into the operating system, such as ``FreeType``, ``DirectWrite``, or ``Quartz``. However, there are situations in which a user may not want or need all the features a font can provide. They just need to put characters in a particular order without the hassle of exporting into a separate file. The :py:class:`~pyglet.font.user.UserDefinedMappingFont` is provided for most use cases, which will allow you to make an internal font that can be used where a ``font_name`` is required to identify a font. A user defined font is also identified by its name. The name you choose should be unique to ensure it will not conflict with a system font. For example, do not use `Arial`, as that will collide with Windows systems. With :py:class:`~pyglet.font.user.UserDefinedMappingFont` you can pass a mapping of characters that point to your :py:class:`~pyglet.image.ImageData`. .. code-block:: python mappings={'c': my_image_data, 'b': my_image_data, 'a': my_image_data} For more custom behavior, a dict-like object can be used, such as a class. .. code-block:: python class MyCustomMapping: def get(self, char: str) -> ImageData | None: # return ImageData if a character is found. # return None if no character is found mappings = MyCustomMapping() Once your font is created, you also must register it within pyglet to use it. This can be done through the :py:func:`~pyglet.font.add_user_font` function. When you register a user defined font, only those parameters will used to identify the font. If you have a font, but want to have a ``italic`` enabled version. You must make a new instance of your font, but with the ``italic`` parameter set as ``True``. Same applies to the ``size`` parameter. The ``weight`` parameter can also be provided as a string. Scaling ======= By default, user font's will not be scaled. In most use cases, you have a single font at a specific size that you want to use. There are cases where a user may want to scale their font to be used at any size. We provide the following function: :py:func:`~pyglet.font.user.get_scaled_user_font`. By providing the user defined font instance, and a new size, you will get back a new font instance that is scaled to the new size. This new instance must also be registered the same way as the base font. When specifying the ``size`` parameter, that value is used to determine the ratio of scaling between the new size. So if your base font is a size of 12, creating a scaled version at size 24 will be double the size of the base. .. warning:: The ``PIL`` library is a required dependency to use the scaling functionality. .. versionadded:: 2.0.15 ) annotations) TYPE_CHECKINGClassVarProtocolN)baseF)Image) ResamplingT)Glyph GlyphPosition) ImageDatac(eZdZd fd Zd d ZxZS) UserDefinedGlyphRendererfontUserDefinedFontBasereturnNonecXt|||_dSN)super__init___font)selfr __class__s K/home/agentuser/manim-venv/lib/python3.11/site-packages/pyglet/font/user.pyrz!UserDefinedGlyphRenderer.__init__Qs&  image_datar r c|jjr,tjd|j|jf|d}|jj|jj z }| t|j|zt|j|zftj }tj|j|jd|}|j|}||jj d|jnA|j|}||jj d|j|S)NRGBAr)r_scalingr frombyteswidthheightget_image_dataget_datasize _base_sizeresizeintr NEARESTpygletimager tobytes create_glyph set_bearingsdescent)rrimage_original scale_ratio image_resized new_imageglyphs rrenderzUserDefinedGlyphRenderer.renderUsW :  I"_Vj6F HY5Z-7-F-F-H-H-Q-QRX-Y-Y[[N*/DJ,AAK*113z7G+7U3V3V36z7H;7V3W3W3YZdZlnnM ..}/BMDX/5}7L7L7N7NPPIJ++I66E    22A}7J K K K KJ++J77E    22Az7G H H H r)rrrr)rr rr )__name__ __module__ __qualname__rr5 __classcell__rs@rrrPsQrrcbeZdZUdZeZded< ddfd Zed dZ d!dZ d"dZ xZ S)#rzMUsed as a base for all user defined fonts. .. versionadded:: 2.0.15 z"ClassVar[type[base.GlyphRenderer]]glyph_renderer_classNnormalF`namestr default_charr%r(ascent int | Noner/weightitalicboolstretchdpilocale str | Nonerrc t||_||_||_||_||_||_||_||_ | |_ | |_ d|_ d|_ dS)aInitialize a user defined font. Args: name: Name of the font. Used to identify the font. Must be unique to ensure it does not collide with any system fonts. default_char: If a character in a string is not found in the font, it will use this as fallback. size: Font size, usually in pixels. ascent: Maximum ascent above the baseline, in pixels. If None, the image height is used. descent: Maximum descent below the baseline, in pixels. Usually negative. weight: The font weight, as a string. Defaults to "normal". italic: If True, this font will be used when ``italic`` is enabled for the font name. stretch: If True, this font will be used when ``stretch`` is enabled for the font name. dpi: The assumed resolution of the display device, for the purposes of determining the pixel size of the font. Use a default of 96 for standard sizing. locale: Used to specify the locale of this font. rFN)rr_namerArBr/r%rDrErGrHrIr&r) rr?rAr%rBr/rDrErGrHrIrs rrzUserDefinedFontBase.__init__mst<  (        rc|jSr)rLrs rr?zUserDefinedFontBase.names zr base_sizecRtsd}t|||_d|_dS)Nz5PIL is not installed. User Font Scaling requires PIL.T)SCALING_ENABLED ImportErrorr&r)rrOmsgs renable_scalingz"UserDefinedFontBase.enable_scalings/ #ICc"" "# rcL|js|||_dSdS)zInitialize the glyph renderer and cache it on the Font. This way renderers for fonts that have been loaded but not used will not have unnecessary loaders. N)_glyph_rendererr<rNs r_initialize_rendererz(UserDefinedFontBase._initialize_renderers8 # C#'#<#N)r?r@rAr@r%r(rBrCr/rCrDr@rErFrGrFrHr(rIrJrr)rr@rOr(rr)rr) r6r7r8__doc__rr<__annotations__rpropertyr?rTrWr9r:s@rrrfs@XWWWWmquy+++++++ZXCCCCCCCCrrceZdZdZdS)UserDefinedFontExceptionz+An exception related to user font creation.N)r6r7r8rZrrr^r^s5555rr^ceZdZddZdS)DictLikeObjectcharr@rImageData | NonecdSrr_)rrbs rgetzDictLikeObject.gets rN)rbr@rrc)r6r7r8rer_rrraras(      rracJeZdZUdZded< d!d"fd Zd#fd Zd$d ZxZS)%UserDefinedMappingFontznThe class allows the creation of user defined fonts from a set of mappings. .. versionadded:: 2.0.15 rrVNr=Fr>r?r@rAr%r(mappingsrarBrCr/rDrErFrGrHrIrJrrc ||_|j|} | sd|d} t| || || j}|d}t |||||||| | | dS)aInitialize the default parameters of your font. Args: name: Name of the font. Must be unique to ensure it does not collide with any system fonts. default_char: If a character in a string is not found in the font, it will use this as fallback. size: Font size. Should be in pixels. This value will affect scaling if enabled. mappings: A dict or dict-like object with a ``get`` function. The ``get`` function must take a string character, and output :py:class:`~pyglet.image.ImageData` if found. It also must return ``None`` if no character is found. ascent: Maximum ascent above the baseline, in pixels. If None, the image height is used. descent: Maximum descent below the baseline, in pixels. Usually negative. weight: The font weight, as a string. Defaults to "normal". italic: If ``True``, this font will be used when ``italic`` is enabled for the font name. stretch: If ``True``, this font will be used when ``stretch`` is enabled for the font name. dpi: The assumed resolution of the display device, for the purposes of determining the pixel size of the font. Use a default of 96 for standard sizing. locale: Used to specify the locale of this font. zDefault character 'z"' must exist within your mappings.Nr)rhrer^r"rr)rr?rAr%rhrBr/rDrErGrHrI default_imagerSrs rrzUserDefinedMappingFont.__init__s@!  )),77  0X XXXC*3// / >W_~&- |T67FFT[]`bhiiiiirrOct|||j\}}|dj|_d|_dS)zEnables scaling the font size. Args: base_size: The base size is used to calculate the ratio between new sizes and the original. rN)rrT get_glyphsrAr"rBr/)rrOglyphsoffsetsrs rrTz%UserDefinedMappingFont.enable_scalingsN y)))//$*;<<Qi&  rtext'tuple[list[Glyph], list[GlyphPosition]]c |g}g}tj|D]}|dkrd}||jvrF|j|}|s|j}n"|j||j|<| |j|| tj dddd||fS)zCreate and return a list of Glyphs for `text`. If any characters do not have a known glyph representation in this font, a substitution will be made with the ``default_char``.   r) rWrget_grapheme_clustersrmrhrerArVr5appendr )rrornrmcrs rrlz!UserDefinedMappingFont.get_glyphss !!###+D11 ; ;ADyy ##!]..q11 !M)AA%)%9%@%@%L%LDKN MM$+a. ) ) ) NN4-aAq99 : : : :wrrX)r?r@rAr@r%r(rhrarBrCr/rCrDr@rErFrGrFrHr(rIrJrrrY)ror@rrp) r6r7r8rZr[rrTrlr9r:s@rrgrgs.---kpGK,j,j,j,j,j,j,j\      rrg font_baser%r(rc t|j|j||j|j|j|j|j|j|j |j }| |j |S)aThis function will return a new font instance which can scale it's size based off the original base font. .. note:: The scaling functionality requires the PIL library to be installed. .. versionadded:: 2.0.15 Args: font_base: The base font object to create a new size from. size: The new font size. This will be scaled based on the ratio between the base size and the new size. ) rgr?rArhrBr/rDrErGrHrIrTr%)rwr%new_fonts rget_scaled_user_fontrzsh&ini6LdT]Tf&/&6 8I9K[]f]m&/&7 HXZZH IN+++ Or)rr^rgrz)rwrgr%r(rrg)rZ __future__rtypingrrrr* pyglet.fontrrQPILr PIL.Imager rRpyglet.font.baser r pyglet.imager GlyphRendererrFontr Exceptionr^rargrz__all__r_rrrs99t#"""""4444444444  $$$$$$OO   D '55555555&&&&&&t1,FCFCFCFCFC$)FCFCFCP66666y666     X   WWWWW0WWWt* s /77