a Sic]1@sVddlmZmZmZmZGdddZGdddeZGdddZGdd d Zd S) )_api backend_toolscbookwidgetsc@seZdZdZdddZdS) ToolEventz)Event for tool manipulation (add/remove).NcCs||_||_||_||_dSN)namesendertooldata)selfrr r r r W/var/www/html/django/DPS/env/lib/python3.9/site-packages/matplotlib/backend_managers.py__init__szToolEvent.__init__)N__name__ __module__ __qualname____doc__rr r r rrsrcs"eZdZdZdfdd ZZS)ToolTriggerEventz/Event to inform that a tool has been triggered.Ncst||||||_dSr)superr canvasevent)r rr r rr  __class__r rrszToolTriggerEvent.__init__)NN)rrrrr __classcell__r r rrr src@seZdZdZddZdS)ToolManagerMessageEventzs Event carrying messages from toolmanager. Messages usually get displayed to the user by the toolbar. cCs||_||_||_dSr)rr message)r rr rr r rrsz ToolManagerMessageEvent.__init__Nrr r r rrsrc@seZdZdZd)ddZeddZeddZejd dZd*d d Z d dZ ddZ d+ddZ eddZ ddZddZddZddZddZdd Zd,d!d"Zd#d$Zed%d&Zd-d'd(ZdS). 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. NcCsJd|_i|_i|_i|_t|_t|_ t|_ d|_ | |dSr) _key_press_handler_id_tools_keys_toggledrCallbackRegistry _callbacksrLockDraw keypresslock messagelock_figure set_figurer figurer r rr.s   zToolManager.__init__cCs|js dS|jjS)z Canvas managed by FigureManager.N)r'canvasr r r rr+>szToolManager.canvascCs|jS)zFigure that holds the canvas.)r'r,r r rr*EszToolManager.figurecCs||dSr)r(r)r r rr*JsTcCsN|jr|j|j||_|r0|jd|j|_|rJ|jD] }||_q>dS)z Bind the given figure to the tools. Parameters ---------- figure : `.Figure` update_tools : bool, default: True Force tools to update figure. key_press_eventN) rr+mpl_disconnectr' mpl_connect _key_pressrvaluesr*)r r*Z update_toolsr r r rr(Ns zToolManager.set_figurecCs|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)r sfuncr r rtoolmanager_connectbszToolManager.toolmanager_connectcCs |j|S)z Disconnect callback id *cid*. Example usage:: cid = toolmanager.toolmanager_connect('tool_trigger_zoom', onpress) #...later toolmanager.toolmanager_disconnect(cid) )r# disconnect)r cidr r rtoolmanager_disconnects z"ToolManager.toolmanager_disconnectcCs.|dur |}d}t|||}|j||dS)z!Emit a `ToolManagerMessageEvent`.Ntool_message_event)rr#process)r rr r3eventr r r message_events  zToolManager.message_eventcCs|jS)zCurrently toggled tools.)r!r,r r r active_toggleszToolManager.active_togglecsfdd|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. csg|]\}}|kr|qSr r ).0kirr r z/ToolManager.get_tool_keymap..)r items)r rkeysr rArget_tool_keymapszToolManager.get_tool_keymapcCs||D] }|j|=q dSr)rFr )r rr?r r r _remove_keysszToolManager._remove_keysc Csv||jvrt|d||t|tr2|g}|D]:}||jvrftd|d|j|d|||j|<q6dS)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)rKeyErrorrG isinstancestrr r warn_external)r rkeyr?r r r update_keymaps    zToolManager.update_keymapcCsx||}tjtjj|ddd}|dur.|t|ddrF||d||t d||}|j |j ||j |=dS)z Remove tool named *name*. Parameters ---------- name : str Name of the tool. z3.6tool_removed_event)since alternativeNtoggledF toolmanager)get_toolrdeprecate_method_overriderToolBasedestroygetattr trigger_toolrGrr#r:rr)r rr rVr;r r r remove_tools      zToolManager.remove_toolcOs(tt|j|}|s&tdt|||jvrDtd|j|S|dkrv|tj krvtj dd|j d|j dd|||g|Ri|}||j|<|j d ur|||j t|tjr|jd ur|jd tn|j|jd |jr||d d ||jtd ||}|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. 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.)rNtool_added_event)r_find_tool_classtyper+ ValueErrorrJrrrK SetCursorBasewarn_deprecatedrrdefault_keymaprMrIToolToggleBase radio_groupr! setdefaultsetrQ_handle_toggler(r*rr#r:r)r rr argskwargstool_clsZtool_objr;r r radd_tools8          zToolManager.add_toolcCs|j}|durH|j|jdvr2|jd|jn|jd|jdS|j||jkr^d}n2|j|durt|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)rcrr!removeaddrX)r r rr rcrQr r rrf's" zToolManager._handle_togglecCst||}|durdS|dur"|}t|tjr<||||||||d|}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) rSrIrrbrftriggerrr#r:)r rr rr r r3r;r r rrXRs  zToolManager.trigger_toolcCsF|jdus|jrdS|j|jd}|dur4dS|j||ddS)N)r)rLr%lockedr getrX)r r;rr r rr0qs zToolManager._key_presscCs|jS)z,A dict mapping tool name -> controlled tool.)rr,r r rtoolszszToolManager.toolscCsHt|tjr|j|jvr|S||jvr>|r:td|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)rIrrUrrrrK)r rwarnr r rrSs   zToolManager.get_tool)N)T)N)NNN)T)rrrrrpropertyr+r*setterr(r5r8r<r=rFrGrMrYrjrfrXr0rprSr r r rr s2       E+   rN) matplotlibrrrrrrrrr r r rs