+ i.p^RIHtHtHtHt!RR4t!RR]4t!RR4t!RR 4tR #) )_api backend_toolscbookwidgetsc.a]tRt^toRtRRltRtVtR#) ToolEventz)Event for tool manipulation (add/remove).Nc6WnW nW0nW@nR#N)namesendertooldata)selfr r r rs&&&&&{/Users/tonyclaw/.openclaw/workspace/skills/math-calculator/venv/lib/python3.14/site-packages/matplotlib/backend_managers.py__init__ToolEvent.__init__s    )rr r r r __name__ __module__ __qualname____firstlineno____doc__r__static_attributes____classdictcell__ __classdict__s@rrrs3rrc:aa]tRt^ toRtRV3RlltRtVtV;t#)ToolTriggerEventz/Event to inform that a tool has been triggered.c4<\SV`WW54W@nR#r )superr canvasevent)rr r r r"r __class__s&&&&&&rrToolTriggerEvent.__init__s t2&rr")NN) rrrrrrrr __classcell__)r#rs@@rrr s9''rrc*a]tRt^toRtRtRtVtR#)ToolManagerMessageEventzg Event carrying messages from toolmanager. Messages usually get displayed to the user by the toolbar. c*WnW nW0nR#r )r r message)rr r r*s&&&&rr ToolManagerMessageEvent.__init__s   r)r*r r Nrrs@rr(r(s rr(ca]tRt^ toRtRRlt]R4t]R4t]PR4tRRlt Rt R t RR lt ]R 4tR tR tRtRtRtRtRRltRt]R4tRRltRtVtR#) ToolManagerav 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. Nc RVn/Vn/Vn/Vn\P !4Vn\P!4Vn \P!4Vn RVn VPV4R#r ) _key_press_handler_id_tools_keys_toggledrCallbackRegistry _callbacksrLockDraw keypresslock messagelock_figure set_figurerfigures&&rrToolManager.__init__.sf%)"   002$,,."++-  rc VVP'gR#VPP#)z Canvas managed by FigureManager.N)r8canvasrs&rr>ToolManager.canvas>s |||||"""rc VP#)zFigure that holds the canvas.)r8r?s&rr;ToolManager.figureEs||rc(VPV4R#r )r9r:s&&rr;rBJs rc HVP'd&VPPVP4WnV'd,VPP RVP 4VnV'd*VP P4F pWnK R#R#)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/r>mpl_disconnectr8 mpl_connect _key_pressr0valuesr;)rr; update_toolsr s&&& rr9ToolManager.set_figureNst  % % % KK & &t'A'A B )-)@)@!4??*4D &  **,$ - rc 8VPPW4#)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`. )r4connect)rsfuncs&&&rtoolmanager_connectToolManager.toolmanager_connectbs8&&q//rc 8VPPV4#)z Disconnect callback id *cid*. Example usage:: cid = toolmanager.toolmanager_connect('tool_trigger_zoom', onpress) #...later toolmanager.toolmanager_disconnect(cid) )r4 disconnect)rcids&&rtoolmanager_disconnect"ToolManager.toolmanager_disconnects))#..rc dVfTpRp\W2V4pVPPW44R#)z!Emit a `ToolManagerMessageEvent`.Ntool_message_event)r(r4process)rr*r rNevents&&& r message_eventToolManager.message_events/ >F '7; )rc VP#)zCurrently toggled tools.)r2r?s&r active_toggleToolManager.active_toggles}}rc |VPP4UUu.uFwr#W18XgK VNK pppV#uuppi)z 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. )r1items)rr kikeyss&& rget_tool_keymapToolManager.get_tool_keymaps9#jj..0>0daAI0> ?s 88cPVPV4FpVPVK R#r )rer1)rr rbs&& r _remove_keysToolManager._remove_keyss"%%d+A 1 ,rc  FWP9d\V: R24hVPV4\V\4'dV.pVFQpW0P 9d1\ P!RV RVP V, RV 24WP V&KS R#)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)r0KeyErrorrh isinstancestrr1r warn_external)rr keyrbs&&& r update_keymapToolManager.update_keymaps {{ "dX]34 4 $ c3  %CAJJ""1#^DJJqM?$tfEG JJqM rc VPV4p\VRR4'dVPVR4VPV4\ RW4pVP P VPV4VPVR#)zS Remove tool named *name*. Parameters ---------- name : str Name of the tool. toggledF toolmanagertool_removed_eventN) get_toolgetattr trigger_toolrhrr4rYr r0)rr r rZs&& r remove_toolToolManager.remove_toolsp}}T" 4E * *   dM 2 $.;  E2 KK rc n\P!\VP4V4pV'g\ R\ V4,4hWP 9d*\P!R4VP V,#V!W.VO5/VBpW`P V&VPeVPWP4\V\P4'dVPf&VPPR\!44M&VPPVPR4VP"'dVP%VRR4VP'VP(4\+RW4pVP,P/VP0V4V#)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_classtyper> ValueErrorrmr0rrndefault_keymaprprlToolToggleBase radio_groupr2 setdefaultsetrs_handle_toggler9r;rr4rYr )rr r argskwargstool_clstool_objrZs&&&*, radd_toolToolManager.add_toolsR.!11$t{{2CTJ>TJK K ;;     3 4;;t$ $D888$ D  " " .   t%<%< = h < < = =##+ ((su5 (()=)=tD##HdD9DKK(,d=  E2rc .VPpVfVPVPR,9d/VPR,PVP4R#VPR,P VP4R#VPV,VP8XdRpMSVPV,fVPpM1VP VPV,VVV4VPpWPPV&R#)z 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)rr r2removeaddrx)rr r"rrrss&&&& rrToolManager._handle_toggles&&   yyDMM$// d#**4995  d#'' 2  == % 2G]]; ' /iiG   dmmK8")" $iiG&- k"rc *VPV4pVfR#VfTp\V\P4'dVP WSV4VP W#V4RV,p\ WbWSV4pVPPWg4R#)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) rvrlrrrtriggerrr4rY)rr r r"rr rNrZs&&&&& rrxToolManager.trigger_tool;s}}T" <  >F dM88 9 9   4 8 V$/  $ DtD )rcVPe!VPP4'dR#VPP VPR4pVfR#VP W!R7R#)Nr%)ror6lockedr1getrx)rrZr s&& rrHToolManager._key_pressZsT 99  1 1 8 8 : : zz~~eii. <  $2rc VP#)z,A dict mapping tool name -> controlled tool.)r0r?s&rtoolsToolManager.toolscs{{rc \V\P4'dVPVP9dV#WP9d%V'd\ P !RV: 24R#VPV,#)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)rlrToolBaser r0rrn)rr warns&&&rrvToolManager.get_toolhsd& t]33 4 4II,K {{ """8AC{{4  r)r4r8r/r1r2r0r6r7r )T)NNN)rrrrrrpropertyr>r;setterr9rPrUr[r^rerhrpryrrrxrHrrvrrrs@rr-r- s  ##  ]]  %(0< /*$!,"7r)-V*>3!!rr-N) matplotlibrrrrrrr(r-rrrs7::'y'  c!c!r