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_add
MouseButtonили None, по умолчанию:MouseButton.LEFT -
Кнопка мыши для добавления точек.
-
mouse_pop
MouseButtonили None, по умолчанию:MouseButton.RIGHT -
Кнопка мыши для удаления последней добавленной точки.
-
mouse_stop
MouseButtonили None, по умолчанию:MouseButton.MIDDLE -
Кнопка мыши для остановки ввода.
- Возвращает:
-
- список кортежей
-
Список координат щелчков (x, y).
Примечания
Клавиатура также может использоваться для выбора точек, если ваша мышь не имеет одной или нескольких кнопок. Кнопки delete и backspace действуют как щелчок правой кнопкой мыши (т.е. удаляют последнюю точку), кнопка Enter завершает ввод, а любая другая кнопка (не используемая менеджером окон) выбирает точку.
Примеры использования matplotlib.pyplot.ginput
© 2012–2023 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.7.5/api/_as_gen/matplotlib.pyplot.ginput.html