G8cv1nddlmZmZmZmZGddZGddeZGddZGdd Zy ) )_api backend_toolscbookwidgetsceZdZdZddZy) ToolEventz)Event for tool manipulation (add/remove).Nc<||_||_||_||_yN)namesendertooldata)selfr r r rs =/usr/lib/python3/dist-packages/matplotlib/backend_managers.py__init__zToolEvent.__init__s    r __name__ __module__ __qualname____doc__rrrrrs 3rrc$eZdZdZdfd ZxZS)ToolTriggerEventz/Event to inform that a tool has been triggered.c8t|||||||_yr )superr canvasevent)rr r r rr __class__s rrzToolTriggerEvent.__init__s vtT2&r)NN)rrrrr __classcell__)rs@rrr s9''rrceZdZdZdZy)ToolManagerMessageEventzs Event carrying messages from toolmanager. Messages usually get displayed to the user by the toolbar. c.||_||_||_yr )r r message)rr r r#s rrz ToolManagerMessageEvent.__init__s   rNrrrrr!r!s  rr!ceZdZdZddZedZedZejdZddZ dZ d Z dd Z ed Z d Zd ZdZdZdZdZddZdZedZddZy) ToolManagera Manager for actions triggered by user interactions (key press, toolbar clicks, ...) on a Figure. Attributes ---------- figure : `.Figure` keypresslock : `~matplotlib.widgets.LockDraw` `.LockDraw` object to know if the `canvas` key_press_event is locked. messagelock : `~matplotlib.widgets.LockDraw` `.LockDraw` object to know if the message is available to write. Ncd|_i|_i|_i|_t j |_tj|_ tj|_ d|_ |j|yr ) _key_press_handler_id_tools_keys_toggledrCallbackRegistry _callbacksrLockDraw keypresslock messagelock_figure set_figurerfigures rrzToolManager.__init__.sf%)"   002$,,."++-  rcH|jsy|jjS)z Canvas managed by FigureManager.N)r0canvasrs rr5zToolManager.canvas>s||||"""rc|jS)zFigure that holds the canvas.)r0r6s rr3zToolManager.figureEs||rc&|j|yr )r1r2s rr3zToolManager.figureJs rc |jr%|jj|j||_|r+|jj d|j |_|r'|j jD] }||_ yy)z Bind the given figure to the tools. Parameters ---------- figure : `.Figure` update_tools : bool, default: True Force tools to update figure. key_press_eventN) r'r5mpl_disconnectr0 mpl_connect _key_pressr(valuesr3)rr3 update_toolsr s rr1zToolManager.set_figureNsz  % % KK & &t'A'A B )-)@)@!4??*4D &  **, %$  % rc:|jj||S)a Connect event with string *s* to *func*. Parameters ---------- s : str The name of the event. The following events are recognized: - 'tool_message_event' - 'tool_removed_event' - 'tool_added_event' For every tool added a new event is created - 'tool_trigger_TOOLNAME', where TOOLNAME is the id of the tool. func : callable Callback function for the toolmanager event with signature:: def func(event: ToolEvent) -> Any Returns ------- cid The callback id for the connection. This can be used in `.toolmanager_disconnect`. )r,connect)rsfuncs rtoolmanager_connectzToolManager.toolmanager_connectbs8&&q$//rc8|jj|S)z Disconnect callback id *cid*. Example usage:: cid = toolmanager.toolmanager_connect('tool_trigger_zoom', onpress) #...later toolmanager.toolmanager_disconnect(cid) )r, disconnect)rcids rtoolmanager_disconnectz"ToolManager.toolmanager_disconnects))#..rcb||}d}t|||}|jj||y)z!Emit a `ToolManagerMessageEvent`.Ntool_message_event)r!r,process)rr#r rBevents r message_eventzToolManager.message_events3 >F '67; 5)rc|jS)zCurrently toggled tools.)r*r6s r active_togglezToolManager.active_toggles}}rcv|jjDcgc] \}}||k(s |}}}|Scc}}w)a Return the keymap associated with the specified tool. Parameters ---------- name : str Name of the Tool. Returns ------- list of str List of keys associated with the tool. )r)items)rr kikeyss rget_tool_keymapzToolManager.get_tool_keymaps8#jj..0>daAI>> ?s 55cJ|j|D]}|j|=yr )rUr))rr rRs r _remove_keyszToolManager._remove_keyss'%%d+ A 1  rc "||jvrt|d|j|t|tr|g}|D]J}||j vr+t jd|d|j |d|||j |<Ly)z Set the keymap to associate with the specified tool. Parameters ---------- name : str Name of the Tool. key : str or list of str Keys to associate with the tool. z not in ToolszKey z changed from z to N)r(KeyErrorrW isinstancestrr)r warn_external)rr keyrRs r update_keymapzToolManager.update_keymaps t{{ "dX]34 4 $ c3 %C !ADJJ""1#^DJJqM?$tfEG DJJqM  !rcz|j|}tjtjj |dd}||t |ddr|j|d|j|td||}|jj|j||j|=y)z Remove tool named *name*. Parameters ---------- name : str Name of the tool. z3.6tool_removed_event)since alternativeNtoggledF toolmanager)get_toolrdeprecate_method_overriderToolBasedestroygetattr trigger_toolrWrr,rKr r()rr r rhrLs r remove_toolzToolManager.remove_tools}}T"00  " " * *D,.   I 4E *   dM 2 $.d;  E2 KK rctjt|j|}|st dt |z||j vr$tjd|j |S|dk(rE|tjk7r2tjdd|jd|jd|||g|i|}||j |<|j|j||jt|tj rv|j"%|j$j'd t)n&|j$j'|j"d |j*r|j-|d d |j/|j0t3d ||}|j4j7|j8||S) a Add *tool* to `ToolManager`. If successful, adds a new event ``tool_trigger_{name}`` where ``{name}`` is the *name* of the tool; the event is fired every time the tool is triggered. Parameters ---------- name : str Name of the tool, treated as the ID, has to be unique. tool : type Class of the tool to be added. A subclass will be used instead if one was registered for the current canvas class. Notes ----- args and kwargs get passed directly to the tools constructor. See Also -------- matplotlib.backend_tools.ToolBase : The base class for tools. zImpossible to find class for %sz;A "Tool class" with the same name already exists, not addedcursorz3.5zOverriding ToolSetCursor with z was only necessary to provide the .set_cursor() method, which is deprecated since %(since)s and will be removed %(removal)s. Please report this to the z author.)r#Ntool_added_event)r_find_tool_classtyper5 ValueErrorr[r(rr\ SetCursorBasewarn_deprecatedrrdefault_keymapr^rZToolToggleBase radio_groupr* setdefaultsetrc_handle_toggler1r3rr,rKr )rr r argskwargstool_clstool_objrLs radd_toolzToolManager.add_tools2!11$t{{2CTJ>TJK K 4;;     3 4;;t$ $ 8 M,G,G G  )I$,$9$9#:;K %-$7$7#8 *B CD$888$ D  " " .   tX%<%< = h < < =##+ ((su5 (()=)=tD##HdD9DKK(,dH=  E2rc|j}|m|j|jdvr)|jdj|jy|jdj |jy|j||jk(rd}nI|j| |j}n-|j |j|||||j}||j|<y)aO Toggle tools, need to untoggle prior to using other Toggle tool. Called from trigger_tool. Parameters ---------- tool : `.ToolBase` canvasevent : Event Original Canvas event or None. data : object Extra data to pass to the tool when triggering. N)rvr r*removeaddrj)rr rrrvrcs rryzToolManager._handle_toggle's&&   yyDMM$// d#**4995  d#'' 2  == % 2G]]; ' /iiG   dmmK8")" $iiG&- k"rc|j|}|y||}t|tjr|j ||||j |||d|z}t |||||}|jj||y)a Trigger a tool and emit the ``tool_trigger_{name}`` event. Parameters ---------- name : str Name of the tool. sender : object Object that wishes to trigger the tool. canvasevent : Event Original Canvas event or None. data : object Extra data to pass to the tool when triggering. Nztool_trigger_%s) rerZrrurytriggerrr,rK)rr r rrr rBrLs rrjzToolManager.trigger_toolRs}}T" <  >F dM88 9   k4 8 V[$/  $ FD+tD 5)rc|j|jjry|jj |jd}|y|j ||y)N)r)r]r.lockedr)getrj)rrLr s rr=zToolManager._key_pressqsS 99  1 1 8 8 : zz~~eii. <  $E2rc|jS)z,A dict mapping tool name -> controlled tool.)r(r6s rtoolszToolManager.toolszs{{rct|tjr|j|jvr|S||jvr|rt j d|y|j|S)a Return the tool object with the given name. For convenience, this passes tool objects through. Parameters ---------- name : str or `.ToolBase` Name of the tool, or the tool itself. warn : bool, default: True Whether a warning should be emitted it no tool with the given name exists. Returns ------- `.ToolBase` or None The tool or None if no tool with the given name exists. z"ToolManager does not control tool N)rZrrgr r(rr\)rr warns rrezToolManager.get_toolsc& t]33 4II,K t{{ """8AC{{4  rr )T)NNN)rrrrrpropertyr5r3setterr1rDrHrMrOrUrWr^rkr~ryrjr=rrerrrr%r% s  ##  ]]  %(0< /*$!,8CJ)-V*>3!rr%N) matplotlibrrrrrrr!r%rrrrs7::'y'  z!z!r