B
    Mô`%,  ã               @   sˆ   d Z ddlZddlmZ ddlmZ ddlmZ ddlm	Z
 e e¡ZG dd„ dƒZG dd	„ d	eƒZG d
d„ deƒZG dd„ deƒZdS )aä  
Classes used for blocking interaction with figure windows:

`BlockingInput`
    Creates a callable object to retrieve events in a blocking way for
    interactive sessions.  Base class of the other classes listed here.

`BlockingKeyMouseInput`
    Creates a callable object to retrieve key or mouse clicks in a blocking
    way for interactive sessions.  Used by `~.Figure.waitforbuttonpress`.

`BlockingMouseInput`
    Creates a callable object to retrieve mouse clicks in a blocking way for
    interactive sessions.  Used by `~.Figure.ginput`.

`BlockingContourLabeler`
    Creates a callable object to retrieve mouse clicks in a blocking way that
    will then be used to place labels on a `.ContourSet`.  Used by
    `~.Axes.clabel`.
é    N)ÚIntegral)Úcbook)ÚMouseButtonc               @   sR   e Zd ZdZddd„Zdd„ Zdd„ Zd	d
„ Zdd„ Zddd„Z	e	Z
ddd„ZdS )ÚBlockingInputz1Callable for retrieving events in a blocking way.© c             C   s   || _ || _d S )N)ÚfigÚ
eventslist)Úselfr   r   r   r   ú=/tmp/pip-unpacked-wheel-0c1wfn4v/matplotlib/blocking_input.pyÚ__init__#   s    zBlockingInput.__init__c             C   sT   |   |¡ t dt| jƒ¡ |  ¡  t| jƒ| j  kr@dkrPn n| jj 	¡  dS )zY
        Event handler; will be passed to the current figure to retrieve events.
        zEvent %ir   N)
Ú	add_eventÚ_logÚinfoÚlenÚeventsÚ
post_eventÚnr   ÚcanvasÚstop_event_loop)r	   Úeventr   r   r
   Úon_event'   s
    
 zBlockingInput.on_eventc             C   s   dS )z-For baseclass, do nothing but collect events.Nr   )r	   r   r   r
   r   7   s    zBlockingInput.post_eventc             C   s(   x| j D ]}| jj |¡ qW g | _ dS )zDisconnect all callbacks.N)Ú	callbacksr   r   Zmpl_disconnect)r	   Úcbr   r   r
   Úcleanup:   s    zBlockingInput.cleanupc             C   s   | j  |¡ dS )z5For base class, this just appends an event to events.N)r   Úappend)r	   r   r   r   r
   r   @   s    zBlockingInput.add_eventéÿÿÿÿc             C   s   | j  |¡ dS )zè
        Remove an event from the event list -- by default, the last.

        Note that this does not check that there are events, much like the
        normal pop method.  If no events exist, this will throw an exception.
        N)r   Úpop)r	   Úindexr   r   r
   Ú	pop_eventD   s    zBlockingInput.pop_eventé   é   c                sn   t jt|d� |ˆ _g ˆ _tˆ jjdƒr2ˆ j ¡  ‡ fdd„ˆ j	D ƒˆ _
zˆ jjj|d� W dˆ  ¡  X ˆ jS )z%Blocking call to retrieve *n* events.)r   Úmanagerc                s   g | ]}ˆ j j |ˆ j¡‘qS r   )r   r   Zmpl_connectr   )Ú.0Úname)r	   r   r
   ú
<listcomp>Y   s   z*BlockingInput.__call__.<locals>.<listcomp>)ÚtimeoutN)r   Z_check_isinstancer   r   r   Úhasattrr   r   Úshowr   r   Zstart_event_loopr   )r	   r   r%   r   )r	   r
   Ú__call__O   s    


zBlockingInput.__call__N)r   )r   )r   r    )Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   r   r   r   r   r   r   r(   r   r   r   r
   r       s   

	r   c               @   s˜   e Zd ZdZejZejZej	Z
ejejej	fdd„Zdd„ Zdd„ Zdd	„ Zd
d„ Zdd„ Zdd„ Zdd„ Zddd„Zd dd„Zd!dd„Zd"dd„ZdS )#ÚBlockingMouseInputa  
    Callable for retrieving mouse clicks in a blocking way.

    This class will also retrieve keypresses and map them to mouse clicks:
    delete and backspace are a right click, enter is like a middle click,
    and all others are like a left click.
    c             C   s&   t j| |dd� || _|| _|| _d S )N)Úbutton_press_eventÚkey_press_event)r   r   )r   r   Ú
button_addÚ
button_popÚbutton_stop)r	   r   Z	mouse_addZ	mouse_popZ
mouse_stopr   r   r
   r   r   s
    zBlockingMouseInput.__init__c             C   s@   t | jƒdkrt d¡ n"| jd jdkr4|  ¡  n|  ¡  dS )zProcess an event.r   zNo events yetr   r/   N)r   r   r   Úwarningr#   Ú	key_eventÚmouse_event)r	   r   r   r
   r   }   s
    
zBlockingMouseInput.post_eventc             C   sT   | j d }|j}|| jkr&|  |¡ n*|| jkr<|  |¡ n|| jkrP|  |¡ dS )zProcess a mouse click event.r   N)r   Úbuttonr1   Úmouse_event_popr2   Úmouse_event_stopr0   Úmouse_event_add)r	   r   r6   r   r   r
   r5   †   s    



zBlockingMouseInput.mouse_eventc             C   sX   | j d }|jdkrdS |j ¡ }|dkr6|  |¡ n|dkrJ|  |¡ n
|  |¡ dS )zV
        Process a key press event, mapping keys to appropriate mouse clicks.
        r   N)Z	backspaceÚdelete)ÚescapeZenter)r   ÚkeyÚlowerr7   r8   r9   )r	   r   r<   r   r   r
   r4   ‘   s    


zBlockingMouseInput.key_eventc             C   s    |j r|  |¡ n
t | ¡ dS )z�
        Process an button-1 event (add a click if inside axes).

        Parameters
        ----------
        event : `~.backend_bases.MouseEvent`
        N)ÚinaxesÚ	add_clickr   r   )r	   r   r   r   r
   r9   ¡   s    z"BlockingMouseInput.mouse_event_addc             C   s   t  | ¡ | jj ¡  dS )z•
        Process an button-2 event (end blocking input).

        Parameters
        ----------
        event : `~.backend_bases.MouseEvent`
        N)r   r   r   r   r   )r	   r   r   r   r
   r8   ®   s    	
z#BlockingMouseInput.mouse_event_stopc             C   s   t  | ¡ | jr|  |¡ dS )z˜
        Process an button-3 event (remove the last click).

        Parameters
        ----------
        event : `~.backend_bases.MouseEvent`
        N)r   r   r   )r	   r   r   r   r
   r7   ½   s    	
z"BlockingMouseInput.mouse_event_popc             C   sv   | j  |j|jf¡ t dt| j ƒ|j|j¡ | jrrtj	|jg|jgddd�}|j
 |¡ | j |¡ | jj ¡  dS )zœ
        Add the coordinates of an event to the list of clicks.

        Parameters
        ----------
        event : `~.backend_bases.MouseEvent`
        zinput %i: %f, %fú+Úr)ÚmarkerÚcolorN)Úclicksr   ZxdataZydatar   r   r   Úshow_clicksÚmlinesZLine2Dr>   Zadd_lineÚmarksr   r   Údraw)r	   r   Úliner   r   r
   r?   Ë   s    
zBlockingMouseInput.add_clickr   c             C   s2   | j  |¡ | jr.| j |¡ ¡  | jj ¡  dS )z¤
        Remove a click (by default, the last) from the list of clicks.

        Parameters
        ----------
        event : `~.backend_bases.MouseEvent`
        N)rD   r   rE   rG   Úremover   r   rH   )r	   r   r   r   r   r
   Ú	pop_clickÞ   s    zBlockingMouseInput.pop_clickc             C   s   |   ||¡ t | |¡ dS )zw
        Remove a click and the associated event from the list of clicks.

        Defaults to the last click.
        N)rK   r   r   )r	   r   r   r   r   r
   r   ë   s    zBlockingMouseInput.popNc             C   s>   | j r0x| jD ]}| ¡  qW g | _| jj ¡  t | ¡ dS )z{
        Parameters
        ----------
        event : `~.backend_bases.MouseEvent`, optional
            Not used
        N)rE   rG   rJ   r   r   rH   r   r   )r	   r   Úmarkr   r   r
   r   ô   s    zBlockingMouseInput.cleanupr   r    Tc             C   s(   || _ g | _g | _tj| ||d� | jS )zV
        Blocking call to retrieve *n* coordinate pairs through mouse clicks.
        )r   r%   )rE   rD   rG   r   r(   )r	   r   r%   rE   r   r   r
   r(     s
    zBlockingMouseInput.__call__)r   )r   )N)r   r    T)r)   r*   r+   r,   r   ÚLEFTr0   ÚRIGHTr1   ZMIDDLEr2   r   r   r5   r4   r9   r8   r7   r?   rK   r   r   r(   r   r   r   r
   r-   e   s$   	

	
r-   c               @   sD   e Zd ZdZdd„ Zdd„ Zddd„Zd	d
„ Zdd„ Zddd„Z	dS )ÚBlockingContourLabelerzt
    Callable for retrieving mouse clicks and key presses in a blocking way.

    Used to place contour labels.
    c             C   s   || _ tj| |jjd� d S )N)r   )Úcsr-   r   ÚaxÚfigure)r	   rP   r   r   r
   r     s    zBlockingContourLabeler.__init__c             C   s   |   |¡ d S )N)Úbutton1)r	   r   r   r   r
   r?     s    z BlockingContourLabeler.add_clickr   c             C   s   |   |¡ d S )N)Úbutton3)r	   r   r   r   r   r
   rK     s    z BlockingContourLabeler.pop_clickc             C   sH   |j | jjkr:| jj|j|j| j| jdd� | jj	 
¡  n
t | ¡ dS )z›
        Process an button-1 event (add a label to a contour).

        Parameters
        ----------
        event : `~.backend_bases.MouseEvent`
        F)Úinline_spacingZ	transformN)r>   rP   rQ   Zadd_label_nearÚxÚyÚinlinerU   r   r   rH   r   r   )r	   r   r   r   r
   rS      s    	zBlockingContourLabeler.button1c             C   s&   | j rn| j ¡  | jjjj ¡  dS )aŠ  
        Process an button-3 event (remove a label if not in inline mode).

        Unfortunately, if one is doing inline labels, then there is currently
        no way to fix the broken contour - once humpty-dumpty is broken, he
        can't be put back together.  In inline mode, this does nothing.

        Parameters
        ----------
        event : `~.backend_bases.MouseEvent`
        N)rX   rP   Z	pop_labelrQ   rR   r   rH   )r	   r   r   r   r
   rT   1  s    
zBlockingContourLabeler.button3é   c             C   s"   || _ || _tj| ||dd� d S )NF)r   r%   rE   )rX   rU   r-   r(   )r	   rX   rU   r   r%   r   r   r
   r(   C  s    
zBlockingContourLabeler.__call__N)r   )rY   r   r   )
r)   r*   r+   r,   r   r?   rK   rS   rT   r(   r   r   r   r
   rO     s   
rO   c               @   s*   e Zd ZdZdd„ Zdd„ Zd
dd„Zd	S )ÚBlockingKeyMouseInputzQ
    Callable for retrieving mouse clicks and key presses in a blocking way.
    c             C   s   t j| |dd� d S )N)r.   r/   )r   r   )r   r   )r	   r   r   r   r
   r   O  s    zBlockingKeyMouseInput.__init__c             C   s(   | j r| j d jdk| _n
t d¡ dS )zDetermine if it is a key event.r   r/   zNo events yet.N)r   r#   Ú
keyormouser   r3   )r	   r   r   r
   r   S  s    z BlockingKeyMouseInput.post_eventr    c             C   s   d| _ tj| d|d� | j S )z²
        Blocking call to retrieve a single mouse click or key press.

        Returns ``True`` if key press, ``False`` if mouse click, or ``None`` if
        timed out.
        Nr   )r   r%   )r[   r   r(   )r	   r%   r   r   r
   r(   Z  s    zBlockingKeyMouseInput.__call__N)r    )r)   r*   r+   r,   r   r   r(   r   r   r   r
   rZ   J  s   rZ   )r,   ÚloggingZnumbersr   Z
matplotlibr   Zmatplotlib.backend_basesr   Zmatplotlib.linesÚlinesrF   Ú	getLoggerr)   r   r   r-   rO   rZ   r   r   r   r
   Ú<module>   s   
E +;