OwlCyberSecurity - MANAGER
Edit File: afm.cpython-38.pyc
U ��]�D � @ s" d Z ddlmZ ddlZddlZddlmZ ddlmZ e� e �Z dd� Z d d � Z d d � Zd d� Zdd� Zdd� Zdd� Zdd� Zedd�Zde_ dej_ dej_ d ej_ d d � Zd d � Zed!d"�Zd#e_ d$ej_ d%ej_ d&ej _ d'd(� Z d)d*� Z ed+d,d-�d.d/� �Z d0d1� Z G d2d3� d3e!�Z"dS )4a� This is a python interface to Adobe Font Metrics Files. Although a number of other python implementations exist, and may be more complete than this, it was decided not to go with them because they were either: 1) copyrighted or used a non-BSD compatible license 2) had too many dependencies and a free standing lib was needed 3) Did more than needed and it was easier to write afresh rather than figure out how to get just what was needed. It is pretty easy to use, and requires only built-in python libs: >>> from matplotlib import rcParams >>> import os.path >>> afm_fname = os.path.join(rcParams['datapath'], ... 'fonts', 'afm', 'ptmr8a.afm') >>> >>> from matplotlib.afm import AFM >>> with open(afm_fname, 'rb') as fh: ... afm = AFM(fh) >>> afm.string_width_height('What the heck?') (6220.0, 694) >>> afm.get_fontname() 'Times-Roman' >>> afm.get_kern_dist('A', 'f') 0 >>> afm.get_kern_dist('A', 'y') -92.0 >>> afm.get_bbox_char('!') [130, -9, 238, 676] As in the Adobe Font Metrics File Format Specification, all dimensions are given in units of 1/1000 of the scale factor (point size) of the font being used. � )� namedtupleN� )� uni2type1)� deprecatedc C s t t| ��S �N)�int�float��x� r �0/usr/lib/python3/dist-packages/matplotlib/afm.py�_to_int4 s r c C s$ t | t�r| �d�} t| �dd��S )Nzlatin-1�,�.)� isinstance�bytes�decoder �replacer r r r � _to_float= s r c C s | � d�S )N�utf8)r r r r r �_to_strH s r c C s | � dd�} dd� | �� D �S )N� ,� c S s g | ] }t |��qS r )r ��.0�valr r r � <listcomp>N s z$_to_list_of_ints.<locals>.<listcomp>)r �split��sr r r �_to_list_of_intsL s r c C s dd� | � � D �S )Nc S s g | ] }t |��qS r )r r r r r r R s z&_to_list_of_floats.<locals>.<listcomp>)r r r r r �_to_list_of_floatsQ s r! c C s | � � �� dkrdS dS d S )N)s false� 0s noFT)�lower�stripr r r r �_to_boolU s r% c C s: | � � }z t| �}W 5 | �|d� X |�d�s6td��dS )zP Check if the file looks like AFM; if it doesn't, raise `RuntimeError`. r � StartFontMetricszNot an AFM fileN)�tell�seek�next� startswith� RuntimeError)�fh�pos�liner r r � _sanity_check\ s r/ c C s t ttttt ttt t tdd� tt t t t t t t tttd�}i }| D ]�}|�� }|�d�rXq@|�dd�}|d }t|�dkr�|d }nd }z || }W n& t k r� t � d | � Y q@Y nX z||�||< W n& t k r� t � d ||� Y q@Y nX |d kr@| S q@t d ��dS )a= Reads the font metrics header (up to the char metrics) and returns a dictionary mapping *key* to *val*. *val* will be converted to the appropriate python type as necessary; e.g.: * 'False'->False * '0'->0 * '-168 -218 1000 898'-> [-168, -218, 1000, 898] Dictionary keys are StartFontMetrics, FontName, FullName, FamilyName, Weight, ItalicAngle, IsFixedPitch, FontBBox, UnderlinePosition, UnderlineThickness, Version, Notice, EncodingScheme, CapHeight, XHeight, Ascender, Descender, StartCharMetrics c S s | S r r r r r r �<lambda>� � z _parse_header.<locals>.<lambda>)r& � FontName� FullName� FamilyName� Weight� ItalicAngles IsFixedPitchs FontBBoxs UnderlinePosition� UnderlineThicknesss Versions Notices EncodingScheme� CapHeights Capheight� XHeights Ascenders Descender� StdHW� StdVW� StartCharMetricss CharacterSets Characterss Commentr r r � r1 z/Found an unknown keyword in AFM header (was %r)z)Value error parsing header in AFM: %s, %sr< � Bad parseN)r r r% r r �rstripr* r �len�KeyError�_log�error� ValueErrorr+ )r, Zheader_converters�dr. Zlst�keyr Z converterr r r � _parse_headero s^ � rG � CharMetricszwidth, name, bboxz� Represents the character metrics of a single character. Notes ----- The fields do currently only describe a subset of character metrics information defined in the AFM standard. zThe character width (WX).zThe character name (N).zK The bbox of the character (B) as a tuple (*llx*, *lly*, *urx*, *ury*).c C s� ddddh}i }i }| D ]�}t |�� �}|�d�r>||f S tdd� |�d�D ��}|�|�sltd | ��t|d �}t|d �}|d }t |d �} t t t | ��} t ||| �} |d kr�d }|d kr�| ||< | ||< qtd ��dS )a� Parse the given filehandle for character metrics information and return the information as dicts. It is assumed that the file cursor is on the line behind 'StartCharMetrics'. Returns ------- ascii_d : dict A mapping "ASCII num of the character" to `.CharMetrics`. name_d : dict A mapping "character name" to `.CharMetrics`. Notes ----- This function is incomplete per the standard, but thus far parses all the sample afm files tried. �CZWX�N�BZEndCharMetricsc s s" | ]}|r|� � �d d�V qdS )� r N)r$ r )r r r r r � <genexpr>� s z&_parse_char_metrics.<locals>.<genexpr>�;zBad char metrics line: %sZEuro� ���r> N)r r? r* �dictr �issubsetr+ r r r! �list�mapr rH ) r, Z required_keysZascii_dZname_dr. �valsZnum�wx�name�bboxZmetricsr r r �_parse_char_metrics� s, rY c C s� t | �}|�d�s td| ��i }| D ]�}|�� }|s8q&|�d�rRt | � | S |�� }t|�dksr|d dkr~td| ��t|d �t|d �t|d � }}}||||f< q&td ��d S ) z� Return a kern pairs dictionary; keys are (*char1*, *char2*) tuples and values are the kern pair value. For example, a kern pairs line like ``KPX A y -50`` will be represented as:: d[ ('A', 'y') ] = -50 s StartKernPairsz Bad start of kern pairs data: %ss EndKernPairs� r s KPXzBad kern pairs line: %sr r= � zBad kern pairs parseN)r) r* r+ r? r r@ r r )r, r. rE rU �c1�c2r r r r �_parse_kern_pairs� s" (r^ � CompositePartz name, dx, dyzK Represents the information on a composite element of a composite char.z Name of the part, e.g. 'acute'.z+x-displacement of the part from the origin.z+y-displacement of the part from the origin.c C s� i }| D ]�}|� � }|sq|�d�r,| S |�d�}|d �� }|d t|d � }}g }|dd� D ]6}|�� } t| d t| d �t| d ��} |�| � qh|||< qtd��d S ) a� Parse the given filehandle for composites information return them as a dict. It is assumed that the file cursor is on the line behind 'StartComposites'. Returns ------- composites : dict A dict mapping composite character names to a parts list. The parts list is a list of `.CompositePart` entries describing the parts of the composite. Example ------- A composite definition line:: CC Aacute 2 ; PCC A 0 0 ; PCC acute 160 170 ; will be represented as:: composites['Aacute'] = [CompositePart(name='A', dx=0, dy=0), CompositePart(name='acute', dx=160, dy=170)] s EndComposites� ;r r r= rP r[ zBad composites parseN)r? r* r r r_ r �appendr+ ) r, � compositesr. rU ZccrW ZnumPartsZpccPartsr Zpcc�partr r r �_parse_composites% s" rd c C s` t td�}i i d�}| D ]6}|�� }|s*q|�� d }||kr|| | �||< q|d |d fS )aJ Parse the optional fields for kern pair data and composites. Returns ------- kern_data : dict A dict containing kerning information. May be empty. See `._parse_kern_pairs`. composites : dict A dict containing composite information. May be empty. See `._parse_composites`. )� StartKernData� StartCompositesr re rf )r^ rd r? r )r, ZoptionalrE r. rF r r r �_parse_optionalS s �� rg z3.0z the AFM class)Z alternativec C s t | �S r )� _parse_afm)r, r r r � parse_afms s ri c C s6 t | � t| �}t| �\}}t| �\}}|||||fS )a� Parse the Adobe Font Metrics file in file handle *fh*. Returns ------- header : dict A header dict. See :func:`_parse_header`. cmetrics_by_ascii : dict From :func:`_parse_char_metrics`. cmetrics_by_name : dict From :func:`_parse_char_metrics`. kernpairs : dict From :func:`_parse_kern_pairs`. composites : dict From :func:`_parse_composites` )r/ rG rY rg )r, �headerZcmetrics_by_asciiZcmetrics_by_nameZ kernpairsrb r r r rh x s rh c @ s� e Zd Zdd� Zd/dd�Zdd� Zdd � Zd d � Zd0d d �Zd1dd�Z dd� Z d2dd�Z dd� Z dd� Z dd� Zdd� Zd d � Zed d � �Zd d!� Zd"d#� Zd$d%� Zd&d'� Zd(d)� Zd*d+� Zd,d-� Zd.S )3�AFMc C s t |�\| _| _| _| _| _dS )z'Parse the AFM file in file object *fh*.N)rh �_header�_metrics�_metrics_by_name�_kernZ _composite)�selfr, r r r �__init__� s ��z AFM.__init__Fc C s |s t |�}| j| jS r ��ordrm rX �rp �cZisordr r r � get_bbox_char� s zAFM.get_bbox_charc C s� t |�s dS d}d}d}d}|D ]d}|dkr.q | jt|� \}}} ||| j�||fd� 7 }| \} } } } t|| �}t|| | �}|}q ||| fS )zn Return the string width (including kerning) and string height as a (*w*, *h*) tuple. )r r r N� e��A� )r@ rm rs ro �get�min�max)rp r � total_width�namelast�miny�maxyru rV rW rX �l�b�w�hr r r �string_width_height� s zAFM.string_width_heightc C s� t |�s dS d}d}d}d}d}t|t�s2t|�}|D ]�}|dkrDq6t�t|�d�}z| j| \} } } W n( tk r� d}| j| \} } } Y nX || | j �||fd� 7 }| \} } }}t || �}t || �}t || | �}|}q6||||| | fS )z7Return the string bounding box and the maximal descent.)r r r r r r Nrw rx Zquestion) r@ r �strr r ry rs rn rA ro rz r{ )rp r r| r} r~ r �leftru rW rV �_rX r� r� r� r� r r r �get_str_bbox_and_descent� s2 z AFM.get_str_bbox_and_descentc C s | � |�dd� S )z Return the string bounding box.NrZ )r� )rp r r r r � get_str_bbox� s zAFM.get_str_bboxc C s |s t |�}| j| jS )z8Get the name of the character, i.e., ';' is 'semicolon'.)rs rm rW rt r r r � get_name_char� s zAFM.get_name_charc C s |s t |�}| j| jS )zT Get the width of the character from the character metric WX field. )rs rm �widthrt r r r �get_width_char� s zAFM.get_width_charc C s | j | jS )z;Get the width of the character from a type1 character name.)rn r� �rp rW r r r �get_width_from_char_name� s z AFM.get_width_from_char_namec C s |s t |�}| j| jd S )z@Get the bounding box (ink) height of character *c* (space is 0).rP rr rt r r r �get_height_char� s zAFM.get_height_charc C s" | � |�| � |� }}| �||�S )zX Return the kerning pair distance (possibly 0) for chars *c1* and *c2*. )r� �get_kern_dist_from_name)rp r\ r] �name1�name2r r r � get_kern_dist� s zAFM.get_kern_distc C s | j �||fd�S )zf Return the kerning pair distance (possibly 0) for chars *name1* and *name2*. r )ro ry )rp r� r� r r r r� � s zAFM.get_kern_dist_from_namec C s | j d S )z*Return the font name, e.g., 'Times-Roman'.r2 �rl �rp r r r � get_fontname s zAFM.get_fontnamec C s" | j �d�}|dkr | j d }|S )z/Return the font full name, e.g., 'Times-Roman'.r3 Nr2 �rl ry r� r r r � get_fullname s zAFM.get_fullnamec C s2 | j �d�}|dk r|S | �� }d}t�|d|�S )z+Return the font family name, e.g., 'Times'.r4 NzY(?i)([ -](regular|plain|italic|oblique|bold|semibold|light|ultralight|extra|condensed))+$� )rl ry r� �re�sub)rp rW Zextrasr r r �get_familyname s zAFM.get_familynamec C s | � � S )z$The font family name, e.g., 'Times'.)r� r� r r r � family_name s zAFM.family_namec C s | j d S )z0Return the font weight, e.g., 'Bold' or 'Roman'.r5 r� r� r r r � get_weight s zAFM.get_weightc C s | j d S )z Return the fontangle as float.r6 r� r� r r r � get_angle! s z AFM.get_anglec C s | j d S )z Return the cap height as float.r8 r� r� r r r � get_capheight% s zAFM.get_capheightc C s | j d S )z Return the xheight as float.r9 r� r� r r r � get_xheight) s zAFM.get_xheightc C s | j d S )z(Return the underline thickness as float.r7 r� r� r r r �get_underline_thickness- s zAFM.get_underline_thicknessc C s | j �dd�S )zu Return the standard horizontal stem width as float, or *None* if not specified in AFM file. r: Nr� r� r r r �get_horizontal_stem_width1 s z AFM.get_horizontal_stem_widthc C s | j �dd�S )zs Return the standard vertical stem width as float, or *None* if not specified in AFM file. r; Nr� r� r r r �get_vertical_stem_width8 s zAFM.get_vertical_stem_widthN)F)F)F)F)�__name__� __module__� __qualname__rq rv r� r� r� r� r� r� r� r� r� r� r� r� �propertyr� r� r� r� r� r� r� r� r r r r rk � s. rk )#�__doc__� collectionsr Zloggingr� Z_mathtext_datar Zmatplotlib.cbookr Z getLoggerr� rB r r r r r! r% r/ rG rH r� rW rX rY r^ r_ ZdxZdyrd rg ri rh �objectrk r r r r �<module> s@ ' K 4 .