3j<; J S r SSKJr SSKJr SSKrSSKrSSKrSSKJ r SSK
r SSK J
r
Jr SSKJr SS KJr \R& ( a S
S K
Jr S
S KJrJrJr SS
KJr SSS.r\R6 " S5 S 5 r SS jr S r " S S5 r " S S5 r " S S\5 r!g) z7
Common functionality between the PDF and PS backends.
) annotations)BytesION)subset ) font_managerft2font)AFM) RendererBase )FontPath)CharacterCodeTypeFT2FontGlyphIndexType)TTFont i ) * 2 c f [ U S5 n[ U5 sS S S 5 $ ! , ( d f g = f)Nrb)openr )fnamefhs ]/home/wildlama/miniconda3/lib/python3.13/site-packages/matplotlib/backends/_backend_pdf_ps.py_cached_get_afm_from_fnamer s!
eT b2w
s "
0c [ R " SSSS9nU=R / SQ-
sl U R Ul [ R
" X5 n[ R " US9nUR US9 UR U5 U$ )aq
Subset a TTF font.
Reads the named fontfile and restricts the font to the glyphs.
Parameters
----------
fontfile : FontPath
Path to the font file
glyphs : set[GlyphIndexType]
Set of glyph indices to include in subset.
Returns
-------
fontTools.ttLib.ttFont.TTFont
An open font object representing the subset, which needs to
be closed by the caller.
T) glyph_namesrecommended_glyphs retain_gids)FFTMPfEdBDFmetaMERGTSIVZapfbdatbloccidgfdscfeatfmtxfondjustkerxltagmorxtrakxref)options)gids)r Options drop_tables
face_index font_number load_font Subsetterpopulate)fontfileglyphsr4 font subsetters r get_glyphs_subsetrA & s & nn$)-/G . #--G H .D 1I
F#
T K c : [ 5 nU R USS9 U$ )z
Convert a TTFont object into a file-like object.
Parameters
----------
font : fontTools.ttLib.ttFont.TTFont
A font object
Returns
-------
BytesIO
A file object with the font saved into it
F)
reorderTables)r save)r? r s r font_as_filerF ] s
BIIbI&
IrB c X \ rS rSrSrS S jr S
S jr S S jr S S jrSr g)
GlyphMapp a
A two-way glyph mapping.
The forward glyph map is from (character string, glyph index)-pairs to
(subset index, subset character code)-pairs.
The inverse glyph map is from to (subset index, subset character code)-pairs to
(character string, glyph index)-pairs.
c 0 U l 0 U l g N_forward_inverseselfs r __init__GlyphMap.__init__{ s =?
IK
rB c : U R R X45 $ )z
Get the forward mapping from a (character string, glyph index)-pair.
This may return *None* if the pair is not currently mapped.
)rM get)rP charcodes glyph_indexs r rT GlyphMap.get s }} )!9::rB c " U R X4 $ )z>Get the inverse mapping from a (subset, subset charcode)-pair.)rN )rP r subset_charcodes r iget
GlyphMap.iget s }}f 677rB c H X44U R X4' X4U R X44' g)a^
Add a mapping to this instance.
Parameters
----------
charcode : CharacterCodeType
The character code to record.
glyph : GlyphIndexType
The corresponding glyph index to record.
subset : int
The subset in which the subset character code resides.
subset_charcode : CharacterCodeType
The subset character code within the above subset.
NrL )rP charcoderV r rY s r add GlyphMap.add s, 391J
x-.4<3J
v/0rB rL N)returnNone)rU strrV r r` z$tuple[int, CharacterCodeType] | None)r intrY r
r` ztuple[str, GlyphIndexType])
r] rb rV r r rc rY r
r` ra )
__name__
__module__ __qualname____firstlineno____doc__rQ rT rZ r^ __static_attributes__ rB r rH rH p sO K ;';,P;8 /84N8
K .K37KrB rH c f \ rS rSrSrS S
S jjr S S S jjr S
S jr SS jrSr g)CharacterTracker a1
Helper for font subsetting by the PDF and PS backends.
Maintains a mapping of font paths to the set of characters and glyphs that are being
used from that font.
Attributes
----------
subset_size : int
The size at which characters are grouped into subsets.
used : dict
A dictionary of font files to character maps.
The key is a font filename.
The value is a list of dictionaries, each mapping at most *subset_size*
character codes to glyph indices. Note this mapping is the inverse of FreeType,
which maps glyph indices to character codes.
If *subset_size* is not set, then there will only be one subset per font
filename.
glyph_maps : dict
A dictionary of font files to glyph maps. You probably will want to use the
`.subset_to_unicode` method instead of this attribute.
c , 0 U l 0 U l Xl g)z
Parameters
----------
subset_size : int, optional
The maximum size that is supported for an embedded font. If provided, then
characters will be grouped into these sized subsets.
N)used
glyph_maps subset_size)rP rq s r rQ CharacterTracker.__init__ s OQ /1&rB Nc UR U[ R R X4S9 Vs/ s H4 nU R UR
UR UR 5 PM6 sn$ s snf )a)
Record that string *s* is being typeset using font *font*.
Parameters
----------
font : FT2Font
A font that is being used for the provided string.
s : str
The string that should be marked as tracked by the provided font.
features : tuple[str, ...], optional
The font feature tags to use for the font.
Available font feature tags may be found at
https://learn.microsoft.com/en-us/typography/opentype/spec/featurelist
language : str, optional
The language of the text in a format accepted by libraqm, namely `a BCP47
language code `_.
Returns
-------
list[tuple[int, CharacterCodeType]]
A list of subset and character code pairs corresponding to the input string.
If a *subset_size* is specified on this instance, then the character code
will correspond with the given subset (and not necessarily the string as a
whole). If *subset_size* is not specified, then the subset will always be 0
and the character codes will be returned from the string unchanged.
)featureslanguage)_layoutr LoadFlags
NO_HINTING track_glyph ft_objectcharrV )rP r? srt ru raqm_items r trackCharacterTracker.track sq B "\\!W->->-I-I3; * P
P
Y 0 0)..)BWBW X P
s ;A*c [ U[ 5 ( a [ US 5 nO
Un[ U5 n[ R
" UR UR 5 nU R R U[ 5 5 nUR X#5 =n( a U$ U R R U0 /5 n[ U5 S: =( d2 U R S:g =( a X@R : =( d XHS ; n U ( aY [ U5 S:X d [ US 5 U R :X a UR 0 5 [ U5 S-
n
[ US 5 n OSn
Un X8U
U ' UR! X#X5 X4$ )a:
Record character code *charcode* at glyph index *glyph* as using font *font*.
Parameters
----------
font : FT2Font
A font that is being used for the provided string.
chars : str or CharacterCodeType
The character(s) to record. This may be a single character code, or multiple
characters in a string, if the glyph maps to several characters. It will be
normalized to a string internally.
glyph : GlyphIndexType
The corresponding glyph index to record.
Returns
-------
subset : int
The subset in which the returned character code resides. If *subset_size*
was not specified on this instance, then this is always 0.
subset_charcode : CharacterCodeType
The character code within the above subset. If *subset_size* was not
specified on this instance, then this is just *charcode* unmodified.
r r )
isinstancerb ordchrr r r r8 rp
setdefaultrH rT ro lenrq appendr^ ) rP r? charsglyphr] font_path glyph_mapresult subset_mapsuse_next_charmapr rY s r ry CharacterTracker.track_glyph sY 2 eS ! !58}H HJE ))$**dooF OO..y(*E ]]50 06 0Mii**9rd;
JN
!
, ,, . 1~- ; 1$KO(<@P@P(P""2&%)F !+b/ 2OF &O/4FO,
eF<((rB c D U R U R X#5 S $ )a
Map a subset index and character code to a Unicode character code.
Parameters
----------
fontname : str
The name of the font, from the *used* dictionary key.
subset : int
The subset index within a font.
subset_charcode : CharacterCodeType
The character code within a subset to map back.
Returns
-------
str
The Unicode character(s) corresponding to the subsetted character code.
r )rp rZ )rP fontnamer rY s r subset_to_unicode"CharacterTracker.subset_to_unicode/ s# & x(--fFqIIrB )rp rq ro )r )rq rc )NN)
r? r r| rb rt ztuple[str, ...] | Noneru z-str | tuple[tuple[str, int, int], ...] | Noner` z#list[tuple[int, CharacterCodeType]])r? r r zstr | CharacterCodeTyper r r` z tuple[int, CharacterCodeType])r rb r rc rY r
r` rb )
rd re rf rg rh rQ r~ ry r ri rj rB r rl rl sb 4
' 26HL#
.#
E#
7#
J>))>).K>)@J+<JADJrB rl c ^ ^ \ rS rSrU 4S jrS rS rS rS rS r U 4S jr
S r S
r S r
U =r$ ) RendererPDFPSBaseiE c : > [ TU ] 5 Xl X l g rK )superrQ widthheight)rP r r __class__s r rQ RendererPDFPSBase.__init__J s
rB c g)NFrj rO s r flipyRendererPDFPSBase.flipyO s rB c g)NTrj rO s r option_scale_image$RendererPDFPSBase.option_scale_imageS s rB c 2 [ R S ( + $ )Nzimage.composite_image)mplrcParamsrO s r option_image_nocomposite*RendererPDFPSBase.option_image_nocompositeW s << 7888rB c > U R S- U R S- 4$ )Ng R@)r r rO s r get_canvas_width_height)RendererPDFPSBase.get_canvas_width_height\ s zzD $++"444rB c [ R U R ( d gU R U5 nUR 5 S- nUR 5 U- nUR
5 * U- nXE- S- nXEU4$ )a
Return the ascent, descent, and line gap for font described by *prop*.
TODO: This is a temporary method until we design a proper API for the backends.
Parameters
----------
prop : `.font_manager.FontProperties`
The properties describing the font to measure.
Returns
-------
ascent, descent, line_gap : float or None
The ascent, descent and line gap of the determined font, or None to fall
back to normal measurements.
)NNN g?)r r _use_afm_rc_name
_get_font_afmget_size_in_points get_ascender
get_descender)rP propr? scaleadgs r _get_font_height_metrics*RendererPDFPSBase._get_font_height_metrics` sy " ||D 1 12#!!$''')D0 % '
! !E )
UcMQwrB c > US:X a [ T U ] XU5 $ U( aJ U R R R USU5 nUR
UR UR 4$ [ R U R ( aI U R U5 nUR U5 u pgpn
UR 5 S- n X- nX- n X- n
XU
4$ U R U5 nUR US[ R" R$ S9 UR' 5 u pUR) 5 n
Sn X- nX- n X- n
XU
4$ )NTeXH r g )flagsg ?)r get_text_width_height_descent
_text2pathmathtext_parserparser r depthr r r r get_str_bbox_and_descentr
_get_font_ttfset_textr rw rx get_width_height get_descent)
rP r| r ismathr r? lbwhr r r s
r r /RendererPDFPSBase.get_text_width_height_descentz s. U?78&I I
OO3399!RFE;; ekk9 9
\\$//
0%%d+D 9 9! >tD ((0D JJL MM$113R 8K h ' / /239
;
s AA) )6B )r r )rd re rf rg rQ r r r r r r r r ri
__classcell__)r s @r r r E s5
9
5441
rB r )r= r r> zset[GlyphIndexType]r` r )"rh
__future__r ior functoolsr typing fontToolsr
matplotlibr r r _afmr
backend_basesr
TYPE_CHECKINGr r
r r fontTools.ttLibr _FONT_MAX_GLYPH lru_cacher rA rF rH rl r rj rB r r s #
$ (
&CC&
R
4n&0K 0Kf_J _JD_ _rB