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.

Parameters:

nint, по умолчанию: 1

Количество кликов мыши для накопления. Если отрицательное, накапливать клики до тех пор, пока ввод не будет завершен вручную.

timeoutfloat, по умолчанию: 30 секунд

Количество секунд ожидания до истечения времени. Если равно нулю или отрицательно, таймаут никогда не наступит.

show_clicksbool, по умолчанию: True

Если True, отображать красный крест в месте каждого клика.

mouse_addMouseButton или None, по умолчанию: MouseButton.LEFT

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

mouse_popMouseButton или None, по умолчанию: MouseButton.RIGHT

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

mouse_stopMouseButton или None, по умолчанию: MouseButton.MIDDLE

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

Returns:

list of tuples

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

Notes

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

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

Интерактивные функции

Интерактивные функции