15.2.10 Взаимодействие с графиками ¶

Пользователь может выбрать точки на графике с помощью функции ginput или выбрать позицию для размещения текста на графике с помощью функции gtext с помощью мыши.

: [x, y, buttons] = ginput (n) ¶

: [x, y, buttons] = ginput () ¶

Возвращает положение и тип нажатий кнопок мыши и/или нажатий клавиш в текущем окне фигуры.

Если n определено, то захватываются n событий перед возвратом. Когда n не определено ginput цикл продолжается до тех пор, пока не будет нажата клавиша возврата RET.

Возвращаемые значения x, y — координаты, где была нажата мышь, в единицах текущей оси. Возвращаемое значение button равно 1, 2 или 3 для левой, средней или правой кнопки мыши. Если нажата клавиша, её ASCII-код возвращается в button.

Примечание по реализации: ginput предназначена для 2D-графиков. Для 3D-графиков см. свойство currentpoint текущей оси, которое можно преобразовать в единицы данных, зная текущие view.

См. также: gtext, waitforbuttonpress.

: b = waitforbuttonpress () ¶

Ожидает нажатия кнопки мыши или клавиши в текущем окне фигуры.

Возвращаемое значение b равно 0, если была нажата кнопка мыши, или 1, если была нажата клавиша.

См. также: waitfor, ginput, kbhit.

: gtext (s) ¶

: gtext ({s1, s2, …}) ¶

: gtext ({s1; s2; …}) ¶

: gtext (…, prop, val, …) ¶

: h = gtext (…) ¶

Размещение текста на текущей фигуре с помощью мыши.

Строковый аргумент s может быть массивом символов или массивом ячеек строк. Если s имеет более одной строки, каждая строка используется для создания отдельного текстового объекта после нажатия кнопки мыши. Например:

Размещение одной строки после одного нажатия мыши

gtext ("I clicked here")

Размещение двух строк после двух нажатий мыши

gtext ({"I clicked here"; "and there"})

Размещение двух строк, каждая с двумя строками, после двух нажатий мыши

gtext ({"I clicked", "here"; "and", "there"})

Дополнительные пары property/value передаются непосредственно подлежащим текстовым объектам.

Полный список свойств текстовых объектов описан в Свойствах текста.

Необязательное возвращаемое значение h содержит дескриптор(ы) графического объекта(ов) созданного(ых) текстового(ых) объекта(ов).

См. также: ginput, text.

Более сложные механизмы взаимодействия с пользователем могут быть получены с помощью функций ui*, см. Элементы пользовательского интерфейса.