matplotlib.figure.Figure.ginput#

Figure.ginput(n=1, timeout=30, show_clicks=True, mouse_add=MouseButton.LEFT, mouse_pop=MouseButton.RIGHT, mouse_stop=MouseButton.MIDDLE)[source]#

与图形交互的阻塞调用。

等待用户在图表上点击 n 次,并返回每次点击的坐标列表。

有三种可能的交互方式:

  • 添加一个点。

  • 移除最近添加的点。

  • 停止交互并返回目前已添加的点。

这些操作通过参数 mouse_addmouse_popmouse_stop 分配给鼠标按钮。

参数:
nint,默认值:1

要累积的鼠标点击次数。如果为负数,则累积点击直到手动终止输入。

timeoutfloat,默认值:30 秒

在超时前等待的秒数。如果为零或负数,则永不超时。

show_clicksbool,默认值:True

如果为 True,则在每次点击的位置显示一个红色十字。

mouse_addMouseButton 或 None,默认值:MouseButton.LEFT

用于添加点的鼠标按钮。

mouse_popMouseButton 或 None,默认值:MouseButton.RIGHT

用于移除最近添加的点的鼠标按钮。

mouse_stopMouseButton 或 None,默认值:MouseButton.MIDDLE

用于停止输入的鼠标按钮。

返回:
元组列表

点击的 (x, y) 坐标列表。

备注

如果您的鼠标没有一个或多个按钮,也可以使用键盘来选择点。Delete 键和 Backspace 键的作用类似于右键点击(即,移除上一个点),Enter 键终止输入,任何其他键(未被窗口管理器占用的)则选择一个点。