σ m[c@`sΩdZddlmZmZmZmZddlZddlZddlj Z ddl j Z ddl m Z ddljZdefd„ƒYZdefd„ƒYZd efd „ƒYZd efd „ƒYZdS( uœ `ToolManager` Class that makes the bridge between user interaction (key press, toolbar clicks, ..) and the actions in response to the user inputs. i(tabsolute_importtdivisiontprint_functiontunicode_literalsN(tvalidate_stringlistt ToolEventcB`seZdZdd„ZRS(u(Event for tool manipulation (add/remove)cC`s(||_||_||_||_dS(N(tnametsenderttooltdata(tselfRRRR ((s:lib/python2.7/site-packages/matplotlib/backend_managers.pyt__init__s   N(t__name__t __module__t__doc__tNoneR (((s:lib/python2.7/site-packages/matplotlib/backend_managers.pyRstToolTriggerEventcB`seZdZddd„ZRS(u/Event to inform that a tool has been triggeredcC`s&tj|||||ƒ||_dS(N(RR t canvasevent(R RRRRR ((s:lib/python2.7/site-packages/matplotlib/backend_managers.pyR sN(R R RRR (((s:lib/python2.7/site-packages/matplotlib/backend_managers.pyRstToolManagerMessageEventcB`seZdZd„ZRS(uq Event carrying messages from toolmanager Messages usually get displayed to the user by the toolbar cC`s||_||_||_dS(N(RRtmessage(R RRR((s:lib/python2.7/site-packages/matplotlib/backend_managers.pyR (s  (R R RR (((s:lib/python2.7/site-packages/matplotlib/backend_managers.pyR"st ToolManagercB`seZdZdd„Zed„ƒZed„ƒZejd„ƒZe d„Z d„Z d„Z dd„Z ed „ƒZd „Zd „Zd „Zd „Zd„Zd„Zd„Zd„Zdddd„Zdddd„Zd„Zed„ƒZe d„ZRS(uY Helper class that groups all the user interactions for a Figure Attributes ---------- figure: `Figure` keypresslock: `widgets.LockDraw` `LockDraw` object to know if the `canvas` key_press_event is locked messagelock: `widgets.LockDraw` `LockDraw` object to know if the message is available to write cC`s€tjdddƒd|_i|_i|_i|_tjƒ|_ t j ƒ|_ t j ƒ|_ d|_|j|ƒdS(Nu1Treat the new Tool classes introduced in v1.5 as u4experimental for now, the API will likely change in u+version 2.1 and perhaps the rcParam as well(twarningstwarnRt_key_press_handler_idt_toolst_keyst_toggledtcbooktCallbackRegistryt _callbackstwidgetstLockDrawt keypresslockt messagelockt_figuret set_figure(R tfigure((s:lib/python2.7/site-packages/matplotlib/backend_managers.pyR ;s     cC`s|js dS|jjS(uCanvas managed by FigureManagerN(R"Rtcanvas(R ((s:lib/python2.7/site-packages/matplotlib/backend_managers.pyR%Ns cC`s|jS(uFigure that holds the canvas(R"(R ((s:lib/python2.7/site-packages/matplotlib/backend_managers.pyR$UscC`s|j|ƒdS(N(R#(R R$((s:lib/python2.7/site-packages/matplotlib/backend_managers.pyR$ZscC`s||jr|jj|jƒn||_|rL|jjd|jƒ|_n|rxx#|jjƒD]}||_qbWndS(uΐ Sets the figure to interact with the tools Parameters ========== figure: `Figure` update_tools: bool Force tools to update figure ukey_press_eventN( RR%tmpl_disconnectR"t mpl_connectt _key_pressRtvaluesR$(R R$t update_toolsR((s:lib/python2.7/site-packages/matplotlib/backend_managers.pyR#^s   cC`s|jj||ƒS(u% Connect event with string *s* to *func*. Parameters ---------- s : String 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 : function Function to be called with signature def func(event) (Rtconnect(R tstfunc((s:lib/python2.7/site-packages/matplotlib/backend_managers.pyttoolmanager_connectrscC`s|jj|ƒS(u Disconnect callback id *cid* Example usage:: cid = toolmanager.toolmanager_connect('tool_trigger_zoom', on_press) #...later toolmanager.toolmanager_disconnect(cid) (Rt disconnect(R tcid((s:lib/python2.7/site-packages/matplotlib/backend_managers.pyttoolmanager_disconnectŒs cC`sD|dkr|}nd}t|||ƒ}|jj||ƒdS(u! Emit a `ToolManagerMessageEvent`utool_message_eventN(RRRtprocess(R RRR,tevent((s:lib/python2.7/site-packages/matplotlib/backend_managers.pyt message_event™s   cC`s|jS(uCurrently toggled tools(R(R ((s:lib/python2.7/site-packages/matplotlib/backend_managers.pyt active_toggle’scC`s;gtj|jƒD]\}}||kr|^q}|S(uσ Get the keymap associated with the specified tool Parameters ---------- name : string Name of the Tool Returns ------- list : list of keys associated with the Tool (tsixt iteritemsR(R Rtktitkeys((s:lib/python2.7/site-packages/matplotlib/backend_managers.pytget_tool_keymap¨s7cC`s(x!|j|ƒD]}|j|=qWdS(N(R;R(R RR8((s:lib/python2.7/site-packages/matplotlib/backend_managers.pyt _remove_keysΉscG`s›||jkr"td|ƒ‚n|j|ƒxe|D]]}xTt|ƒD]F}||jkr‚tjd||j||fƒn||j||j|dƒn|j|ƒd}t|||ƒ}|jj||ƒ|j |=dS(uŠ Remove tool from `ToolManager` Parameters ---------- name : string Name of the Tool utoggledu toolmanagerutool_removed_eventN( tget_tooltdestroytgetattrtFalset trigger_toolR<RRR2R(R RRR,R3((s:lib/python2.7/site-packages/matplotlib/backend_managers.pyt remove_toolΤs   cO`s2|j|ƒ}|s.tdt|ƒƒ‚n||jkrUtjdƒ|j|S|||||Ž}||j|<|jdk rœ|j||jƒnt |t j ƒr|j dkrΦ|j jdtƒƒn|j j|j dƒ|jr|j|dddƒqn|j|jƒ|j|ƒ|S(uŒ Add *tool* to `ToolManager` If successful adds a new event `tool_trigger_name` where **name** is the **name** of the tool, this event is fired everytime the tool is triggered. Parameters ---------- name : str Name of the tool, treated as the ID, has to be unique tool : class_like, i.e. str or type Reference to find the class of the Tool to added. Notes ----- args and kwargs get passed directly to the tools constructor. See Also -------- matplotlib.backend_tools.ToolBase : The base class for tools. uImpossible to find class for %su;A "Tool class" with the same name already exists, not addedN(t_get_cls_to_instantiatet ValueErrortstrRRRtdefault_keymapRR?t isinstancettoolstToolToggleBaset radio_groupRt setdefaulttsetttoggledt_handle_toggleR#R$t_tool_added_event(R RRtargstkwargsttool_clsttool_obj((s:lib/python2.7/site-packages/matplotlib/backend_managers.pytadd_toolνs&     cC`s/d}t|||ƒ}|jj||ƒdS(Nutool_added_event(RRR2(R RR,R3((s:lib/python2.7/site-packages/matplotlib/backend_managers.pyRR%scC`sΥ|j}|dkr`|j|jdkrE|jdj|jƒn|jdj|jƒdS|j||jkrd}nE|j|dkrž|j}n&|j|j||||ƒ|j}||j|RR tlockedRtgetRD(R R3R((s:lib/python2.7/site-packages/matplotlib/backend_managers.pyR(”s  cC`s|jS(u,Return the tools controlled by `ToolManager`(R(R ((s:lib/python2.7/site-packages/matplotlib/backend_managers.pyRKscC`s`t|tjƒr(|j|jkr(|S||jkrU|rQtjd|ƒndS|j|S(u Return the tool object, also accepts the actual tool for convenience Parameters ---------- name : str, ToolBase Name of the tool, or the tool itself warn : bool, optional If this method should give warnings. u$ToolManager does not control tool %sN(RJRKtToolBaseRRRRR(R RR((s:lib/python2.7/site-packages/matplotlib/backend_managers.pyR@£s $N(R R RRR tpropertyR%R$tsettertTrueR#R.R1R4R5R;R<R?RERWRRRQRFRDRbR(RKR@(((s:lib/python2.7/site-packages/matplotlib/backend_managers.pyR.s0          8  -   (Rt __future__RRRRR6Rtmatplotlib.cbookRtmatplotlib.widgetsRtmatplotlib.rcsetupRtmatplotlib.backend_toolst backend_toolsRKtobjectRRRR(((s:lib/python2.7/site-packages/matplotlib/backend_managers.pyts"