h.nSSKJrJrJrJr "SS5r"SS\5r"SS5r"SS 5rg ) )_api backend_toolscbookwidgetsc"\rSrSrSrSSjrSrg) ToolEventz)Event for tool manipulation (add/remove).Nc4XlX lX0lX@lgN)namesendertooldata)selfr r rrs M/var/www/html/env/lib/python3.13/site-packages/matplotlib/backend_managers.py__init__ToolEvent.__init__s    )rr r rr __name__ __module__ __qualname____firstlineno____doc__r__static_attributes__rrrrs 3rrc0^\rSrSrSrSU4SjjrSrU=r$)ToolTriggerEvent z/Event to inform that a tool has been triggered.c2>[TU]XX55 X@lgr )superr canvasevent)rr r rr"r __class__s rrToolTriggerEvent.__init__s t2&rr")NN)rrrrrrr __classcell__)r#s@rrr s9''rrc\rSrSrSrSrSrg)ToolManagerMessageEventzg Event carrying messages from toolmanager. Messages usually get displayed to the user by the toolbar. c(XlX lX0lgr )r r message)rr r r+s rr ToolManagerMessageEvent.__init__s   r)r+r r Nrrrrr(r(s  rr(c\rSrSrSrSSjr\S5r\S5r\RS5rSSjr S r S r SS jr \S 5rS rSrSrSrSrSrSSjrSr\S5rSSjrSrg) ToolManager av 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. NcSUl0Ul0Ul0Ul[R "5Ul[R"5Ul [R"5Ul SUl URU5 gr ) _key_press_handler_id_tools_keys_toggledrCallbackRegistry _callbacksrLockDraw keypresslock messagelock_figure set_figurerfigures rrToolManager.__init__.sf%)"   002$,,."++-  rcRUR(dgURR$)z Canvas managed by FigureManager.N)r:canvasrs rr@ToolManager.canvas>s||||"""rcUR$)zFigure that holds the canvas.)r:rAs rr=ToolManager.figureEs||rc&URU5 gr )r;r<s rr=rDJs rc>UR(a%URRUR5 XlU(a+URR SUR 5UlU(a(UR R5H nXlM gg)z Bind the given figure to the tools. Parameters ---------- figure : `.Figure` update_tools : bool, default: True Force tools to update figure. key_press_eventN) r1r@mpl_disconnectr: mpl_connect _key_pressr2valuesr=)rr= update_toolsrs rr;ToolManager.set_figureNsq  % % KK & &t'A'A B )-)@)@!4??*4D &  **,$ - rc8URRX5$)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`. )r6connect)rsfuncs rtoolmanager_connectToolManager.toolmanager_connectbs8&&q//rc8URRU5$)z Disconnect callback id *cid*. Example usage:: cid = toolmanager.toolmanager_connect('tool_trigger_zoom', onpress) #...later toolmanager.toolmanager_disconnect(cid) )r6 disconnect)rcids rtoolmanager_disconnect"ToolManager.toolmanager_disconnects))#..rc`UcUnSn[X2U5nURRX45 g)z!Emit a `ToolManagerMessageEvent`.Ntool_message_event)r(r6process)rr+r rPevents r message_eventToolManager.message_events/ >F '7; )rcUR$)zCurrently toggled tools.)r4rAs r active_toggleToolManager.active_toggles}}rc|URR5VVs/sHup#X1:XdM UPM nnnU$s snnf)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. )r3items)rr kikeyss rget_tool_keymapToolManager.get_tool_keymaps7#jj..0>0daAI0> ?s 88cNURU5HnURU M gr )rgr3)rr rds r _remove_keysToolManager._remove_keyss"%%d+A 1 ,rc 6XR;a[U<S35eURU5 [U[5(aU/nUHLnX0R ;a,[ R"SUSUR USU35 XR U'MN g)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)r2KeyErrorrj isinstancestrr3r warn_external)rr keyrds r update_keymapToolManager.update_keymaps {{ "dX]34 4 $ c3  %CAJJ""1#^DJJqM?$tfEG JJqM rcURU5n[USS5(aURUS5 URU5 [ SX5nUR R URU5 URU g)zS Remove tool named *name*. Parameters ---------- name : str Name of the tool. toggledF toolmanagertool_removed_eventN) get_toolgetattr trigger_toolrjrr6r[r r2)rr rr\s r remove_toolToolManager.remove_toolsp}}T" 4E * *   dM 2 $.;  E2 KK rcR[R"[UR5U5nU(d[ S[ U5-5eXR ;a%[R"S5 UR U$U"X/UQ70UD6nX`R U'URbURXR5 [U[R5(a|URc%URRS[!55 O&URRURS5 UR"(aUR%USS5 UR'UR(5 [+SX5nUR,R/UR0U5 U$)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@ ValueErrorror2rrpdefault_keymaprrrnToolToggleBase radio_groupr4 setdefaultsetru_handle_toggler;r=rr6r[r )rr rargskwargstool_clstool_objr\s radd_toolToolManager.add_toolsO.!11$t{{2CTJ>TJK K ;;     3 4;;t$ $D888$ D  " " .   t%<%< = h < < = =##+ ((su5 (()=)=tD##HdD9DKK(,d=  E2rcURnUcoURURS;a)URSRUR5 gURSR UR5 gURUUR:XaSnOJURUc URnO-UR URUUUU5 URnXPRU'g)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 r4removeaddrz)rrr"rrrus rrToolManager._handle_toggles&&   yyDMM$// d#**4995  d#'' 2  == % 2G]]; ' /iiG   dmmK8")" $iiG&- k"rcURU5nUcgUcUn[U[R5(aUR XSU5 UR X#U5 SU-n[ XbXSU5nURRXg5 g)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) rxrnrrrtriggerrr6r[)rr r r"rrrPr\s rrzToolManager.trigger_tool;s}}T" <  >F dM88 9 9   4 8 V$/  $ DtD )rcURbURR5(agURR URS5nUcgUR X!S9 g)Nr%)rqr8lockedr3getrz)rr\r s rrJToolManager._key_pressZsT 99  1 1 8 8 : : zz~~eii. <  $2rcUR$)z,A dict mapping tool name -> controlled tool.)r2rAs rtoolsToolManager.toolscs{{rc[U[R5(aURUR;aU$XR;a"U(a[ R "SU<35 gURU$)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)rnrToolBaser r2rrp)rr warns rrxToolManager.get_toolhsd& t]33 4 4II,K {{ """8AC{{4  r)r6r:r1r3r4r2r8r9r )T)NNN)rrrrrrpropertyr@r=setterr;rRrWr]r`rgrjrrr{rrrzrJrrxrrrrr.r. s  ##  ]]  %(0< /*$!,"7r)-V*>3!rr.N) matplotlibrrrrrrr(r.rrrrs7::'y'  c!c!r