OwlCyberSecurity - MANAGER
Edit File: text.cpython-38.pyc
U ��]s< � @ s� d Z ddlZddlZddlZddlZddlZddlmZm Z m Z m Z ddlm Z ddl mZ ddlmZ ddlmZmZmZ dd lmZ dd lmZmZmZmZm Z m Z e� e �Z ej!d d � �Z"d d� Z#dd� Z$e �%dgdgdgdgdgdgdgdgdgdgdgd gd � �G d d � d e ��Z&e j'j(e�)e&�d � e �*e&j+� e j,d!d"d#�G d$d%� d%e&��Z-e j'j(e�)e-�d&� G d'd(� d(e.�Z/G d)d*� d*e.�Z0G d+d"� d"e&e0�Z1e j'j(e1j+j d,� dS )-z) Classes for including text in a figure. � N� )�artist�cbook� docstring�rcParams)�Artist)�FontProperties)�Line2D)�FancyArrowPatch�FancyBboxPatch� Rectangle)�TextPath)�Affine2D�Bbox�BboxBase�BboxTransformTo�IdentityTransform� Transformc c sB | � � r8| �� }z| �| �� � | V W 5 | �|� X n| V dS )zLTemporarily inserts newlines to the text if the wrap option is enabled. N)�get_wrap�get_text�set_text�_get_wrapped_text)�textobjZold_text� r �1/usr/lib/python3/dist-packages/matplotlib/text.py� _wrap_text s r c C sf zt | �d W S ttfk r` t�| d�s6| dkr<Y dS t�| d�rNY dS td�| ���Y nX dS )z� Return the text angle as float between 0 and 360 degrees. *rotation* may be 'horizontal', 'vertical', or a numeric value in degrees. �h Z horizontalN� Zverticalg �V@zRrotation is {!r}; expected either 'horizontal', 'vertical', numeric value, or None)�float� ValueError� TypeErrorr Z _str_equal�format)�rotationr r r � get_rotation) s �r# c C s� g }g }t �| �� �}t� �| �}| �|�\}}}|D ]\\} } } } | \} }|�| | f�\}}||8 }|| || }}|�||g� |�||g� q8t|�t|� }}t |�| t |�| }}t� �|��||f�\}}||||fS )z� Calculate the bounding box of the text. Unlike :meth:`matplotlib.text.Text.get_extents` method, The bbox size of the text before the rotation is calculated. ) �np�deg2radr# r �rotate� _get_layout�transform_point�extend�min�max)�text�rendererZ projected_xsZ projected_ys�theta�tr�_�parts�d�t�wh�x�y�w�hZxt1Zyt1Zxt2Zyt2Zxt_boxZyt_box�w_box�h_box�x_box�y_boxr r r � _get_textbox< s r= �cZfamilyZfont_propertiesZhaZma�name�size�stretchZstyle�variantZva�weight) �colorZ fontfamily�fontproperties�horizontalalignment�multialignment�fontname�fontsizeZ fontstretch� fontstyleZ fontvariant�verticalalignmentZ fontweightc sd e Zd ZdZdZe�d�Zdd� Zd�d d �Z � fdd�Z � fdd�Z dd� Z dd� Z dd� Zdd� Zdd� Zd d � Zd d � Zd d!� Zd"d#� Zd$d%� Zd&d'� Zd(d)� Zd*d+� Z� fd,d-�Zd�� fd.d/� Z� fd0d1�Zd2d3� Z d4d5� Z d6d7� Z d8d9� Z d:d;� Z d<d=� Z!e"j#d>d?� �Z$d@dA� Z%dBdC� Z&dDdE� Z'dFdG� Z(dHdI� Z)dJdK� Z*dLdM� Z+dNdO� Z,dPdQ� Z-dRdS� Z.dTdU� Z/dVdW� Z0d�dXdY�Z1dZd[� Z2d\d]� Z3d�d^d_�Z4d`da� Z5dbdc� Z6ddde� Z7dfdg� Z8dhdi� Z9djdk� Z:dldm� Z;dndo� Z<dpdq� Z=drds� Z>dtdu� Z?dvdw� Z@dxdy� ZAdzd{� ZBd|d}� ZCd~d� ZDd�d�� ZEeFe�Gd��d�d�d����ZHd�d�� ZId�d�� ZJd�d�� ZKd�d�� ZLd�d�� ZM� ZNS )��TextzAHandle storing and drawing of text in window or data coordinates.� �2 c C s d| j | jt| j�f S )NzText(%s, %s, %s))�_x�_y�repr�_text��selfr r r �__repr__v s z Text.__repr__r � N�baseline�leftFc K s� t �| � || | _| _|dkr(td }|dkr8t� }nt|t�rJt|�}d| _| � |� | � |� | � | � | � | � | � |� | �|� || _| | _|| _d| _d| _| dkr�d} | | _| �| � | �|� dS )zv Create a `.Text` instance at *x*, *y* with string *text*. Valid kwargs are %(Text)s Nz text.colorrV g333333�?)r �__init__rO rP r r � isinstance�strrR r � set_color� set_usetex�set_wrap�set_verticalalignment�set_horizontalalignment�_multialignment� _rotation�_fontproperties� _bbox_patch� _renderer� _linespacing�set_rotation_mode�update)rT r5 r6 r, rD rK rF rG rE r" � linespacing� rotation_mode�usetex�wrap�kwargsr r r rY y s2 z Text.__init__c s4 t � }|�d|�}t� �|� ||k r0| �|� dS )z6 Update properties from a dictionary. �bboxN)�object�pop�superrh �set_bbox)rT rm �sentinelrn �� __class__r r rh � s z Text.updatec s t � �� }d |d< |S )Nre )rq � __getstate__)rT r2 rt r r rv � s zText.__getstate__c C s� | j dk r| � | |�S | �� r(| jdkr0di fS | �� j\}}}}|| || }}|j|j }} || kot|kn o�|| ko�|kn } i } | jr�| j�|�\} } | p�| } | | d< | | fS )z�Test whether the mouse event occurred in the patch. In the case of text, a hit is true anywhere in the axis-aligned bounding-box containing the text. Returns ------- bool : bool NFZ bbox_patch) Z _contains� get_visiblere �get_window_extent�boundsr5 r6 rd �contains)rT Z mouseevent�l�br7 r8 �rr3 r5 r6 ZinsideZcattrZ patch_insideZ patch_cattrr r r rz � s 0z Text.containsc C s | � � \}}| �� �||f�S )zW Get the (possibly unit converted) transformed x, y in display coords. )�get_unitless_position� get_transformr( �rT r5 r6 r r r �_get_xy_display� s zText._get_xy_displayc C s | j d k r| j S | jS d S �N)ra �_horizontalalignmentrS r r r �_get_multialignment� s zText._get_multialignmentc C s t | j�S )z*Return the text angle as float in degrees.)r# rb rS r r r r# � s zText.get_rotationc C s2 |dks|dkr|| _ ntdt|� ��d| _dS )aW Set text rotation mode. Parameters ---------- m : {None, 'default', 'anchor'} If ``None`` or ``"default"``, the text will be first rotated, then aligned according to their horizontal and vertical alignments. If ``"anchor"``, then alignment occurs before rotation. N)�anchor�defaultzUnknown rotation_mode : %sT)�_rotation_moder rQ �stale)rT �mr r r rg � s zText.set_rotation_modec C s | j S )zGet the text rotation mode.)r� rS r r r �get_rotation_mode� s zText.get_rotation_modec C sZ t �| |� |j| _|j| _|j| _|j| _|j�� | _|j| _|j | _ |j | _ d| _ dS )z#Copy properties from other to self.TN) r � update_from�_colorra �_verticalalignmentr� rc �copyrb Z_pickerrf r� )rT �otherr r r r� s zText.update_fromc - s2 | j |d�}|| jkr | j| S d\}}| �� �d�}g }g }g }g } |jd| j| �� r\dndd�\} } } | | | j } t|�D ]�\}}| � |�\}}|r�|j|| j|d�\}}}n d } }}t || �}t || �}|� |� |� |� || | }|dk�r || }n|t | || | j �8 }|� |� | � |� ||8 }q�|}t |�� d}� }d}| d | }|| }t � � | �� �} | �� } | d k�r�d d � t|| �D �} nJ| d k�rʇ fdd �t|| |�D �} n$| dk�r� fdd �t|| |�D �} t�||f||f||f||fg�} | �| �} | dd�df �� }| dd�df � � }| dd�df �� }| dd�df � � }|| � || }| j}!| j}"| �� }#|#dk�r"|!d k�r�|| d }$n|!dk�r�|}$n|}$|"d k�r�|| d }%nD|"dk�r�|}%n4|"dk�r || }%n |"dk�r || |d }%n|}%n�| d \}&}'| d \}(})|!d k�rR|&|( d }$n|!dk�rb|(}$n|&}$|"d k�r~|'|) d }%n@|"dk�r�|)}%n0|"dk�r�|)| }%n |"dk�r�|)|d }%n|'}%| �|$|%f�\}$}%||$8 }||%8 }t�||� |�}*| �| �|$|%f }+|*tt|t||�f|+j �� �|f},|,| j|< |,S )z� return the extent (bbox) of the text together with multiple-alignment information. Note that it returns an extent of a rotated text when necessary. �r- �r r � Zlp�TeXF)�ismathr ���rX c S s g | ]\}}||f�qS r r )�.0r5 r6 r r r � <listcomp>W s z$Text._get_layout.<locals>.<listcomp>�centerc s* g | ]"\}}}|� d |d |f�qS )� r �r� r5 r6 r7 ��widthr r r� Y s ��rightc s" g | ]\}}}|� | |f�qS r r r� r� r r r� \ s �Nr r� r� �toprW �center_baseline� @) � get_prop_tup�_cachedr �split� get_text_width_height_descentrc � get_usetexrf � enumerate�_preprocess_mathr+ �appendr Z rotate_degr# r� �zipr$ �array� transformr* r� r� r� r( r � from_bounds�list�T)-rT r- �keyZthisxZthisy�linesZwsZhsZxsZysr0 Zlp_hZlp_dZmin_dy�i�line� clean_liner� r7 r8 r2 rW �descentZxminZxmaxZymaxZymin�height�MZmalignZ offset_layoutZ corners_horizZcorners_rotatedZhalignZvalignrj ZoffsetxZoffsetyZxmin1Zymin1Zxmax1Zymax1rn ZxysZretr r� r r' s� � � � �� " zText._get_layoutc C s� |dk r�|� � }|�dd�}|�dd�}|dkrNd}|dkr@d}|| �� }n |dkrZd}t|t�rxd|krx|d| 7 }|�dd�}td ||t� d �|��| _nd| _| �� dS ) a� Draw a bounding box around self. Parameters ---------- rectprops : dict with properties for `.patches.FancyBboxPatch` The default boxstyle is 'square'. The mutation scale of the `.patches.FancyBboxPatch` is set to the fontsize. Examples -------- :: t.set_bbox(dict(facecolor='red', alpha=0.5)) N�boxstyle�padZsquare� g333333�?z ,pad=%0.2f�bbox_transmuterr� � �?)r� r� r� )r� r� r� ) r� rp �get_sizerZ r[ r r rd �_update_clip_properties)rT Z rectprops�propsr� r� r� r r r rr � s6 ��� z Text.set_bboxc C s | j S )zf Return the bbox Patch, or None if the `.patches.FancyBboxPatch` is not made. )rd rS r r r �get_bbox_patch� s zText.get_bbox_patchc C s� | j r�| �� }t| �| j��}t| �| j��}|�||f�\}}t| |�\}}}}| j � dd||� t � | � � �} t � �| �} | �|| || �} | j �| � |�| �� �} | j �| � dS )z� Update the location and the size of the bbox. This method should be used when the position and size of the bbox needs to be updated before actually drawing the bbox. r N)rd r r �convert_xunitsrO �convert_yunitsrP r( r= � set_boundsr$ r% r# r r& � translate� set_transform�points_to_pixelsr� �set_mutation_scale) rT r- �trans�posx�posyr; r< r9 r: r. r/ �fontsize_in_pixelr r r �update_bbox_position_size� s z Text.update_bbox_position_sizec C s� t | |�\}}}}| j�dd||� t�| �� �}t� �|�} | �|| || �} | j� | � |� | � � �} | j� | � | j� |� dS )zi Update the location and size of the bbox (`.patches.FancyBboxPatch`), and draw. r N)r= rd r� r$ r% r# r r& r� r� r� r� r� �draw) rT r- r� r� r; r< r9 r: r. r/ r� r r r � _draw_bbox� s zText._draw_bboxc C s* t | j| j| jd�}| jr&| j�|� d S )N)Zclip_boxZ clip_pathZclip_on)�dict�clipboxZ _clippathZ_cliponrd rh )rT Z clippropsr r r r� s �z Text._update_clip_propertiesc s t � �|� | �� d S r� )rq � set_clip_boxr� )rT r� rt r r r� s zText.set_clip_boxc s t � �||� | �� d S r� )rq � set_clip_pathr� )rT �pathr� rt r r r� s zText.set_clip_pathc s t � �|� | �� d S r� )rq � set_clip_onr� �rT r| rt r r r� s zText.set_clip_onc C s | j S )z'Return the wrapping state for the text.��_wraprS r r r r $ s z Text.get_wrapc C s || _ dS )zhSet the wrapping state for the text. Parameters ---------- wrap : bool Nr� )rT rl r r r r^ ( s z Text.set_wrapc C s� | � � �| �� �\}}| �� �� }| �� }| �d� | �� }| �||||�}| �d| d |||�}|dkrr|}n |dkr�|}ndt ||� }|S )zk Return the maximum line width for wrapping text based on the current orientation. r� � r rX r� r� ) r r� � get_position� get_figurerx �get_horizontalalignmentrg r# �_get_dist_to_boxr* ) rT �x0�y0� figure_boxZ alignmentr" rX r� � line_widthr r r �_get_wrap_line_width1 s$ �zText._get_wrap_line_widthc C s |dkrD|d }|t �t �|�� }|j| t �t �d| �� }n�|dkr�|d }|t �t �|�� }|t �t �d| �� }n||dkr�|d }|j| t �t �|�� }|t �t �d| �� }n8|j| t �t �|�� }|j| t �t �d| �� }t||�S )zr Return the distance from the given points to the boundaries of a rotated box, in pixels. i �Z r� )�math�cosZradians�x1�y1r* )rT r" r� r� r� ZquadZh1Zh2r r r r� K s zText._get_dist_to_boxc C s$ | j �|| �� d�\}}}t�|�S )zE Return the width of a given text string, in pixels. F)re r� �get_fontpropertiesr� Zceil)rT r, r7 r8 r2 r r r �_get_rendered_text_widthb s � z Text._get_rendered_text_widthc C s� | � � r| �� S | �� }d}d}| �� �d�D ]x}|�d�}tt|��D ]\}| �|d || �}||ksr|dkr�||d 7 }d}|dkr�|| }qH|d|| 7 }qHq.|| S )z� Return a copy of the text with new lines added, so that the text is wrapped relative to the parent figure. rV � r� r )r� r r� r� �range�lenr� )rT r� Z wrapped_strr� ZwordZ sub_wordsr� Z current_widthr r r r l s$ � zText._get_wrapped_textc C s |dk r|| _ | �� sdS | �� dkr*dS |�d| �� � t| ����}|�|�\}}}|�� }t|� |j ��}t|� |j ��}|� ||f�\}}t�|�r�t�|�s�t�d� W 5 Q R � dS |�� \} } |jr�|�|||� |�� } | �|�� � | �|�� � | �|j� |� | � |� � } |D ]�\} }}}t |�dk�r@|nd}|| }|| }|� � �rf| | }|� | �\}}|�!� �r�ddl"m#} ||�!� |�}n|}|�$� �r�|j%| ||||j&| |d� n |j'| ||||j&| ||d � �q"W 5 Q R X | �(� |�)d� d | _*dS ) zC Draws the `.Text` object to the given *renderer*. NrV r, z%posx and posy should be finite valuesr r )�PathEffectRenderer)�mtext)r� r� F)+re rw r Z open_groupZget_gidr r' r r r� rO r� rP r( r$ Zisfinite�_logZwarningZget_canvas_width_heightrd r� Znew_gcZset_foreground� get_colorZ set_alphaZ get_alphaZset_urlZ_urlZ _set_gc_clipr# r� Zflipyr� Zget_path_effectsZmatplotlib.patheffectsr� r� Zdraw_texrc Z draw_textZrestoreZ close_groupr� )rT r- r rn �infor� r� r� r� ZcanvaswZcanvash�gc�angler� r4 r5 r6 r� r� r� r� Z textrendererr r r r� � sl � � � z Text.drawc C s | j S )z Return the color of the text)r� rS r r r r� � s zText.get_colorc C s | j S )z0Return the `.font_manager.FontProperties` object)rc rS r r r r� � s zText.get_fontpropertiesc C s | j �� S )z� Return the list of font families used for font lookup See Also -------- .font_manager.FontProperties.get_family )rc Z get_familyrS r r r �get_fontfamily� s zText.get_fontfamilyc C s | j �� S )z� Return the font name as string See Also -------- .font_manager.FontProperties.get_name )rc Zget_namerS r r r � get_fontname� s zText.get_fontnamec C s | j �� S )z� Return the font style as string See Also -------- .font_manager.FontProperties.get_style )rc Z get_stylerS r r r � get_fontstyle� s zText.get_fontstylec C s | j �� S )z� Return the font size as integer See Also -------- .font_manager.FontProperties.get_size_in_points )rc Zget_size_in_pointsrS r r r � get_fontsize� s zText.get_fontsizec C s | j �� S )z� Return the font variant as a string See Also -------- .font_manager.FontProperties.get_variant )rc Z get_variantrS r r r �get_fontvariant s zText.get_fontvariantc C s | j �� S )z� Get the font weight as string or number See Also -------- .font_manager.FontProperties.get_weight )rc Z get_weightrS r r r �get_fontweight s zText.get_fontweightc C s | j �� S )z� Get the font stretch as a string or number See Also -------- .font_manager.FontProperties.get_stretch )rc � get_stretchrS r r r r� s zText.get_stretchc C s | j S )zq Return the horizontal alignment as string. Will be one of 'left', 'center' or 'right'. )r� rS r r r r� " s z Text.get_horizontalalignmentc C s( t | �| j��}t | �| j��}||fS �z>Return the unitless position of the text as a tuple (*x*, *y*))r r� rO r� rP r� r r r r~ ) s zText.get_unitless_positionc C s | j | jfS �z5Return the position of the text as a tuple (*x*, *y*))rO rP rS r r r r� 1 s zText.get_positionc C sR | � � \}}|p| j}||| �� | j| j| jt| j�| j| j | j j t � |�| jf S )�� Return a hashable tuple of properties. Not intended to be human readable, but useful for backends who want to cache derived information about text (e.g., layouts) and need to know if the text has changed. )r~ re r r� r� r� �hashrc rb r� �figure�dpi�weakref�refrf �rT r- r5 r6 r r r r� 7 s �zText.get_prop_tupc C s | j S )zGet the text as string)rR rS r r r r I s z Text.get_textc C s | j S )z{ Return the vertical alignment as string. Will be one of 'top', 'center', 'bottom' or 'baseline'. )r� rS r r r �get_verticalalignmentM s zText.get_verticalalignmentc C s� | � � st�� S |dk r(| jj}|| j_| �� dkrP| �� \}}t�||dd�S |dk r^|| _| jdkrr| jj | _| jdkr�t d��| � | j�\}}}| � � \} } | � � �| | f�\} } |�| | �}|dk r�|| j_|S )a� Return the `Bbox` bounding the text, in display units. In addition to being used internally, this is useful for specifying clickable regions in a png file on a web page. Parameters ---------- renderer : Renderer, optional A renderer is needed to compute the bounding box. If the artist has already been drawn, the renderer is cached; thus, it is only necessary to pass this argument when calling `get_window_extent` before the first `draw`. In practice, it is usually easier to trigger a draw first (e.g. by saving the figure). dpi : float, optional The dpi value for computing the bbox, defaults to ``self.figure.dpi`` (*not* the renderer dpi); should be set e.g. if to match regions with a figure saved with a custom dpi value. NrV r �%Cannot get window extent w/o renderer)rw r �unitr� r� r r� r� re �_cachedRenderer� RuntimeErrorr' r~ r r( Z translated) rT r- r� Zdpi_origZtxZtyrn r� r� r5 r6 r r r rx T s* zText.get_window_extentc C sB | j dkr | �t||d�� n| j �t|d�� | �� d| _dS )z� Set the background color of the text by updating the bbox. Parameters ---------- color : color See Also -------- .set_bbox : To change the position of the bounding box N)� facecolorZ edgecolor)r T)rd rr r� rh r� r� �rT rD r r r �set_backgroundcolor� s zText.set_backgroundcolorc C s: z t |� W n tk r( t|�}Y nX || _d| _dS )zs Set the foreground color of the text Parameters ---------- color : color TN)r� r �tupler� r� r r r r r\ � s zText.set_colorc C s$ t jdddg|d� || _d| _dS )z� Set the horizontal alignment to one of Parameters ---------- align : {'center', 'right', 'left'} r� r� rX ��alignTN)r �_check_in_listr� r� �rT r r r r r` � s z Text.set_horizontalalignmentc C s$ t jdddg|d� || _d| _dS )aS Set the alignment for multiple lines layout. The layout of the bounding box of all the lines is determined by the horizontalalignment and verticalalignment properties, but the multiline text within that box can be Parameters ---------- align : {'left', 'right', 'center'} r� r� rX r TN)r r ra r� r r r r �set_multialignment� s zText.set_multialignmentc C s || _ d| _dS )z� Set the line spacing as a multiple of the font size. Default is 1.2. Parameters ---------- spacing : float (multiple of font size) TN)rf r� )rT Zspacingr r r �set_linespacing� s zText.set_linespacingc C s | j �|� d| _dS )a� Set the font family. May be either a single string, or a list of strings in decreasing priority. Each string may be either a real font name or a generic font class name. If the latter, the specific font names will be looked up in the corresponding rcParams. If a `Text` instance is constructed with ``fontfamily=None``, then the font is set to :rc:`font.family`, and the same is done when `set_fontfamily()` is called on an existing `Text` instance. Parameters ---------- fontname : {FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'} See Also -------- .font_manager.FontProperties.set_family TN)rc � set_familyr� �rT rH r r r �set_fontfamily� s zText.set_fontfamilyc C s | j �|� d| _dS )z� Set the font variant, either 'normal' or 'small-caps'. Parameters ---------- variant : {'normal', 'small-caps'} See Also -------- .font_manager.FontProperties.set_variant TN)rc Z set_variantr� )rT rB r r r �set_fontvariant� s zText.set_fontvariantc C s | j �|� d| _dS )z� Set the font style. Parameters ---------- fontstyle : {'normal', 'italic', 'oblique'} See Also -------- .font_manager.FontProperties.set_style TN)rc Z set_styler� )rT rJ r r r � set_fontstyle� s zText.set_fontstylec C s | j �|� d| _dS )aw Set the font size. May be either a size string, relative to the default font size, or an absolute font size in points. Parameters ---------- fontsize : {size in points, 'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'} See Also -------- .font_manager.FontProperties.set_size TN)rc Zset_sizer� )rT rI r r r � set_fontsize s zText.set_fontsizec C s | j �|� d| _dS )ab Set the font weight. Parameters ---------- weight : {a numeric value in range 0-1000, 'ultralight', 'light', 'normal', 'regular', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'bold', 'heavy', 'extra bold', 'black'} See Also -------- .font_manager.FontProperties.set_weight TN)rc Z set_weightr� )rT rC r r r �set_fontweight s zText.set_fontweightc C s | j �|� d| _dS )a� Set the font stretch (horizontal condensation or expansion). Parameters ---------- stretch : {a numeric value in range 0-1000, 'ultra-condensed', 'extra-condensed', 'condensed', 'semi-condensed', 'normal', 'semi-expanded', 'expanded', 'extra-expanded', 'ultra-expanded'} See Also -------- .font_manager.FontProperties.set_stretch TN)rc Z set_stretchr� )rT rA r r r �set_fontstretch% s zText.set_fontstretchc C s | � |d � | �|d � dS )z} Set the (*x*, *y*) position of the text. Parameters ---------- xy : (float, float) r r N��set_x�set_y�rT �xyr r r � set_position6 s zText.set_positionc C s || _ d| _dS )zl Set the *x* position of the text. Parameters ---------- x : float TN)rO r� �rT r5 r r r r A s z Text.set_xc C s || _ d| _dS )zl Set the *y* position of the text. Parameters ---------- y : float TN)rP r� �rT r6 r r r r L s z Text.set_yc C s || _ d| _dS )z� Set the rotation of the text. Parameters ---------- s : {angle in degrees, 'vertical', 'horizontal'} TN)rb r� �rT �sr r r � set_rotationW s zText.set_rotationc C s( t jdddddg|d� || _d| _dS ) z� Set the vertical alignment Parameters ---------- align : {'center', 'top', 'bottom', 'baseline', 'center_baseline'} r� Zbottomr� rW r� r TN)r r r� r� r r r r r_ b s �zText.set_verticalalignmentc C s* |dkr d}|| j kr&t|�| _ d| _dS )a Set the text string *s*. It may contain newlines (``\n``) or math in LaTeX syntax. Parameters ---------- s : object Any object gets converted to its `str`, except ``None`` which becomes ``''``. NrV T)rR r[ r� r! r r r r p s z Text.set_text�3.1c C sN |dkrt d }|r(| dkr d} | dfS t�| �r:| dfS | �dd�d fS dS ) aS Returns a cleaned string and a boolean flag. The flag indicates if the given string *s* contains any mathtext, determined by counting unescaped dollar signs. If no mathtext is present, the cleaned string has its dollar signs unescaped. If usetex is on, the flag always has the value "TeX". N� text.usetexr� �\ r� T�\$�$F)r r � is_math_text�replace)r" rk r r r r) � s zText.is_math_textc C sB | � � r |dkrd}|dfS t�|�r.|dfS |�dd�dfS dS ) a� Return the string *s* after mathtext preprocessing, and the kind of mathtext support needed. - If *self* is configured to use TeX, return *s* unchanged except that a single space gets escaped, and the flag "TeX". - Otherwise, if *s* is mathtext (has an even number of unescaped dollar signs), return *s* and the flag True. - Otherwise, return *s* with dollar signs unescaped, and the flag False. r� r& r� Tr' r( FN)r� r r) r* r! r r r r� � s zText._preprocess_mathc C s& t |t�rt|�}|�� | _d| _dS )z� Set the font properties that control the text. Parameters ---------- fp : `.font_manager.FontProperties` TN)rZ r[ r r� rc r� )rT �fpr r r �set_fontproperties� s zText.set_fontpropertiesc C s( |dkrt d | _n t|�| _d| _dS )z� Parameters ---------- usetex : bool or None Whether to render using TeX, ``None`` means to use :rc:`text.usetex`. Nr% T)r �_usetex�boolr� )rT rk r r r r] � s zText.set_usetexc C s | j S )z9Return whether this `Text` object uses TeX for rendering.)r- rS r r r r� � s zText.get_usetexc C s | � |�S )a- Alias for `set_family`. One-way alias only: the getter differs. Parameters ---------- fontname : {FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'} See Also -------- .font_manager.FontProperties.set_family )r r r r r � set_fontname� s zText.set_fontname) r r rV NrW rX NNNNNNF)N)N)NN)N)O�__name__� __module__� __qualname__�__doc__Zzorderr �maxdictr� rU rY rh rv rz r� r� r# rg r� r� r' rr r� r� r� r� r� r� r� r r^ r� r� r� r r �allow_rasterizationr� r� r� r� r� r� r� r� r� r� r� r~ r� r� r r rx r r\ r` r r r r r r r r r r r r# r_ r � staticmethod� deprecatedr) r� r, r] r� r/ � __classcell__r r rt r rL b s� � 1 0 # D . rL )rL r$ � Annotation)Z alternativec @ s� e Zd ZdZdZ dd� Zd9d d �Zd d� Zdd� Zd:dd�Zdd� Z dd� Z d;dd�Z dd� Z dd � Z d d � Zd d � Zd!d"� Zd#d$� Zd%d&� Zd'd(� Zd)d*� Zd+d,� Zd-d.� Zd/d0� Zd1d2� Zd3d4� Zd5d6� Zd7d8� ZdS )<� TextWithDashab This is basically a :class:`~matplotlib.text.Text` with a dash (drawn with a :class:`~matplotlib.lines.Line2D`) before/after it. It is intended to be a drop-in replacement for :class:`~matplotlib.text.Text`, and should behave identically to it when *dashlength* = 0.0. The dash always comes between the point specified by :meth:`~matplotlib.text.Text.set_position` and the text. When a dash exists, the text alignment arguments (*horizontalalignment*, *verticalalignment*) are ignored. *dashlength* is the length of the dash in canvas units. (default = 0.0). *dashdirection* is one of 0 or 1, where 0 draws the dash after the text and 1 before. (default = 0). *dashrotation* specifies the rotation of the dash, and should generally stay *None*. In this case :meth:`~matplotlib.text.TextWithDash.get_dashrotation` returns :meth:`~matplotlib.text.Text.get_rotation`. (i.e., the dash takes its rotation from the text's rotation). Because the text center is projected onto the dash, major deviations in the rotation cause what may be considered visually unappealing results. (default = *None*) *dashpad* is a padding length to add (or subtract) space between the text and the dash, in canvas units. (default = 3) *dashpush* "pushes" the dash and text away from the point specified by :meth:`~matplotlib.text.Text.set_position` by the amount in canvas units. (default = 0) .. note:: The alignment of the two objects is based on the bounding box of the :class:`~matplotlib.text.Text`, as obtained by :meth:`~matplotlib.artist.Artist.get_window_extent`. This, in turn, appears to depend on the font metrics as given by the rendering backend. Hence the quality of the "centering" of the label text with respect to the dash varies depending on the backend used. .. note:: I'm not sure that I got the :meth:`~matplotlib.text.TextWithDash.get_window_extent` right, or whether that's sufficient for providing the object bounding box. Z textwithdashc C s d| j | j| jf S )NzTextWithDash(%g, %g, %r))rO rP rR rS r r r �__str__ s zTextWithDash.__str__r rV Nr� r rM c C sp t j| ||||||||| | d� t||f||fddd�| _t|�| _t|�| _| | _| | _| | _ || _ || _ d S )N) r5 r6 r, rD rK rF rG rE r" ri �k�-)ZxdataZydatarD Z linestyle) rL rY r �dashliner �_dashx�_dashy� _dashlength�_dashdirection� _dashrotation�_dashpad� _dashpush)rT r5 r6 r, rD rK rF rG rE r" ri � dashlength� dashdirection� dashrotation�dashpad�dashpushr r r rY ! s( � � zTextWithDash.__init__c C s( t | �| j��}t | �| j��}||fS r� )r r� r? r� r@ r� r r r r~ M s z"TextWithDash.get_unitless_positionc C s | j | jfS r� )r? r@ rS r r r r� U s zTextWithDash.get_positionc C sF dd� t j| |d�D �}|�| j| j| j| j| j| j| j g� t |�S )r� c S s g | ]}|�qS r r )r� �pr r r r� c s z-TextWithDash.get_prop_tup.<locals>.<listcomp>r� ) rL r� r) rO rP rA rB rC rD rE r )rT r- r� r r r r� [ s �zTextWithDash.get_prop_tupc C s8 | � |� t�| |� | �� dkr.| j�|� d| _dS )zP Draw the :class:`TextWithDash` object to the given *renderer*. r FN)� update_coordsrL r� �get_dashlengthr> r� �rT r- r r r r� i s zTextWithDash.drawc ! C s, | � � \}}| �� }|dkr.|| | _| _dS | �� }| �� }| �� }| �� }t|�} t j | d | d } t � | �t � | � } } | � � } | �||f�}t �| | g�}||| }||| | }| �� }|�t|��\}}|�t|��\}}| j�||f||f� tj| |d�}|j|j }}| dk�r4|}d}nJ| dk�rHd}|}n6| | } |}|| }||k�sr|| k �r~|}|| }t �||g�d } | d|t �t �| | �� 9 } ||d d | } |�t| ��\} } | | | _| _tj| |d�}|�� | _| j� t �|g�d� t� | d� t� | d� dS ) z� Computes the actual *x*, *y* coordinates for text based on the input *x*, *y* and the *dashlength*. Since the rotation is with respect to the actual canvas's coordinates we need to map back and forth. r Ng �f@r r� r� Fr� ) r~ rM rO rP �get_dashrotation�get_dashdirection� get_dashpad� get_dashpushr# r$ Zpir� Zsinr r( r� �invertedr r> �set_datarL rx r� r� Zsqrt�dot�frozen�_twd_window_extentZupdate_from_data_xyr` r_ )!rT r- ZdashxZdashyrF rH rG rI rJ r� r. Z cos_thetaZ sin_thetar� ZcxyZcdZc1Zc2Zinverser� r� �x2�y2Zwer7 r8 ZdxZdyZ tan_theta�cwdZcwZnewxZnewyr r r rL s sZ zTextWithDash.update_coordsc C s. | � |� | �� dkr$tj| |d�S | jS dS )ao Return a :class:`~matplotlib.transforms.Bbox` object bounding the text, in display units. In addition to being used internally, this is useful for specifying clickable regions in a png file on a web page. *renderer* defaults to the _renderer attribute of the text object. This is not assigned until the first execution of :meth:`draw`, so you must use this kwarg if you want to call :meth:`get_window_extent` prior to the first :meth:`draw`. For getting web page regions, it is simpler to call the method after saving the figure. r r� N)rL rM rL rx rW rN r r r rx � s z TextWithDash.get_window_extentc C s | j S )z- Get the length of the dash. )rA rS r r r rM � s zTextWithDash.get_dashlengthc C s || _ d| _dS )zx Set the length of the dash, in canvas units. Parameters ---------- dl : float TN)rA r� )rT Zdlr r r �set_dashlength� s zTextWithDash.set_dashlengthc C s | j S )zO Get the direction dash. 1 is before the text and 0 is after. )rB rS r r r rP � s z TextWithDash.get_dashdirectionc C s || _ d| _dS )a9 Set the direction of the dash following the text. 1 is before the text and 0 is after. The default is 0, which is what you'd want for the typical case of ticks below and on the left of the figure. Parameters ---------- dd : int (1 is before, 0 is after) TN)rB r� )rT Zddr r r �set_dashdirection� s z TextWithDash.set_dashdirectionc C s | j dkr| �� S | j S dS )z: Get the rotation of the dash in degrees. N)rC r# rS r r r rO s z TextWithDash.get_dashrotationc C s || _ d| _dS )zu Set the rotation of the dash, in degrees. Parameters ---------- dr : float TN)rC r� )rT Zdrr r r �set_dashrotation s z TextWithDash.set_dashrotationc C s | j S )zW Get the extra spacing between the dash and the text, in canvas units. )rD rS r r r rQ s zTextWithDash.get_dashpadc C s || _ d| _dS )z� Set the "pad" of the TextWithDash, which is the extra spacing between the dash and the text, in canvas units. Parameters ---------- dp : float TN)rD r� �rT Zdpr r r � set_dashpad s zTextWithDash.set_dashpadc C s | j S )zr Get the extra spacing between the dash and the specified text position, in canvas units. )rE rS r r r rR & s zTextWithDash.get_dashpushc C s || _ d| _dS )z� Set the "push" of the TextWithDash, which is the extra spacing between the beginning of the dash and the specified position. Parameters ---------- dp : float TN)rE r� r^ r r r � set_dashpush- s zTextWithDash.set_dashpushc C s | � |d � | �|d � dS )z� Set the (*x*, *y*) position of the :class:`TextWithDash`. Parameters ---------- xy : (float, float) r r Nr r r r r r 9 s zTextWithDash.set_positionc C s t |�| _d| _dS )z} Set the *x* position of the :class:`TextWithDash`. Parameters ---------- x : float TN)r r? r� r r r r r D s zTextWithDash.set_xc C s t |�| _d| _dS )z} Set the *y* position of the :class:`TextWithDash`. Parameters ---------- y : float TN)r r@ r� r r r r r O s zTextWithDash.set_yc C s" t �| |� | j�|� d| _dS )z� Set the :class:`matplotlib.transforms.Transform` instance used by this artist. Parameters ---------- t : `~matplotlib.transforms.Transform` TN)rL r� r> r� )rT r3 r r r r� Z s zTextWithDash.set_transformc C s | j S )z1Return the figure instance the artist belongs to.)r� rS r r r r� g s zTextWithDash.get_figurec C s t �| |� | j�|� dS )z� Set the figure instance the artist belongs to. Parameters ---------- fig : `~matplotlib.figure.Figure` N)rL � set_figurer> �rT Zfigr r r ra k s zTextWithDash.set_figure)r r rV Nr� r� NNNNr r NrM r )N)N) r0 r1 r2 r3 r; rY r~ r� r� r� rL rx rM r[ rP r\ rO r] rQ r_ rR r` r r r r� r� ra r r r r r: � sR 5 � , T r: )r: c @ s: e Zd ZdZddd�Zdd� Zdd� Zd d � Zd d � Zd S )� OffsetFromz3Callable helper class for working with `Annotation`�pointsc C s || _ || _| �|� dS )aY Parameters ---------- artist : `Artist`, `BboxBase`, or `Transform` The object to compute the offset from. ref_coord : length 2 sequence If `artist` is an `Artist` or `BboxBase`, this values is the location to of the offset origin in fractions of the `artist` bounding box. If `artist` is a transform, the offset origin is the transform applied to this value. unit : {'points, 'pixels'} The screen units to use (pixels or points) for the offset input. N)�_artist� _ref_coord�set_unit)rT r Z ref_coordr r r r rY { s zOffsetFrom.__init__c C s t jddg|d� || _dS )z� The unit for input to the transform used by ``__call__`` Parameters ---------- unit : {'points', 'pixels'} rd �pixels)r N)r r �_unit)rT r r r r rg � s zOffsetFrom.set_unitc C s | j S )z8The unit for input to the transform used by ``__call__``)ri rS r r r �get_unit� s zOffsetFrom.get_unitc C s" | � � }|dkrdS |�d�S d S )Nrh r� )rj r� )rT r- r r r r � _get_scale� s zOffsetFrom._get_scalec C s� t | jt�rL| j�|�}|j\}}}}| j\}}||| ||| } } njt | jt�r�| jj\}}}}| j\}}||| ||| } } n(t | jt�r�| j�| j�\} } nt d��| � |�} t � � | | �� | | �} | S )aX Return the offset transform. Parameters ---------- renderer : `RendererBase` The renderer to use to compute the offset Returns ------- transform : `Transform` Maps (x, y) in pixel or point units to screen units relative to the given artist. z unknown type)rZ re r rx ry rf r r r( r rk r �scaler� ) rT r- rn r{ r| r7 r8 ZxfZyfr5 r6 Zscr/ r r r �__call__� s zOffsetFrom.__call__N)rd ) r0 r1 r2 r3 rY rg rj rk rm r r r r rc y s rc c @ sX e Zd Zddd�Zdd� Zdd� Zd d � Zd d � Zd d� Zdd� Z dd� Z ddd�Z dS )�_AnnotationBase�dataNc C s || _ || _| �|� d | _d S r� )r �xycoords�set_annotation_clip� _draggable)rT r rp �annotation_clipr r r rY � s z_AnnotationBase.__init__c C sp t |t�r|\}}n || }}|dkr4t| �|��}|dkrJt| �|��}| �||�}|�||f�\}} || fS )Nro )rZ r r r� r� �_get_xy_transformr( ) rT r- r5 r6 r" �s1�s2r/ r� r� r r r �_get_xy� s z_AnnotationBase._get_xyc C st t |t�rD|\}}ddlm} | �||�}| �||�}|||�}|S t|�r~||�}t |t�rft|�S t |t�rt|S t d��nRt |t �r�|� |�} t| �S t |t�r�t|�S t |t�r�|S t |t �s�t d| ��|dkr�| j jS |dk�rddlm} | �� }|| j j } | S |�� } t| �dk�r0td | ��d \} }| \}}|d k�rT| jj} n|d k�rf| j j} | d k �r�| jd d� }n|d k�r�| �|�}|d k �rd|\}}ddlm} |dk�r�| j�� d }|� �||�}n~|dk�r�|� }nl|dk�r | � � }|| j�� d }|� �||�}n8|dk�rL| jdd � \}}|� �||�}n td | ��|� ||�S td | ��d S )Nr )�blended_transform_factoryzunknown return type ...z unknown coordinate type : %sro Zpolar)� PolarAxesr� z!%s is not a recognized coordinate)NNr� �axes�offset)r rd g R@rh rI Zfraction) rZ r Zmatplotlib.transformsrx rt �callabler r r r r rx r[ rz Z transDataZmatplotlib.projectionsry ZPolarTransformr� r� r r� rn ry � _get_ref_xyr Zget_dpirl r� r� )rT r- r" ru rv rx Ztr1Ztr2r/ rn ry r� Zs_Zbbox0Zxy0Z bbox_namer Zref_xZref_yr ZdpprI r7 r8 r r r rt � sz z!_AnnotationBase._get_xy_transformc C s� dd� }t | jt�rp| j\}}||�s.||�r6td��| j\}}| �||||�\}}| �||||�\} } || fS || j�r�td��n | j\}}| �|||| j�S dS )zy return x, y (in display coordinate) that is to be used for a reference of any offset coordinate c S s t | t�o| �� d dkS )Nr r{ )rZ r[ r� )r" r r r � is_offset? s z._AnnotationBase._get_ref_xy.<locals>.is_offsetz+xycoords should not be an offset coordinateN)rZ rp r r r rw ) rT r- r~ ru rv r5 r6 r� r� rX rY r r r r} : s z_AnnotationBase._get_ref_xyc C s || _ dS )aK set *annotation_clip* attribute. * True: the annotation will only be drawn when self.xy is inside the axes. * False: the annotation will always be drawn regardless of its position. * None: the self.xy will be checked only if *xycoords* is "data" N�Z_annotation_clipr� r r r rq [ s z#_AnnotationBase.set_annotation_clipc C s | j S )z Return *annotation_clip* attribute. See :meth:`set_annotation_clip` for the meaning of return values. r rS r r r �get_annotation_clipg s z#_AnnotationBase.get_annotation_clipc C s | j \}}| �|||| j�S )z1Return the pixel position of the annotated point.)r rw rp r r r r �_get_position_xyn s z _AnnotationBase._get_position_xyc C s2 | � � }|s |dkr.| jdkr.| j�|�s.dS dS )zb given the xy pixel coordinate, check if the annotation need to be drawn. Nro FT)r� rp rz Zcontains_point)rT r- �xy_pixelr| r r r � _check_xys s z_AnnotationBase._check_xyFc C s` ddl m} | jdk }|dkr$| }|r@| jdkrZ|| |�| _n| jdk rT| j�� d| _| jS )ac Set the draggable state -- if state is * None : toggle the current state * True : turn draggable on * False : turn draggable off If draggable is on, you can drag the annotation on the canvas with the mouse. The DraggableAnnotation helper instance is returned if draggable is on. r )�DraggableAnnotationN)Zmatplotlib.offsetboxr� rr Z disconnect)rT �stateZuse_blitr� Z is_draggabler r r � draggable� s z_AnnotationBase.draggable)ro N)NF) r0 r1 r2 rY rw rt r} rq r� r� r� r� r r r r rn � s � S! rn c @ s� e Zd ZdZdd� Ze�ddd�d&d d ��Zd d � Ze d d� �Z e j dd� �Z e dd� �Z e j dd� �Z e j Zde_e jZde_dd� Zdd� Zdd� Zejdd � �Zd'd d �Ze ejd d d!�d"d#� �e�d �d$d#� �d%�ZdS )(r9 a` An `.Annotation` is a `.Text` that can refer to a specific position *xy*. Optionally an arrow pointing from the text to *xy* can be drawn. Attributes ---------- xy The annotated position. xycoords The coordinate system for *xy*. arrow_patch A `.FancyArrowPatch` to point from *xytext* to *xy*. c C s d| j d | j d | jf S )NzAnnotation(%g, %g, %r)r r )r rR rS r r r r; � s zAnnotation.__str__r$ r" r, Nro c K s� t j| |||d� |dkr4|dk r4||kr4t�d� |dkrB| j}|| _|dkrV| j}|\} } tj| | | |f|� || _|dk r�d|kr�| j� � }|� dd�| _ n.d} t � }| j� � D ]\} } | | kr�| || < q�td |�| _nd| _dS ) a� Annotate the point *xy* with text *text*. In the simplest form, the text is placed at *xy*. Optionally, the text can be displayed in another position *xytext*. An arrow pointing from the text to the annotated point *xy* can then be added by defining *arrowprops*. Parameters ---------- text : str The text of the annotation. *s* is a deprecated synonym for this parameter. xy : (float, float) The point *(x,y)* to annotate. xytext : (float, float), optional The position *(x,y)* to place the text at. If *None*, defaults to *xy*. xycoords : str, `.Artist`, `.Transform`, callable or tuple, optional The coordinate system that *xy* is given in. The following types of values are supported: - One of the following strings: ================= ============================================= Value Description ================= ============================================= 'figure points' Points from the lower left of the figure 'figure pixels' Pixels from the lower left of the figure 'figure fraction' Fraction of figure from lower left 'axes points' Points from lower left corner of axes 'axes pixels' Pixels from lower left corner of axes 'axes fraction' Fraction of axes from lower left 'data' Use the coordinate system of the object being annotated (default) 'polar' *(theta,r)* if not native 'data' coordinates ================= ============================================= - An `.Artist`: *xy* is interpreted as a fraction of the artists `~matplotlib.transforms.Bbox`. E.g. *(0, 0)* would be the lower left corner of the bounding box and *(0.5, 1)* would be the center top of the bounding box. - A `.Transform` to transform *xy* to screen coordinates. - A function with one of the following signatures:: def transform(renderer) -> Bbox def transform(renderer) -> Transform where *renderer* is a `.RendererBase` subclass. The result of the function is interpreted like the `.Artist` and `.Transform` cases above. - A tuple *(xcoords, ycoords)* specifying separate coordinate systems for *x* and *y*. *xcoords* and *ycoords* must each be of one of the above described types. See :ref:`plotting-guide-annotation` for more details. Defaults to 'data'. textcoords : str, `.Artist`, `.Transform`, callable or tuple, optional The coordinate system that *xytext* is given in. All *xycoords* values are valid as well as the following strings: ================= ========================================= Value Description ================= ========================================= 'offset points' Offset (in points) from the *xy* value 'offset pixels' Offset (in pixels) from the *xy* value ================= ========================================= Defaults to the value of *xycoords*, i.e. use the same coordinate system for annotation point and text position. arrowprops : dict, optional The properties used to draw a `~matplotlib.patches.FancyArrowPatch` arrow between the positions *xy* and *xytext*. If *arrowprops* does not contain the key 'arrowstyle' the allowed keys are: ========== ====================================================== Key Description ========== ====================================================== width The width of the arrow in points headwidth The width of the base of the arrow head in points headlength The length of the arrow head in points shrink Fraction of total length to shrink from both ends ? Any key to :class:`matplotlib.patches.FancyArrowPatch` ========== ====================================================== If *arrowprops* contains the key 'arrowstyle' the above keys are forbidden. The allowed values of ``'arrowstyle'`` are: ============ ============================================= Name Attrs ============ ============================================= ``'-'`` None ``'->'`` head_length=0.4,head_width=0.2 ``'-['`` widthB=1.0,lengthB=0.2,angleB=None ``'|-|'`` widthA=1.0,widthB=1.0 ``'-|>'`` head_length=0.4,head_width=0.2 ``'<-'`` head_length=0.4,head_width=0.2 ``'<->'`` head_length=0.4,head_width=0.2 ``'<|-'`` head_length=0.4,head_width=0.2 ``'<|-|>'`` head_length=0.4,head_width=0.2 ``'fancy'`` head_length=0.4,head_width=0.4,tail_width=0.4 ``'simple'`` head_length=0.5,head_width=0.5,tail_width=0.2 ``'wedge'`` tail_width=0.3,shrink_factor=0.5 ============ ============================================= Valid keys for `~matplotlib.patches.FancyArrowPatch` are: =============== ================================================== Key Description =============== ================================================== arrowstyle the arrow style connectionstyle the connection style relpos default is (0.5, 0.5) patchA default is bounding box of the text patchB default is None shrinkA default is 2 points shrinkB default is 2 points mutation_scale default is text size (in points) mutation_aspect default is 1. ? any key for :class:`matplotlib.patches.PathPatch` =============== ================================================== Defaults to None, i.e. no arrow is drawn. annotation_clip : bool or None, optional Whether to draw the annotation when the annotation point *xy* is outside the axes area. - If *True*, the annotation will only be drawn when *xy* is within the axes. - If *False*, the annotation will always be drawn. - If *None*, the annotation will only be drawn when *xy* is within the axes and *xycoords* is 'data'. Defaults to *None*. **kwargs Additional kwargs are passed to `~matplotlib.text.Text`. Returns ------- annotation : `.Annotation` See Also -------- :ref:`plotting-guide-annotation`. )rp rs NzgYou have used the `textcoords` kwarg, but not the `xytext` kwarg. This can lead to surprising results.� arrowstyle�relpos)� �?r� )r� � headwidth� headlength�shrink�frac�r r �r r )r� r� )rn rY r �_warn_externalrp � _textcoordsr rL � arrowpropsr� rp � _arrow_relposr� �itemsr � arrow_patch)rT r, r �xytextrp Z textcoordsr� rs rm r5 r6 Z shapekeysr� �valr r r rY � sB /��� �zAnnotation.__init__c C s: t �| |�\}}| jd k r2| j�|�\}}|p0|}||fS r� )rL rz r� )rT Zeventrz ZtinfoZin_patchr0 r r r rz � s zAnnotation.containsc C s | � � S )zU The the text position. See also *xytext* in `.Annotation`. )r� rS r r r �xyann� s zAnnotation.xyannc C s | � |� d S r� )r )rT r� r r r r� � s c C s | j S )z5The coordinate system to use for `.Annotation.xyann`.�r� rS r r r � anncoords� s zAnnotation.anncoordsc C s || _ d S r� r� )rT Zcoordsr r r r� � s zq Return the coordinate system to use for `.Annotation.xyann`. See also *xycoords* in `.Annotation`. zn Set the coordinate system to use for `.Annotation.xyann`. See also *xycoords* in `.Annotation`. c C s& | j d k r| j �|� t�| |� d S r� )r� ra r rb r r r ra � s zAnnotation.set_figurec C s | � |�}| �||� dS )z?Update the pixel positions of the annotated point and the text.N)r� �_update_position_xytext�rT r- r� r r r �update_positions� s zAnnotation.update_positionsc " s� | � | �|| j�� | �� \}}|\}}| jdk �r�|\� �t�| |�j\}}} } || } || } d|| } d|| }| j�� }|� d| � � �}| j � |� d|k�r�|� dd�}|� dd�}|� d d �}|� d d�}|dk r�t �d � |� d d �}t|| || || d�}| j jd|� |df| df| dff}|df|df| dff}t� fdd�|D ��\}\}}t�fdd�|D ��\}\} } || f| _t�| � |� �} || |�d� } | | j _| | j _| j} t�| |�} | j| j| d }| j| j| d }| j � ||f||f� d|k�r6| j � |� d�� n�| j �rN| j � | j � n�|�d�}!| � � dk�rv| j � d� dS t�| |�} | j\}}} } ||!d 8 }||!d 8 }| |!7 } | |!7 } t ||f| | d�} | � t!� � | �"d� | j � | � dS )zX Update the pixel positions of the annotation text and the arrow patch. Nr� Zmutation_scaler� r� r r� r� r� � r� zh'frac' option in 'arrowprops' is no longer supported; use 'headlength' to set the head length in points.r� )Z head_lengthZ head_widthZ tail_width�simpler r c 3 s" | ]}t |d � �|fV qdS �r N��abs�r� r� )r� r r � <genexpr>� s z5Annotation._update_position_xytext.<locals>.<genexpr>c 3 s" | ]}t |d � �|fV qdS r� r� r� )r� r r r� � s ZpatchArV r� )r r� r� F)r� )#r� rt r� r� r� rL rx ry r� rp r� r� r� r r� r� Zset_arrowstyler* r� r$ Zhypotr� ZshrinkAZshrinkBr� r� r� r� Z set_positionsZ set_patchArd r r r r� )"rT r- r� Zox0Zoy0Zox1Zoy1r{ r| r7 r8 r} r3 ZxcZycr2 Zmsr� r� r� r� r� ZstylekwZxposZyposr0 r5 Zrelposxr6 ZrelposyZ shrink_ptsr� rn r� r )r� r� r r� � s~ � � � z"Annotation._update_position_xytextc C s� |dk r|| _ | �� sdS | �|�}| �||�s4dS | �||� | �|� | jdk r�| jjdkrt| jdk rt| j| j_| j�|� t �| |� dS )zN Draw the :class:`Annotation` object to the given *renderer*. N) re rw r� r� r� r� r� r� r� rL r� r r r r� ( s zAnnotation.drawc C s� | � � st�� S |dk r || _| jdkr2| jj| _| jdkrDtd��| �| j� t� | �}|g}| j dk rz|� | j � � � t� |�S )a Return the `Bbox` bounding the text and arrow, in display units. Parameters ---------- renderer : Renderer, optional A renderer is needed to compute the bounding box. If the artist has already been drawn, the renderer is cached; thus, it is only necessary to pass this argument when calling `get_window_extent` before the first `draw`. In practice, it is usually easier to trigger a draw first (e.g. by saving the figure). Nr ) rw r r re r� r r r� rL rx r� r� �union)rT r- Z text_bboxZbboxesr r r rx C s z Annotation.get_window_extentz3.0z[arrow was deprecated in Matplotlib 3.0 and will be removed in 3.2. Use arrow_patch instead.)�messagec C s d S r� r rS r r r �<lambda>h � zAnnotation.<lambda>c C s d S r� r )rT �valuer r r r� i r� )�fget�fset)Nro NNN)N)r0 r1 r2 r3 r; r Z_rename_parameterrY rz �propertyr� �setterr� r� Z get_anncoordsr� Z set_anncoordsra r� r� r r5 r� rx r7 Zarrowr r r r r9 � sF � Y e " ��)r9 )2r3 � contextlibZloggingr� r� Znumpyr$ rV r r r r r Z font_managerr r� r Zpatchesr r r Ztextpathr Z transformsr r r r r r Z getLoggerr0 r� �contextmanagerr r# r= Z_define_aliasesrL Zinterpdrh ZkwdocZdedent_interpdrY r7 r: ro rc rn r9 r r r r �<module> sp &� y S W M