Spec-Zone.ru › Matplotlib 3.3

matplotlib.pyplot.ginput

matplotlib.pyplot.ginput(n=1, timeout=30, show_clicks=True, mouse_add=<MouseButton.LEFT: 1>, mouse_pop=<MouseButton.RIGHT: 3>, mouse_stop=<MouseButton.MIDDLE: 2>) [source]

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

Ожидает, пока пользователь n раз кликнет по фигуре, и возвращает координаты каждого клика в списке.

Существует три возможных взаимодействия:

  • Добавить точку.
  • Удалить последнюю добавленную точку.
  • Остановит взаимодействие и вернёт добавленные до этого точки.

Действия присваиваются кнопкам мыши через аргументы mouse_add, mouse_pop и mouse_stop.

Параметры:
nint, default: 1

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

timeoutfloat, default: 30 seconds

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

show_clicksbool, default: True

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

mouse_addMouseButton or None, default: MouseButton.LEFT

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

mouse_popMouseButton or None, default: MouseButton.RIGHT

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

mouse_stopMouseButton or None, default: MouseButton.MIDDLE

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

Возвращает:
список кортежей

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

Примечания

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

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

Interactive functions

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

© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.3.3/api/_as_gen/matplotlib.pyplot.ginput.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API