hf ddlmZddlmZmZmZddlZddlZddlZddl Z ddl Z ddl m Z ddl mZddlmZmZmZmZddlmZdd lmZdd lmZmZerdd lmZdd lmZmZej@d Z!dZ"da#dZ$eZiddddddddddddddddddddd d!d"d!d#d$d%d$d&d'd(d'd)d*d*d+d+d,d,d-d-d.d.d/d/d0 Z%d1d1d2Z&e%jODcic]\}}|jQd3s||c}}Z)d4Z*d5Z+d6Z,dad7Z-dad8Z.dbd9Z/dcd:Z0ddd;Z1ded<Z2dfded=Z3dgd>Z4dhded?Z5dfdid@Z6dAdBdCdDddE djdFZ7dkdGZ8dHZ9dIZ:dddJZ;dldKZGdNdOej~Z@GdPdQZAGdRdSeAZBGdTdUeAejZDGdVdWeDZEGdXdYeDZFdndZZGGd[d\eDZHGd]d^eDZI do dpd_ZJdqdrd`ZKe9ycc}}w)s) annotations)Optional TYPE_CHECKINGcastN)options)FontFace) FontManagerSUPPORTED_TTF_TYPESFontNotFoundErrorUnsupportedFont) FONT_SYNONYMS)FontMeasurements) GlyphPathGlyphs)Drawing) DXFEntity Textstyleezdxffont_manager_cache.jsonFz.cacheAMGDTz amgdt___.ttfz AMGDT.SHXCOMPLEXz complex_.ttfz COMPLEX.SHXISOCPz isocp.ttfz ISOCP.SHXITALICz italicc_.ttfz ITALIC.SHXGOTHICGz gothicg_.ttfz GOTHICG.SHXGREEKCz greekc.ttfz GREEKC.SHXROMANSz romans__.ttfz ROMANS.SHXSCRIPTSz scripts_.ttfz SCRIPTS.SHXSCRIPTCz scriptc_.ttfz simplex_.ttfz symath__.ttfz symap___.ttfz symeteo_.ttfz txt_____.ttf) z SCRIPTC.SHXSIMPLEXz SIMPLEX.SHXSYMATHz SYMATH.SHXSYMAPz SYMAP.SHXSYMETEOz SYMETEO.SHXTXTTXT.SHXz standard.lff)r$r%SHXgZd;O?gZd;O?z *monospacecH|j}|tvr t|}|S)zEMap .shx font names to .ttf file names. e.g. "TXT" -> "txt_____.ttf" )upper SHX_FONTS) font_name font_uppers 1lib/python3.12/site-packages/ezdxf/fonts/fonts.pymap_shx_to_ttfr-Ts("JYj) c|j}tj|d}tj |r|S|j ds|dz}n|dddz}tj |r|S|S)zEMap .shx font names to .lff file names. e.g. "TXT" -> "standard.lff" z.SHX.lffN)r( LFF_FONTSget font_managerhas_fontendswith)r*r+namelff_names r,map_shx_to_lffr:]sr"J ==R (DT"   v &v%Sb>F*X& r.cR|j}|jdryd|vryy)N.shxT.F)lowerr7)r*r8s r,is_shx_font_namer?ls* ?? D }}V $ r.cHtj|jS)zEMaps .ttf filenames to .shx font names. e.g. "txt_____.ttf" -> "TXT" ) TTF_TO_SHXr4r>)ttfs r,map_ttf_to_shxrCus >>#))+ &&r.c*tty)zBuilds or rebuilds the font manager cache. The font manager cache has a fixed location in the cache directory of the users home directory "~/.cache/ezdxf" or the directory specified by the environment variable "XDG_CACHE_HOME". N)build_font_manager_cache_get_font_manager_pathr.r,build_system_font_cacherHzs 356r.c,tj|S)zqReturns the :class:`FontFace` definition for the given font filename e.g. "LiberationSans-Regular.ttf". )r5 get_font_face)r*s r,find_font_facerKs  % %i 00r.cht|ts td|r t|}t |S)a/Returns the :class:`FontFace` definition for the given font filename e.g. "LiberationSans-Regular.ttf". This function translates a DXF font definition by the TTF font file name into a :class:`FontFace` object. Returns the :class:`FontFace` of the default font when a font is not available on the current system. Args: font_name: raw font file name as stored in the :class:`~ezdxf.entities.Textstyle` entity map_shx: maps SHX font names to TTF replacement fonts, e.g. "TXT" -> "txt_____.ttf" font_name has invalid type) isinstancestr TypeErrorr-rK)r*map_shxs r,rJrJs2 i %455"9- ) $$r.ct|dk(r|S|j}|D]}|dk(r%t|}tj |s)|cS|dk(r>|jj ds|dz }tj |sl|cS|dk(svt |}tj |s|cS|S)zResolves a .shx font name, the argument `order` defines the resolve order: - "t" = map .shx fonts to TrueType fonts (.ttf, .ttc, .otf) - "s" = use shapefile fonts (.shx, .shp) - "l" = map .shx fonts to LibreCAD fonts (.lff) rtsr<l)lenr>r-r5r6r7r:)r*ordertype_strr8s r,resolve_shx_font_namerYs 5zQ KKME s?!),D$$T* _??$--f5V# $$Y/  _!),D$$T*  r.c|t|ts tdt|r t ||}t |S)aReturns the :class:`FontFace` definition for the given font filename e.g. "LiberationSans-Regular.ttf". This function translates a DXF font definition by the TTF font file name into a :class:`FontFace` object. Returns the :class:`FontFace` of the default font when a font is not available on the current system. The order argument defines the resolve order for .shx fonts: - "t" = map .shx fonts to TrueType fonts (.ttf, .ttc, .otf) - "s" = use shapefile fonts (.shx, .shp) - "l" = map .shx fonts to LibreCAD fonts (.lff) Args: font_name: raw font file name as stored in the :class:`~ezdxf.entities.Textstyle` entity order: resolving order rM)rNrOrPr?rYrK)r*rWs r,resolve_font_facer[s9( i %455 "))U; ) $$r.c|r t|}n"t|rtddttSt |d}|j S)aFGet :class:`FontMeasurements` for the given font filename e.g. "LiberationSans-Regular.ttf". Args: font_name: raw font file name as stored in the :class:`~ezdxf.entities.Textstyle` entity map_shx: maps SHX font names to TTF replacement fonts, e.g. "TXT" -> "txt_____.ttf" rrbaseline cap_heightx_heightdescender_height)r_)r-r?rX_HEIGHT_FACTORDESCENDER_FACTOR TrueTypeFont measurements)r*rQfonts r,get_font_measurementsrgsL"9- ) $$-    a 0D   r.z sans-serifRegularfamilystyleweightwidthitalicc4tj|||||S)aReturns a :class:`FontFace` that matches the given properties best. The search is based the descriptive properties and not on comparing glyph shapes. Returns ``None`` if no font was found. Args: family: font family name e.g. "sans-serif", "Liberation Sans" style: font style e.g. "Regular", "Italic", "Bold" weight: weight in the range from 1-1000 (usWeightClass) width: width in the range from 1-9 (usWidthClass) italic: ``True``, ``False`` or ``None`` to ignore this flag )r5find_best_matchrks r,rrrrs(  ' 'vuf MMr.c,tj|S)zQReturns the true type font file name without parent directories e.g. "Arial.ttf".)r5find_font_name) font_faces r,find_font_file_namervs  & &y 11r.cNttjtdy)zcReload all cache files. The cache files are loaded automatically at the import of `ezdxf`. T)reverseN)_load_font_managerr5 add_synonymsrrGr.r,loadr{ smT:r.cHtjdt}|tz S)NXDG_CACHE_HOME)rxdg_pathCACHE_DIRECTORYFONT_MANAGER_CACHE_FILE) cache_paths r,rFrFs!!!"2ODJ / //r.ct}|jr% tj|j yt|y#t $r+}t jdt|Yd}~;d}~wwxYw)NError loading cache file: ) rFexistsr5loads read_textIOErrorloggerinforOrE)fm_pathes r,ryrysj$&G~~ ?   w002 3 W% ? KK4SVH= > > ?s#A B!A;;Bcdatj|dz }|jr% tj |j ytjt|gdtj} |j|y#t $r!}tdt|Yd}~md}~wwxYw#t $r!}tdt|Yd}~yd}~wwxYw)zLoad font manger cache for system under test (sut). Load the fonts included in the repository folder "./fonts" to guarantee the tests have the same fonts available on all systems. This function should be called from "conftest.py". TrNrF) support_dirszError writing cache file: ) SUT_FONT_MANAGER_CACHEr5clearrrrrprintrObuilddumps write_text)repo_font_path cache_filerrTs r,build_sut_font_manager_cacher%s"";;J 9   z335 6 N+,5AA5a  9 .s1vh7 8 8 9 5 *3q6(3445s/#BC C"B>>C C0C++C0cj|js |jdyy#t$rYywxYw)NT)parents)rmkdirr)paths r,make_cache_directoryr@s7 ;;=  JJtJ $    s & 22ctjtjtj}|j}t ||j s#tjdt|dy |j|y#t$r,}tjdt|dYd}~yd}~wwxYw)Nz%Cannot create cache home directory: 'z\', cache files will not be saved. See also issue https://github.com/mozman/ezdxf/issues/923.zError writing cache file: '') r5rrrparentrrrwarningrOrr)rrT cache_dirrs r,rErEHsA I#    3C N3CDX Y  @  @4SVHA>??@sB C#"C  CcFeZdZejZejZy)FontRenderTypeN)__name__ __module__ __qualname__enumautoOUTLINESTROKErGr.r,rrZsdiikGYYFr.rcZeZdZUdZej ZdZded<d dZ e jddZ e j d ddZ e jddZe jdd Ze j d dd Ze j d dd Zy ) AbstractFontzJThe `ezdxf` font abstraction for text measurement and text path rendering. undefinedrOr8c||_yN)re)selfres r,__init__zAbstractFont.__init__hs (r.cy)DReturns the text width in drawing units for the given `text` string.NrGrtexts r, text_widthzAbstractFont.text_widthk r.cy)nReturns the text width in drawing units, bypasses the stored `cap_height` and `width_factor`. NrGrrr_ width_factors r, text_width_exzAbstractFont.text_width_exps r.cy)z=Returns the width of a "space" character a.k.a. word spacing.NrGrs r, space_widthzAbstractFont.space_widthyrr.cy),Returns the 2D text path for the given text.NrGrs r, text_pathzAbstractFont.text_path~s r.cy)iReturns the 2D text path for the given text, bypasses the stored `cap_height` and `width_factor`.NrGrs r, text_path_exzAbstractFont.text_path_ex r.cy)qReturns a list of 2D glyph paths for the given text, bypasses the stored `cap_height` and `width_factor`.NrGrs r,text_glyph_pathszAbstractFont.text_glyph_pathsrr.N)rerrrOreturnfloat?rrOr_rrrrrrrrrOrrrrOr_rrrrrrrOr_rrrrzlist[GlyphPath])rrr__doc__rrfont_render_typer8__annotations__rabcabstractmethodrrrrrrrGr.r,rrbs%T%,,D#)    BE  %* :?          BE  %* :?    BE  %* :?   r.rceZdZdZej ZeZdde e f d fd Z d dZ d ddZ ddZ d ddZ d dd Zdd ZxZS) MonospaceFontauRepresents a monospaced font where each letter has the same cap- and descender height and the same width. The given cap height and width factor are the default values for measurements and rendering. The extended methods can override these default values. This font exists only for generic text measurement in tests and does not render any glyphs! rrc t|t||||z||zt||_|j j |jz|_y)Nr])superrrabs _width_factorrer_ _space_width)rr_rr^descender_factorx_height_factor __class__s r,rzMonospaceFont.__init__s_  !%#o5!+.>!>   %( $5 --884;M;MMr.cd|j||jj|jS)z=Returns the text width in drawing units for the given `text`.)rrer_rrs r,rzMonospaceFont.text_widths.!! $##..0B0B  r.c$t||z|zS)r)rVrs r,rzMonospaceFont.text_width_exs 4y:% 44r.cd|j||jj|jS)zOReturns the rectangle text width x cap height as :class:`NumpyPath2d` instance.)rrer_rrs r,rzMonospaceFont.text_paths)  t'8'8'C'CTEWEWXXr.cddlm}|j|||}|d}|j|df|j||f|jd|f|j t |S)zReturns the rectangle text width x cap height as :class:`NumpyPath2d` instance, bypasses the stored `cap_height` and `width_factor`. r)Path)rr) ezdxf.pathrrline_tocloser)rrr_rrrps r,rzMonospaceFont.text_path_exsh $''j,G L :q/" :z*+ 1j/"  |r.c*|j|||gS)zHReturns the same rectangle as the method :meth:`text_path_ex` in a list.)rrs r,rzMonospaceFont.text_glyph_pathss!!$ LABBr.c|jSz$Returns the width of a "space" char.rrs r,rzMonospaceFont.space_width   r.) r_rrrr^rrrrrrrrrrrr)rrrrrrr MONOSPACEr8rcrbrrrrrrr __classcell__rs@r,rrs&,, D ""2!0 NNN N  N  N& CF55%*5:?5 5Y CF%*:? "CFCC%*C:?C C !r.rceZdZUdZeZded<d d fd ZejddZ ddZ d ddZ ddZ d dd Z d dd Zdd ZxZS) _CachedFontz#Abstract font with caching support.zdict[str, Glyphs] _glyph_cachescL||_|j|}||_t||_t||_|j |j}t|!|jj||jj|z|z|_ yr) r8 create_cache glyph_cacherr_rget_scaling_factorrrfont_measurementsscalerr)rr*r_rcache scale_factorrs r,rz_CachedFont.__init__s !!),  +!,/#66tG  0066|DE    ( (< 7, F r.cyrrG)rr*s r,rz_CachedFont.create_caches r.cP|j||j|jS)r)rr_rrs r,rz_CachedFont.text_widths!!!$9J9JKKr.c^|jsy|jj|||S)rr)striprget_text_lengthrs r,rz_CachedFont.text_width_exs+ zz|//j,OOr.cP|j||j|jS)r)rr_rrs r,rz_CachedFont.text_paths#  t8I8IJJr.c<|jj|||S)r)r get_text_pathrs r,rz_CachedFont.text_path_ex s --dJ MMr.c<|jj|||S)r)rget_text_glyph_pathsrs r,rz_CachedFont.text_glyph_pathss 44T:|TTr.c|jSrrrs r,rz_CachedFont.space_widthrr.r)r*rOr_rrrr*rOrrrrrrrr)rrrrdictrrrrrrrrrrrrrrs@r,rrs-'+vM$-     L CFPP%*P:?P PK CFNN%*N:?N NCFUU%*U:?U U!r.rc0eZdZdZej ZddZy)rdaRepresents a TrueType font. Font measurement and glyph rendering is done by the `fontTools` package. The given cap height and width factor are the default values for measurements and glyph rendering. The extended methods can override these default values. cddlm}tj|jj } |j |S#t$rYnwxYw tj|} ||}n#t$rtwxYwnZ#t$rNtj}tjd|d|d|tj|}YnwxYw||j |<|S)NrTTFontRendererzreplacing unsupported font 'z' by 'r)ttfontsrpathlibrr8r>rKeyErrorr5 get_ttf_font Exceptionr fallback_font_namerr)rrBrkeytt_fontrrs r,rzTrueTypeFont.create_cache&s+ll3$$**, %%c* *    R"//4G &&w/ &%% & R!-!@!@!B  KK6se6BTAUUVW X"<#<#<=O#PQE R#(3 s<A AAB*A32B3BBACCNrBrOrr)rrrrrrrrrGr.r,rdrds &--r.rdc,eZdZejZddZy)_UnmanagedTrueTypeFontcddlm}ddlm}|j } |j |S#t $rYnwxYw|||d}||j |<|S)Nrr r)TTFont) fontNumber)rrfontTools.ttLibrr>rr)rrBrrrrs r,rz#_UnmanagedTrueTypeFont.create_cache?sa+*iik %%c* *   vca89"'3 s - 99Nr)rrrrrrrrGr.r,rr<s%-- r.rc,tt||S)aThis function bypasses the FontManager and loads the TrueType font straight from the file system, requires the absolute font file path e.g. "C:/Windows/Fonts/Arial.ttf". .. warning:: Expert feature, use with care: no fallback font and no error handling. )rrO) font_pathr_s r, sideload_ttfr Ms "#i.* ==r.c0eZdZdZej ZddZy) ShapeFileFonta(Represents a shapefile font (.shx, .shp). Font measurement and glyph rendering is done by the ezdxf.fonts.shapefile module. The given cap height and width factor are the default values for measurements and glyph rendering. The extended methods can override these default values. c|j} |j|S#t$rYnwxYwtj |}||j|<|Sr)r>rrr5get_shapefile_glyph_cacherr*rrs r,rzShapeFileFont.create_cacheds\oo %%c* *   "<rrr5get_lff_glyph_cacher%s r,rzLibreCadFont.create_cacheys\oo %%c* *   "66yA "-3r&Nr r'rGr.r,r*r*or(r.r*c\|tk(r t||Stj|jj }t||}|t vr t|||S|dk(s|dk(r t|||S|dk(r t!|||S|dk(r1tj#|dd}|Ct%|j&||Stjd|tj} t|||S#t$r-}tjdt||cYd}~Sd}~wwxYw#t$rYRt$rtj}YpwxYw#t$rYwxYw#t$r-}tjdt||cYd}~Sd}~wwxYw) uReturns a font abstraction based on class :class:`AbstractFont`. Supported font types: - .ttf, .ttc and .otf - TrueType fonts - .shx, .shp - Autodesk® shapefile fonts - .lff - LibreCAD font format The special name "\*monospace" returns the fallback font :class:`MonospaceFont` for testing and basic measurements. .. note:: The font definition files are not included in `ezdxf`. Args: font_name: font file name as stored in the :class:`~ezdxf.entities.Textstyle` entity e.g. "OpenSans-Regular.ttf" cap_height: desired cap height in drawing units. width_factor: horizontal text stretch factor zno default font found: Nr<z.shpr1r0)rlrmrpzunsupported font-name suffix: )rrrrsuffixr>r rdr rrrOr"r r5rr*rr make_fontfilename)r*r_rext last_resortrrus r,r/r/s.IZ66 ,,y ! ( ( . . 0C L9K !!  :|D D #- : J E E   :|D D  00F41   Y//\J J7 {CD 335 Iz<@@9!  NN4SVH= >   !   :$779I : !    0Q9:sf D0 D9 E&3 E5 D6 "D1+D61D69 E#E#"E#& E21E25 F+>"F& F+&F+c|jr| |j}| tSd}|jjdr|jj}t}|rzt d|j j|}|j\}}}|r|rdnd}|rdnd} t||| }|S|jj} | r t| }|S) aReturns the :class:`FontFace` defined by the associated text style. Returns the default font face if the `entity` does not have or support the DXF attribute "style". Supports the extended font information stored in :class:`~ezdxf.entities.Textstyle` table entries. Pass a DXF document as argument `doc` to resolve text styles for virtual entities which are not assigned to a DXF document. The argument `doc` always overrides the DXF document to which the `entity` is assigned to. r0rmrItalicrhiri)rlrmrn) docr dxf is_supportedrmrstylesr4get_extended_font_datarfrJ) entityr5 style_namerurmrlrpbold text_style text_weightrBs r,get_entity_font_facer?szzckjj {zJzzw'ZZ%%  I[#**.."<=$;;= %+J!%#3K jUI ))..C)#. r.)r*rOrrO)r*rOrbool)rBrOrz Optional[str])rNone)r*rOrr )T)r*rOrWrOrrO)tsl)r*rOrr) rlrOrmrOrnintrorCrpzOptional[bool]rzOptional[FontFace])rur rrO)r pathlib.PathrrA)rrDrrA)rzstr | os.PathLikerrr)r*rOr_rrrrrr)r:rr5zOptional[Drawing]rr )L __future__rtypingrrrrrloggingosrrrrur r5r r r r font_synonymsrrrglyphsrrezdxf.documentrezdxf.entitiesrr getLoggerrrrrr)r3itemsr7rArcrbrr-r:r?rCrHrKrJrYr[rgrrrvr{rFryrrrEEnumrrrABCrrdrr r"r*r/r?)kvs00r,rSs#00   )/%&3   7 #3} '  ^' ' ~' >'  ['  !' " n#' $.%' &~'' (>)' * l+' ,,-' . n/' 0.1' 2~3' 4>5' 6~7' 8"! ! M'  R    )0 F0tq!AJJu4Ead0 F    ' 71%,8%64" N N N  N  N  NN.2 ;0 &56@$TYY/ / dK!LK!\8!,8!v;>[" >K*;,>A== %=5:==@"JwGs G)5G)