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

Переключить текущее состояние режима удержания.

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

Чтобы проверить текущее состояние режима удержания, используйте функцию ishold.

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

: tf = ishold

: tf = ishold (hax)

: tf = 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 (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

: status = close (…)

Закрыть окно(а) фигуры.

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

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

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

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

Если запрошен необязательный выходной аргумент status, Octave возвращает 1, если окна фигур были успешно закрыты.

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

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

: closereq ()

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

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

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