matplotlib.pyplot.ginput#

matplotlib.pyplot.ginput(n=1, timeout=30, show_clicks=True, mouse_add=MouseButton.LEFT, mouse_pop=MouseButton.RIGHT, mouse_stop=MouseButton.MIDDLE)[源代码]#

与图形交互的阻塞调用。

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

有三种可能的交互方式：

  • 添加一个点。

  • 移除最近添加的点。

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

这些操作通过参数 mouse_add、mouse_pop 和 mouse_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) 坐标的列表。

备注

注意

这是 pyplot 封装器，用于 Figure.ginput。

如果您的鼠标没有一个或多个按钮，也可以使用键盘来选择点。删除键和退格键的作用类似于右键点击（即，移除最后一个点），回车键终止输入，任何其他键（未被窗口管理器占用的）都将选择一个点。

使用 matplotlib.pyplot.ginput 的示例#

交互式函数

交互式函数
在此页