j/ddlmZmZmZmZGddZGddeZGddZGdd Zd S) )_api backend_toolscbookwidgetsceZdZdZddZdS) ToolEventz)Event for tool manipulation (add/remove).Nc>||_||_||_||_dSN)namesendertooldata)selfr r r rs IC:\Projects\DSCons\.venv\Lib\site-packages\matplotlib\backend_managers.py__init__zToolEvent.__init__s"    r __name__ __module__ __qualname____doc__rrrrrs.33rrc$eZdZdZdfd ZxZS)ToolTriggerEventz/Event to inform that a tool has been triggered.Nc^t||||||_dSr )superr canvasevent)rr r r rr __class__s rrzToolTriggerEvent.__init__s/ vtT222&r)NN)rrrrr __classcell__)rs@rrr sC99''''''''''rrceZdZdZdZdS)ToolManagerMessageEventzs Event carrying messages from toolmanager. Messages usually get displayed to the user by the toolbar. c0||_||_||_dSr )r r message)rr r r#s rrz ToolManagerMessageEvent.__init__s   rNrrrrr!r!s- rr!ceZdZdZddZedZedZejdZddZ d Z d Z dd Z ed Z d ZdZdZdZdZdZddZdZedZddZdS) 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|_ | |dSr ) _key_press_handler_id_tools_keys_toggledrCallbackRegistry _callbacksrLockDraw keypresslock messagelock_figure set_figurerfigures rrzToolManager.__init__.sr%)"   022$,.."+--  rc,|jsdS|jjS)z Canvas managed by FigureManager.N)r0canvasrs rr5zToolManager.canvas>s| 4|""rc|jS)zFigure that holds the canvas.)r0r6s rr3zToolManager.figureEs |rc0||dSr )r1r2s rr3zToolManager.figureJs rTc|jr|j|j||_|r%|jd|j|_|r#|jD] }||_ dSdS)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_figureNs  % C K & &t'A B B B  4)-)@)@!4?*4*4D &  % **,, % %$  % % % %rc8|j||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$///rc6|j|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))#...rcj||}d}t|||}|j||dS)z!Emit a `ToolManagerMessageEvent`.Ntool_message_event)r!r,process)rr#r rBevents r message_eventzToolManager.message_events@ >F '67;; 5)))))rc|jS)zCurrently toggled tools.)r*r6s r active_togglezToolManager.active_toggles }rcRfd|jD}|S)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. c&g|] \}}|k |Srr).0kir s r z/ToolManager.get_tool_keymap..s">>>daAIIIIIr)r)items)rr keyss ` rget_tool_keymapzToolManager.get_tool_keymaps1?>>>dj..00>>> rcF||D] }|j|= dSr )rXr))rr rSs r _remove_keyszToolManager._remove_keyss4%%d++  A 1   rc ||jvrt|d||t|tr|g}|D]=}||jvr(t jd|d|j|d|||j|<>dS)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(KeyErrorrZ isinstancestrr)r warn_external)rr keyrSs r update_keymapzToolManager.update_keymaps t{ " "d33344 4 $ c3   %C ! !ADJ"E1EEDJqMEEtEEGGG DJqMM  ! !rc||}t|ddr||d||t d||}|j|j||j|=dS)z Remove tool named *name*. Parameters ---------- name : str Name of the tool. toggledF toolmanagertool_removed_eventN) get_toolgetattr trigger_toolrZrr,rKr r()rr r rLs r remove_toolzToolManager.remove_tools}}T"" 4E * * 3   dM 2 2 2 $.d;;  E222 K   rctjt|j|}|st dt |z||jvr!tjd|j|S|||g|Ri|}||j|<|j | ||j t|tj rm|j (|jdt!n |j|j d|jr||dd||jt+d||}|j|j||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. *args, **kwargs Passed to the *tool*'s 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 addedNtool_added_event)r_find_tool_classtyper5 ValueErrorr^r(rr_default_keymaprar]ToolToggleBase radio_groupr* setdefaultsetrc_handle_toggler1r3rr,rKr )rr r argskwargstool_clstool_objrLs radd_toolzToolManager.add_tools.!1$t{2C2CTJJ L>TJKK K 4;     3 4 4 4;t$ $8D$888888$ D  " .   tX%< = = = h < = = :#+ ((suu5555 (()=tDDD :##HdD999DK(((,dH==  E222rc|j}|a|j|jdvr&|jd|jn%|jd|jdS|j||jkrd}n?|j||j}n*||j|||||j}||j|<dS)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)rqr r*removeaddrh)rr rrrqrcs rrtzToolManager._handle_toggles&   yDM$/// d#**495555 d#'' 222 F = % 2 2GG]; ' /iGG   dmK8")" $ $ $iG&- k"""rc6||}|dS||}t|tjr||||||||d|z}t |||||}|j||dS)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) rfr]rrprttriggerrr,rK)rr r rrr rBrLs rrhzToolManager.trigger_tool;s}}T"" < F >F dM8 9 9 9   k4 8 8 8 V[$///  $ FD+tDD 5)))))rc|j|jrdS|j|jd}|dS|||dS)N)r)r`r.lockedr)getrh)rrLr s rr=zToolManager._key_pressZsc 9  1 8 8 : :  Fz~~ei.. < F $E22222rc|jS)z,A dict mapping tool name -> controlled tool.)r(r6s rtoolszToolManager.toolscs {rct|tjr|j|jvr|S||jvr|rt jd|dS|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)r]rToolBaser r(rr_)rr warns rrfzToolManager.get_toolhsx& t]3 4 4 I,,K t{ " " C"AAACCC4{4  rr )T)NNN)rrrrrpropertyr5r3setterr1rDrHrMrOrXrZrariryrtrhr=rrfrrrr%r% s      ##X# X ]  ] %%%%(000< / / /****X$!!!,"777r)-)-)-V****>333X!!!!!!rr%N) matplotlibrrrrrrr!r%rrrrs::::::::::::'''''y'''        c!c!c!c!c!c!c!c!c!c!r