j= S r SSKJr SSKJr SSKJr SSKrSSKrSSK r SSK
J r SSK r
SSKJrJr SS KJr SS
KJr \ R* ( a" SS KJr SS KJr S
SKJr S
SKJrJrJ r SSK J r SSS.r \R@ " S5 S 5 r! " S S\ RD 5 r# S S jr$S r% " S S5 r& " S S 5 r' " S S \5 r(g)!z7
Common functionality between the PDF and PS backends.
) annotations)contextmanager)BytesION)subset ) font_managerft2font)AFM) RendererBase) Generator)AbstractContextManager )FontPath)CharacterCodeTypeFT2FontGlyphIndexType)TTFont i ) * 2 c f [ U S5 n[ U5 sS S S 5 $ ! , ( d f g = f)Nrb)openr
)fnamefhs ڱC:\Users\johnn\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.13_qbz5n2kfra8p0\LocalCache\local-packages\Python313\site-packages\matplotlib/backends/_backend_pdf_ps.py_cached_get_afm_from_fnamer $ s!
eT b2w
s "
0c B \ rS rSr% SrS\S' S\S' \S
S j5 rSrg )
SubsetResultsr z
The results of a subsetting operation on a font.
Attributes
----------
font : TTFont
An open font object representing the subset.
glyph_index_map : dict
Mapping of requested glyph indices to actual subset glyph indices.
r fontz$dict[GlyphIndexType, GlyphIndexType]glyph_index_mapc # ` # U R U v S S S 5 g ! , ( d f g = f7fN)r! selfs r _as_cmSubsetResults._as_cm9 s
YYJ YYs
. .
+. N)returnz$Generator[SubsetResults, None, None]) __name__
__module__ __qualname____firstlineno____doc____annotations__r r' __static_attributes__r) r r r * s& L99 r2 r c V [ R " SSS9nU=R / SQ-
sl U R Ul [ R
" X5 n[ R " US9nUR US9 UR U5 [ X4R 5 R 5 $ )a.
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
-------
SubsetResults
The font and new glyph index mapping.
T) glyph_namesrecommended_glyphs)FFTMPfEdBDFmetaMERGTSIVZapfbdatbloccidgfdscfeatfmtxfondjustkerxltagmorxtrakxref)options)gids) r Options drop_tables
face_index font_number load_font Subsetterpopulater r" r' )fontfileglyphsrJ r! subsetters r get_glyphs_subsetrV ? s ( nn$GG . #--G H .D 1I
F#
T 8 8 9 @ @ BBr2 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_filerZ v s
BIIbI&
Ir2 c X \ rS rSrSrS S jr S
S jr S S jr S S jrSr g)
GlyphMap 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 r$ _forward_inverser% s r __init__GlyphMap.__init__ s =?
IK
r2 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.
)r` get)r& charcodes glyph_indexs r re GlyphMap.get s }} )!9::r2 c " U R X4 $ )z>Get the inverse mapping from a (subset, subset charcode)-pair.)ra )r& r subset_charcodes r iget
GlyphMap.iget s }}f 677r2 c H X44U R X4' X4U R X44' g)ad
Add a mapping to this instance.
Parameters
----------
charcode : CharacterCodeType
The character code to record.
glyph_index : 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.
Nr_ )r& charcoderg r rj s r add GlyphMap.add s, 391J
x-.4<3J
v/0r2 r_ N)r* None)rf strrg r r* z$tuple[int, CharacterCodeType] | None)r intrj r r* ztuple[str, GlyphIndexType])
rn rr rg r r rs rj r r* rq )
r+ r, r- r. r/ rb re rk ro r1 r) r2 r r\ r\ sO K ;';,P;8 /84N8
K .K37Kr2 r\ 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)r& rz s r rb CharacterTracker.__init__ s OQ /1&r2 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_objectcharrg )r& r! sr} r~ 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 )
isinstancerr ordchrr r r rN ry
setdefaultr\ re rx lenrz appendro ) r& r! charsglyphrn font_path glyph_mapresult subset_mapsuse_next_charmapr rj s r r 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<((r2 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 )ry rk )r& fontnamer rj s r subset_to_unicode"CharacterTracker.subset_to_unicodeH s# & x(--fFqIIr2 )ry rz rx )r )rz rs )NN)
r! r r rr r} ztuple[str, ...] | Noner~ 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 rr r rs rj r r* rr )
r+ r, r- r. r/ rb r r r r1 r) r2 r ru ru sb 4
' 26HL#
.#
E#
7#
J>))>).K>)@J+<JADJr2 ru c ^ ^ \ rS rSrU 4S jrS rS rS rS rS r U 4S jr
S r S
r S r
U =r$ ) RendererPDFPSBasei^ c : > [ TU ] 5 Xl X l g r$ )superrb widthheight)r& r r __class__s r rb RendererPDFPSBase.__init__c s
r2 c g)NFr) r% s r flipyRendererPDFPSBase.flipyh s r2 c g)NTr) r% s r option_scale_image$RendererPDFPSBase.option_scale_imagel s r2 c 2 [ R S ( + $ )Nzimage.composite_image)mplrcParamsr% s r option_image_nocomposite*RendererPDFPSBase.option_image_nocompositep s << 7888r2 c > U R S- U R S- 4$ )Ng R@)r r r% s r get_canvas_width_height)RendererPDFPSBase.get_canvas_width_heightu s zzD $++"444r2 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)r& propr! scaleadgs r _get_font_height_metrics*RendererPDFPSBase._get_font_height_metricsy sy " ||D 1 12#!!$''')D0 % '
! !E )
UcMQwr2 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 r r get_width_height get_descent)
r& r r ismathr r! lbwhr r r s
r r /RendererPDFPSBase.get_text_width_height_descent 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 )r+ r, r- r. rb r r r r r r r r r1
__classcell__)r s @r r r ^ s5
9
5441
r2 r )rS r rT zset[GlyphIndexType]r* z%AbstractContextManager[SubsetResults]))r/
__future__r
contextlibr ior functoolsr typing fontToolsr
matplotlibr r r _afmr
backend_basesr
TYPE_CHECKINGcollections.abcr r
r r r r fontTools.ttLibr _FONT_MAX_GLYPH lru_cacher
NamedTupler rV rZ r\ ru r r) r2 r r s # %
$ (
)1&CC&
R
F%% *4C4C 34C*4Cn&0K 0Kf_J _JD_ _r2