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)[source]

Блокирующий вызов для взаимодействия с рисунком.

Ожидает, пока пользователь 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

Кнопка мыши, используемая для остановки ввода.

Возвращает

list of tuples

Список координат кликов (x, y).

Примечания

Клавиатура также может использоваться для выбора точек в случае, если у вашей мыши отсутствует одна или несколько кнопок. Кнопки Delete и Backspace действуют как правая кнопка мыши (т.е. удаление последней точки), клавиша Enter завершает ввод, а любая другая клавиша (которая не используется менеджером окон) выбирает точку.

Примеры использования matplotlib.pyplot.ginput