| Server IP : 202.61.199.114 / Your IP : 216.73.217.139 Web Server : nginx/1.22.1 System : Linux de.arni-solutions.de 6.1.0-49-amd64 #1 SMP PREEMPT_DYNAMIC Debian 6.1.174-1 (2026-05-26) x86_64 User : web20 ( 1018) PHP Version : 8.4.23 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : ON Directory : /usr/local/lib/python3.9/dist-packages/matplotlib/__pycache__/ |
Upload File : |
a
���h. � @ sV d dl mZmZmZmZ G dd� d�ZG dd� de�ZG dd� d�ZG dd � d �Zd
S ) � )�_api�
backend_tools�cbook�widgetsc @ s e Zd ZdZddd�ZdS )� ToolEventz)Event for tool manipulation (add/remove).Nc C s || _ || _|| _|| _d S �N)�name�sender�tool�data)�selfr r r
r � r
�E/usr/local/lib/python3.9/dist-packages/matplotlib/backend_managers.py�__init__ s zToolEvent.__init__)N��__name__�
__module__� __qualname__�__doc__r r
r
r
r r s r c s" e Zd ZdZd� fdd� Z� ZS )�ToolTriggerEventz/Event to inform that a tool has been triggered.Nc s t � �||||� || _d S r )�superr � canvasevent)r r r r
r r �� __class__r
r r s zToolTriggerEvent.__init__)NN)r r r r r �
__classcell__r
r
r r r
s r c @ s e Zd ZdZdd� ZdS )�ToolManagerMessageEventzs
Event carrying messages from toolmanager.
Messages usually get displayed to the user by the toolbar.
c C s || _ || _|| _d S r )r r �message)r r r r r
r
r r s z ToolManagerMessageEvent.__init__Nr r
r
r
r r s r c @ s� e Zd ZdZd)dd�Zedd� �Zedd� �Zejd d� �Zd*d d �Z d
d� Z
dd� Z d+dd�Z edd� �Z
dd� Zdd� Zdd� Zdd � Zd d � Zd d � 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.
Nc C sJ d | _ i | _i | _i | _t�� | _t�� | _ t�� | _
d | _ | � |� d S r )
�_key_press_handler_id�_tools�_keys�_toggledr ZCallbackRegistry�
_callbacksr ZLockDraw� keypresslockZ messagelock�_figure�
set_figure�r �figurer
r
r r . s
zToolManager.__init__c C s | j s
dS | j jS )z Canvas managed by FigureManager.N)r$ �canvas�r r
r
r r( > s zToolManager.canvasc C s | j S )z Figure that holds the canvas.)r$ r) r
r
r r' E s zToolManager.figurec C s | � |� d S r )r% r& r
r
r r' J s Tc C sN | j r| j�| j � || _|r0| j�d| j�| _ |rJ| j�� D ]
}||_q>dS )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 �valuesr' )r r' Z update_toolsr
r
r
r r% N s
�zToolManager.set_figurec C s | 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 �s�funcr
r
r �toolmanager_connectb s z ToolManager.toolmanager_connectc C s | j �|�S )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
r �toolmanager_disconnect� s
z"ToolManager.toolmanager_disconnectc C s. |du r | }d}t |||�}| j�||� dS )z!Emit a `ToolManagerMessageEvent`.NZtool_message_event)r r" �process)r r r r- �eventr
r
r �
message_event� s
zToolManager.message_eventc C s | j S )zCurrently toggled tools.)r! r) r
r
r �
active_toggle� s zToolManager.active_togglec s � fdd�| j �� D �}|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.
c s g | ]\}}|� kr|�qS r
r
)�.0�k�i�r r
r �
<listcomp>� � z/ToolManager.get_tool_keymap.<locals>.<listcomp>)r �items)r r �keysr
r8 r �get_tool_keymap� s zToolManager.get_tool_keymapc C s | � |�D ] }| j|= q
d S r )r= r )r r r6 r
r
r � _remove_keys� s zToolManager._remove_keysc C sv || j vrt|�d���| �|� t|t�r2|g}|D ]:}|| jv rft�d|� 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)r �KeyErrorr> �
isinstance�strr r �
warn_external)r r �keyr6 r
r
r �
update_keymap� s
�zToolManager.update_keymapc C sT | � |�}t|dd�r"| �|d� | �|� td| |�}| j�|j|� | j|= dS )z�
Remove tool named *name*.
Parameters
----------
name : str
Name of the tool.
�toggledFZ toolmanagerZtool_removed_eventN) �get_tool�getattr� trigger_toolr> r r" r1 r r )r r r
r2 r
r
r � remove_tool� s
zToolManager.remove_toolc O s� t �t| j�|�}|s&tdt|� ��|| jv rDt�d� | j| S || |g|�R i |��}|| j|< |j dur~| �
||j � t |t j �r�|j
du r�| j�dt� � n| j�|j
d� |jr�| �|dd� |�| j� td| |�}| 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.
*args, **kwargs
Passed to the *tool*'s constructor.
See Also
--------
matplotlib.backend_tools.ToolBase : The base class for tools.
z Impossible to find class for %sz;A "Tool class" with the same name already exists, not addedNZtool_added_event)r Z_find_tool_class�typer( �
ValueErrorrA r r rB Zdefault_keymaprD r@ �ToolToggleBase� radio_groupr! �
setdefault�setrE �_handle_toggler% r' r r" r1 r )r r r
�args�kwargsZtool_clsZtool_objr2 r
r
r �add_tool� s(
zToolManager.add_toolc C s� |j }|du rH|j| jd v r2| jd �|j� n| jd �|j� dS | j| |jkr^d}n2| j| du rt|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)rM r r! �remove�addrH )r r
r r rM rE r
r
r rP s" �zToolManager._handle_togglec C st | � |�}|du rdS |du r"| }t|tj�r<| �|||� |�|||� 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) rF r@ r rL rP �triggerr r" r1 )r r r r r r
r- r2 r
r
r rH ; s
zToolManager.trigger_toolc C sF |j d u s| j�� rd S | j�|j d �}|d u r4d S | j||d� d S )N)r )rC r# �lockedr �getrH )r r2 r r
r
r r* Z s zToolManager._key_pressc C s | j S )z,A dict mapping tool name -> controlled tool.)r r) r
r
r �toolsc s zToolManager.toolsc C sH t |tj�r |j| jv r |S || jvr>|r:t�d|��� 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)r@ r ZToolBaser r r rB )r r �warnr
r
r rF h s
�
�zToolManager.get_tool)N)T)N)NNN)T)r r r r r �propertyr( r' �setterr% r/ r0 r3 r4 r= r> rD rI rS rP rH r* rY rF r
r
r
r r s2
9+
r N) Z
matplotlibr r r r r r r r r
r
r
r �<module> s