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 предназначена для двумерных графиков. Для трехмерных графиков используйте свойство 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*, см. Элементы пользовательского интерфейса.