15.2.7 Управление окнами графиков

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

drawnow ()

drawnow ("expose")

drawnow (term, file, debug_file)

Обновить окна фигур и их дочерние элементы.

Очередь событий очищается, и выполняются все сгенерированные обратные вызовы.

С необязательным аргументом "expose", обновляются только графические объекты, и другие события или обратные вызовы не обрабатываются.

Третья форма вызова drawnow предназначена для отладки и не документирована.

См. также: refresh.

Будут обновлены только измененные фигуры. Функция refresh также может быть использована для обновления текущей фигуры, даже если она не была изменена.

refresh ()

refresh (h)

Обновить фигуру, заставив её перерисоваться.

При вызове без аргумента перерисовывается текущая фигура. В противном случае, перерисовывается фигура с графическим идентификатором h.

См. также: drawnow.

Обычно функции высокого уровня для построения графиков, такие как plot или mesh, вызывают newplot, чтобы определить, нужно ли инициализировать состояние целевых осей (по умолчанию) или последующие графики должны быть наложены поверх предыдущих. Чтобы наложить два графика друг на друга, используйте функцию hold или вручную измените свойство осей nextplot. Например,

hold on;
x = -10:0.1:10;
plot (x, sin (x));
plot (x, cos (x));
hold off;

отображает синусоиду и косинусоиду на тех же осях. Если режим отображения выключен, последовательные команды построения графиков, подобные этому, отобразят только последний график.

newplot ()

newplot (hfig)

newplot (hax)

hax = newplot (…)

Подготовить графический движок для построения нового графика.

Эта функция вызывается в начале всех функций высокого уровня для построения графиков. Обычно в пользовательских программах она не требуется. newplot проверяет поле "NextPlot" текущей фигуры и осей, чтобы определить, что делать.

Свойство NextPlot фигуры	Действие
"new"	Создать новую фигуру и сделать её текущей.
"add" (по умолчанию)	Добавить новые графические объекты в текущую фигуру.
"replacechildren"	Удалить дочерние объекты, у которых HandleVisibility установлено в "on". Установить свойство NextPlot в "add". Обычно это очищает фигуру, но оставляет скрытые объекты, такие как меню. Это эквивалентно clf.
"replace"	Удалить все дочерние объекты фигуры и сбросить все свойства фигуры до значений по умолчанию. Однако следующие четыре свойства не сбрасываются: Position, Units, PaperPosition, PaperUnits. Это эквивалентно clf reset.

Свойство NextPlot осей	Действие
"add"	Добавить новые графические объекты в текущие оси. Это эквивалентно hold on.
"replacechildren"	Удалить дочерние объекты, у которых HandleVisibility установлено в "on", но оставить свойства осей без изменений. Это обычно очищает график, но сохраняет такие специальные настройки, как логарифмическое масштабирование осей. Это эквивалентно cla.
"replace" (по умолчанию)	Удалить все дочерние объекты осей и сбросить все свойства осей до значений по умолчанию. Однако следующие свойства не сбрасываются: Position, Units. Это эквивалентно cla reset.

Если указан необязательный вход hfig или hax, то подготавливается указанная фигура или оси, а не текущая фигура и оси.

Необязательное возвращаемое значение hax — это графический идентификатор созданного объекта осей (а не фигуры).

Внимание: Вызов newplot может изменить текущую фигуру и текущие оси.

hold

hold on

hold off

hold (hax, …)

Переключить или установить состояние "hold" графического движка, которое определяет, добавляются ли новые графические объекты к графику или заменяют существующие.

hold on

Сохранить данные и настройки графика, чтобы последующие команды построения графиков отображались на одном графике. Цвет и стиль линии увеличиваются для каждого нового наложенного графика.

hold all (deprecated)

Эквивалентно hold on.

hold off

Восстановить настройки графика по умолчанию, которые очищают график и сбрасывают свойства осей перед каждой новой командой построения графика (по умолчанию).

hold

Переключить текущее состояние hold.

При добавлении дополнительного аргумента hax, состояние hold изменяется для этой оси, а не для текущей оси, возвращаемой функцией gca.

Для запроса текущего состояния hold используйте функцию ishold.

См. также: ishold, cla, clf, newplot.

ishold

ishold (hax)

ishold (hfig)

Возвращает true, если следующий график будет добавлен к текущему, или false, если графический вывод будет очищен перед построением следующего графика.

Если первым аргументом является идентификатор осей hax или фигуры hfig, то операция выполняется с этим графиком, а не с текущим.

См. также: hold, newplot.

Чтобы очистить текущую фигуру, вызовите функцию clf. Чтобы очистить текущую ось, вызовите функцию cla. Чтобы вывести текущую фигуру наверх стека окон, вызовите функцию shg. Чтобы удалить графический объект, вызовите delete для его индекса. Чтобы закрыть окно фигуры, вызовите функцию close.

clf

clf reset

clf (hfig)

clf (hfig, "reset")

h = clf (…)

Очистить текущее окно фигуры.

clf выполняет операцию путём удаления графических объектов-потомков с видимыми идентификаторами (HandleVisibility = "on").

Если необязательный аргумент "reset" указан, удаляются все дочерние объекты, включая те, у которых идентификаторы скрыты, и все свойства фигуры сбрасываются до значений по умолчанию. Однако следующие свойства не сбрасываются: Position, Units, PaperPosition, PaperUnits.

Если первый аргумент hfig является идентификатором фигуры, то операция выполняется с этой фигурой, а не с текущей фигурой, возвращаемой функцией gcf.

Необязательное возвращаемое значение h — это графический идентификатор очищенного окна фигуры.

См. также: cla, close, delete, reset.

cla

cla reset

cla (hax)

cla (hax, "reset")

Очистить текущий или указанный (hax) объект осей.

cla выполняется путём удаления графических объектов-потомков с видимыми идентификаторами (HandleVisibility = "on"). Это обычно очищает оси от любых визуальных объектов, но оставляет пределы осей, деления и подписи, вид камеры и т. д. Кроме того, автоматическая окраска и стилизация линий сбрасываются путём изменения свойств осей ColorOrderIndex, LinestyleOrderIndex до 1.

Если необязательный аргумент "reset" указан, удаляются все дочерние объекты, включая те, у которых идентификаторы скрыты, и все свойства осей сбрасываются до значений по умолчанию. Однако следующие свойства не сбрасываются: Position, Units.

Если первый аргумент hax — идентификатор осей, то операция выполняется с этими осями, а не с текущими осями, возвращаемыми функцией gca.

См. также: clf, delete, reset.

shg

Показать окно графика.

Эта функция делает текущую фигуру видимой и помещает её поверх всех других окон графиков.

Примечание по программированию: shg эквивалентно figure (gcf), предполагая, что существует текущая фигура.

См. также: figure, drawnow, gcf.

delete (file)

delete (file1, file2, …)

delete (handle)

Удалить указанный файл или графический идентификатор.

file может содержать шаблоны подстановки, такие как ‘*’. В одном вызове функции можно указать несколько файлов для удаления.

handle может быть скаляром или вектором графических идентификаторов для удаления.

Примечание по программированию: удаление графических объектов — это правильный способ удаления элементов из графика без очистки всей фигуры.

См. также: clf, cla, unlink, rmdir.

close

close (h)

close figname

close all

close all hidden

close all force

Закрытие окна(ок) графиков.

При вызове без аргументов, закрывает текущий график. Это эквивалентно close (gcf). Если входной h это дескриптор графического объекта или вектор дескрипторов графических объектов, то закрывает каждый график в h. График для закрытия может быть также задан именем figname, которое сопоставляется со свойством "Name" всех графиков.

Если аргумент "all" задан, то закрываются все графики с видимыми дескрипторами (HandleVisibility = "on")

Если дополнительно задан аргумент "hidden", то закрываются все графики, включая скрытые.

Если дополнительно задан аргумент "force", то графики закрываются даже в тех случаях, когда "closerequestfcn" было изменено, чтобы предотвратить закрытие окна.

Примечание к реализации: close работает путём установки дескриптора h в текущий график и затем вызова функции, указанной свойством "closerequestfcn" графика. По умолчанию используется функция closereq. Возможны ситуации, когда вызываемая функция отложит или прервёт удаление графика. Чтобы удалить график без выполнения каких-либо функций обратного вызова, используйте delete. При написании функции обратного вызова для закрытия окна не используйте close, чтобы избежать рекурсии.

См. также: closereq, delete.

closereq ()

Закрывает текущий график и удаляет все графические объекты, связанные с ним.

По умолчанию свойство "closerequestfcn" нового графического окна указывает на эту функцию.

См. также: close, delete.