There are several components of a matplotlib image:
- Figure - the base container (think the page)
- Axes - a set of coordinates. You can have several axes per figure
- Axis - the spines, ticks, labels on an axis
- Artist - every object that can be rendered
If you have used the pan / zoom tools or the 'g', 'l', 'k', etc keys in mpl, you have used the mpl event framework
- Events are available at the figure canvas level
| Event name | Description |
|---|---|
button_press_event |
mouse button is pressed |
button_release_event |
mouse button is released |
draw_event |
canvas draw (but before screen update) |
key_press_event |
key is pressed |
key_release_event |
key is released |
motion_notify_event |
mouse motion |
pick_event |
an object in the canvas is selected |
resize_event |
figure canvas is resized |
scroll_event |
mouse scroll wheel is rolled |
figure_enter_event |
mouse enters a new figure |
figure_leave_event |
mouse leaves a figure |
axes_enter_event |
mouse enters a new axes |
axes_leave_event |
mouse leaves an axes |
One needs to connect an event to a callback function
cid = canvas.mpl_connect(event_name, callback)
#canvas.mpl_disconnect(cid)If you modify some part of a figure, you need to call the draw or draw_idle methods of the canvas, to update with the changes