+ ]i.csp^RIHtHtHtHt!RR4t!RR]4t!RR4t!RR 4tR #) i)_api backend_toolscbookwidgetscs.a]tRt^toRtRRltRtVtR#) ToolEventz)Event for tool manipulation (add/remove).Ncs6WnW nW0nW@nR#N)namesendertooldata)selfrrrr s&&&&&B/usr/lib64/python3.14/site-packages/matplotlib/backend_managers.py__init__ZToolEvent.__init__s    )r rrrr__name__ __module__ __qualname____firstlineno____doc__r __static_attributes____classdictcell__ __classdict__@r rrs3r rcs:aa]tRt^ toRtRV3RlltRtVtV;t#)ToolTriggerEventz/Event to inform that a tool has been triggered.cs4<\SV`WW54W@nR#r)Zsuperr canvasevent)r rrrrr __class__s&&&&&&r r ZToolTriggerEvent.__init__s t2&r r)NN) rrrrrr rrZ __classcell__)rrs@@r rr s9''r rcs*a]tRt^toRtRtRtVtR#)ToolManagerMessageEventzg Event carrying messages from toolmanager. Messages usually get displayed to the user by the toolbar. cs*WnW nW0nR#r)rrmessage)r rrrs&&&&r r Z ToolManagerMessageEvent.__init__s   r )rrrNrrrr rrs r rcsa]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. Ncs RVn/Vn/Vn/Vn\P !4Vn\P!4Vn \P!4Vn RVn VPV4R#r) _key_press_handler_id_tools_keys_toggledrZCallbackRegistry _callbacksrZLockDraw keypresslock messagelock_figure set_figurer figure&&r r ZToolManager.__init__.sf%)"   002$,,."++-  r c sVVP'gR#VPP#)z Canvas managed by FigureManager.N)r'canvasr &r r,ZToolManager.canvas>s |||||"""r c VP#)zFigure that holds the canvas.)r'r-r.r r*ToolManager.figureEs||r cs(VPV4R#r)r(r)r+r r*r0Js r c sHVP'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. Zkey_press_eventN) r r,Zmpl_disconnectr'Z mpl_connect _key_pressr!Zvaluesr*)r r*Z update_toolsr&&& r r(ZToolManager.set_figureNst  % % % KK & &t'A'A B )-)@)@!4??*4D &  **,$ - r c s8VPPW4#)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$Zconnect)r sZfunc&&&r toolmanager_connectZToolManager.toolmanager_connectbs8&&q//r c s8VPPV4#)z Disconnect callback id *cid*. Example usage:: cid = toolmanager.toolmanager_connect('tool_trigger_zoom', onpress) #...later toolmanager.toolmanager_disconnect(cid) )r$Z disconnect)r Zcidr+r toolmanager_disconnectZ"ToolManager.toolmanager_disconnects))#..r c sdVfTpRp\W2V4pVPPW44R#)z!Emit a `ToolManagerMessageEvent`.NZtool_message_event)rr$process)r rrr3events&&& r message_eventZToolManager.message_events/ >F '7; )r c r/)zCurrently toggled tools.)r#r-r.r active_toggleZToolManager.active_toggles}}r c s|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. )r"Zitems)r rkZiZkeyss&& r get_tool_keymapZToolManager.get_tool_keymaps9#jj..0>0daAI0> ?s 88csPVPV4FpVPVK R#r)r<r")r rr;&& r _remove_keysZToolManager._remove_keyss"%%d+A 1 ,r c  sFWP9d\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)r!ZKeyErrorr> isinstancestrr"r warn_external)r rkeyr;r2r update_keymapZToolManager.update_keymaps {{ "dX]34 4 $ c3  %CAJJ""1#^DJJqM?$tfEG JJqM r c sVPV4p\VRR4'dVPVR4VPV4\ RW4pVP P VPV4VPVR#)zS Remove tool named *name*. Parameters ---------- name : str Name of the tool. toggledFZ toolmanagerZtool_removed_eventN) get_toolZgetattr trigger_toolr>rr$r7rr!)r rrr8s&& r remove_toolZToolManager.remove_toolsp}}T" 4E * *   dM 2 $.;  E2 KK r c sn\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 addedNZtool_added_event)rZ_find_tool_classZtyper,Z ValueErrorr@r!rrAZdefault_keymaprCr?ToolToggleBase radio_groupr#Z setdefaultZsetrD_handle_toggler(r*rr$r7r)r rrZargsZkwargsZtool_clsZtool_objr8s&&&*, r add_toolZToolManager.add_toolsR.!11$t{{2CTJ>TJK K ;;     3 4;;t$ $D888$ D  " " .   t%<%< = h < < = =##+ ((su5 (()=)=tD##HdD9DKK(,d=  E2r c s.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)rIrr#ZremoveZaddrF)r rrr rIrDs&&&& r rJZToolManager._handle_toggles&&   yyDMM$// d#**4995  d#'' 2  == % 2G]]; ' /iiG   dmmK8")" $iiG&- k"r c s*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) rEr?rrHrJZtriggerrr$r7)r rrrr rr3r8s&&&&& r rFZToolManager.trigger_tool;s}}T" <  >F dM88 9 9   4 8 V$/  $ DtD )r csVPe!VPP4'dR#VPP VPR4pVfR#VP W!R7R#)Nr)rBr%Zlockedr"ZgetrF)r r8rr=r r1ZToolManager._key_pressZsT 99  1 1 8 8 : : zz~~eii. <  $2r c r/)z,A dict mapping tool name -> controlled tool.)r!r-r.r toolsZToolManager.toolscs{{r c s \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)r?rZToolBaserr!rrA)r rZwarnr4r rEZToolManager.get_toolhsd& t]33 4 4II,K {{ """8AC{{4  r )r$r'r r"r#r!r%r&r)T)NNN)rrrrrr Zpropertyr,r*Zsetterr(r5r6r9r:r<r>rCrGrKrJrFr1rLrErrrrr rr s  ##  ]]  %(0< /*$!,"7r)-V*>3!!r rN) Z matplotlibrrrrrrrr)r r rMs7::'y'  c!c!r