G8c+dZddlZddlmZddlmZddlmZddlm Z ejde deje ZGd d ZGd d eZGd deZGddeZy)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)_api) MouseButtonz3.5module)nameobj_typecDeZdZdZd dZdZdZdZdZd dZ e Z d dZ y ) BlockingInputz1Callable for retrieving events in a blocking way.c ||_||_yNfig eventslist)selfrrs ;/usr/lib/python3/dist-packages/matplotlib/blocking_input.py__init__zBlockingInput.__init__$s$c8|j|tjdt|j|j t|j|j cxk\rdkDr(ny|jjjyy)zY Event handler; will be passed to the current figure to retrieve events. zEvent %irN) add_event_loginfolenevents post_eventnrcanvasstop_event_looprevents ron_eventzBlockingInput.on_event(sh u *c$++./  t{{ tvv ) ) HHOO + + - *rcy)z-For baseclass, do nothing but collect events.Nrs rrzBlockingInput.post_event8src~|jD]'}|jjj|)g|_y)zDisconnect all callbacks.N) callbacksrrmpl_disconnect)rcbs rcleanupzBlockingInput.cleanup;s2.. /B HHOO * *2 . /rc:|jj|y)z5For base class, this just appends an event to events.N)rappendrs rrzBlockingInput.add_eventAs 5!rc:|jj|y)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)rpop)rindexs r pop_eventzBlockingInput.pop_eventEs rctjt|||_g|_|j j jr|j j|jDcgc]2}|j j j||j4c}|_ |j j j||j|jScc}w#|jwxYw)z%Blocking call to retrieve *n* events.)r)timeout)rcheck_isinstancerrrrrmanagershowr mpl_connectr r%start_event_loopr()rrr0rs r__call__zBlockingInput.__call__Ps h!, 88?? " " HHMMO'+oo7"((//55dDMMJ7  HHOO , ,W , = LLN{{7 LLNs27C42&C99D N)r")) __name__ __module__ __qualname____doc__rr rr(rr.r,r6r"rrr r !s/;%. < " Crr ceZdZdZej ZejZejZ ej ejejffd Z dZ dZ dZdZdZdZd Zdd Zdfd Zdfd Zdfd ZxZS)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. cRt||d||_||_||_yN)button_press_eventkey_press_eventr )superr button_add button_pop button_stop)rr mouse_add mouse_pop mouse_stop __class__s rrzBlockingMouseInput.__init__ss3 S$M  O##%rct|jdk(rtjdy|jdjdk(r|j y|j y)zProcess an event.rz No events yetr8rDN)rrrwarningr key_event mouse_eventr#s rrzBlockingMouseInput.post_event}sL t{{ q LL ) [[_ ! !%6 6 NN     rc|jd}|j}||jk(r|j|y||jk(r|j |y||j k(r|j|yy)zProcess a mouse click event.r8N)rbuttonrGmouse_event_poprHmouse_event_stoprFmouse_event_add)rrrRs rrPzBlockingMouseInput.mouse_eventsm B T__ $   ' t'' '  ! !% ( t &   ''rc|jd}|jy|jdvr|j|y|jdvr|j|y|j |y)zV Process a key press event, mapping keys to appropriate mouse clicks. r8N) backspacedelete)escapeenter)rkeyrSrTrUrs rrOzBlockingMouseInput.key_eventsb B 99   99/ /   ' YY- -  ! !% (   'rcj|jr|j|ytj|y)z Process an button-1 event (add a click if inside axes). Parameters ---------- event : `~.backend_bases.MouseEvent` N)inaxes add_clickr r,rs rrUz"BlockingMouseInput.mouse_event_adds% << NN5 !   d #rcvtj||jjj y)z Process an button-2 event (end blocking input). Parameters ---------- event : `~.backend_bases.MouseEvent` N)r r,rrrrs rrTz#BlockingMouseInput.mouse_event_stops( $ '')rcjtj||jr|j|yy)z Process an button-3 event (remove the last click). Parameters ---------- event : `~.backend_bases.MouseEvent` N)r r,rrs rrSz"BlockingMouseInput.mouse_event_pops) $ ;; HHUO rc|jj|j|jftj dt |j|j|j|jrtj|jg|jgdd}|jj||jj||jjjyy)z Add the coordinates of an event to the list of clicks. Parameters ---------- event : `~.backend_bases.MouseEvent` zinput %i: %f, %f+r)markercolorN)clicksr*xdataydatarrr show_clicksmlinesLine2Dr]add_linemarksrrdraw)rrlines rr^zBlockingMouseInput.add_clicks EKK56 $dkk"EKK >   ==%++ (+38D LL ! !$ ' JJ  d # HHOO " rc|jj||jrN|jj|j |j j jyy)z Remove a click (by default, the last) from the list of clicks. Parameters ---------- event : `~.backend_bases.MouseEvent` N)rfr,rirmremoverrrnrrr-s r pop_clickzBlockingMouseInput.pop_clicksO     JJNN5 ! ( ( * HHOO " rcH|j||t| |y)zw Remove a click and the associated event from the list of clicks. Defaults to the last click. N)rsrEr,)rrr-rLs rr,zBlockingMouseInput.pops ue$  Erc|jrL|jD]}|jg|_|jjj t |y)z{ Parameters ---------- event : `~.backend_bases.MouseEvent`, optional Not used N)rirmrqrrrnrEr()rrmarkrLs rr(zBlockingMouseInput.cleanupsO       DJ HHOO " rch||_g|_g|_t||||jS)zV Blocking call to retrieve *n* coordinate pairs through mouse clicks. rr0)rirfrmrEr6)rrr0rirLs rr6zBlockingMouseInput.__call__s7'   1g.{{rr7r )r9r:T)r;r<r=r>rLEFTrFRIGHTrGMIDDLErHrrrPrOrUrTrSr^rsr,r(r6 __classcell__rLs@rr@r@fs!!J""J$$K'++&,,'..& ( ( $ * #& # rr@cHeZdZdZfdZdZddZdZdZd fd Z xZ S) BlockingContourLabelerzt Callable for retrieving mouse clicks and key presses in a blocking way. Used to place contour labels. c\||_t| |jjy)N)r)csrEraxesfigure)rrrLs rrzBlockingContourLabeler.__init__s" RWW^^,rc&|j|yr )button1rs rr^z BlockingContourLabeler.add_click Urc&|j|yr )button3rrs rrsz BlockingContourLabeler.pop_clickrrcN|j|jjk(rm|jj|j|j |j |jd|jjjytj|y)z Process an button-1 event (add a label to a contour). Parameters ---------- event : `~.backend_bases.MouseEvent` F)inline_spacing transformN) r]raxadd_label_nearxyinlinerrrrnr r,rs rrzBlockingContourLabeler.button1sq <<477:: % GG " "577EGGT[[262E2E-2 # 4 HHOO "   d #rc|jry|jj|jjjj j y)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)rr pop_labelrrrrnrs rrzBlockingContourLabeler.button30s> ;;  GG    GGJJ   $ $ ) ) +rcF||_||_t| ||dy)NF)rr0ri)rrrEr6)rrrrr0rLs rr6zBlockingContourLabeler.__call__Bs& , 1g5Arr7)r8r8) r;r<r=r>rr^rsrrr6r|r}s@rrrs- -$",$BBrrc4eZdZdZfdZdZdfd ZxZS)BlockingKeyMouseInputzQ Callable for retrieving mouse clicks and key presses in a blocking way. c(t||dyrB)rEr)rrrLs rrzBlockingKeyMouseInput.__init__Ms S$M  Orc|jr"|jdjdk(|_ytj dy)zDetermine if it is a key event.r8rDzNo events yet.N)rr keyormouserrNr#s rrz BlockingKeyMouseInput.post_eventQs1 ;;"kk"o226GGDO LL) *rcLd|_t| d||jS)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. Nr9rx)rrEr6)rr0rLs rr6zBlockingKeyMouseInput.__call__Xs( 1g.r)r:)r;r<r=r>rrr6r|r}s@rrrHsO+  rr)r>loggingnumbersr matplotlibrmatplotlib.backend_basesrmatplotlib.lineslinesrjwarn_deprecatedr; getLoggerrr r@rrr"rrrsy*0!UH=w"BBJeeP7B/7BtMr