MATLAB.Exponenta
–Û·Ë͇ Matlab&Toolboxes

Приложения с GUI и дескрипторная графика

Дескрипторная графика

Справочник свойств графических объектов

Справочная система MatLab включает браузер свойств графических объектов: Handle Graphics Property Browser. Выбор этого раздела приводит к отображению в правой части окна справочной системы названий объектов и части иерархической структуры. Названия объектов и элементы структуры являются гиперссылками, щелчок по нужной гиперссылке, скажем Axes, приводит к отображению названий свойств и их значений для выбранного графического объекта. Названия свойств выводятся в столбик и так же являются гиперссылками. Они служат для быстрого просмотра описания свойств и их возможных значений.

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

Объект Axes (оси)

Цветовое оформление осей и размещаемых на них объектов

XColor, YColor, ZColor - цвет оси и шрифта разметки для осей x, y, z, соответственно. Значения:

·   один из предопределенных цветов: 'r' (красный), 'g' (зеленый), 'b' (синий), 'c' (циан), 'm' (магента), 'y' (желтый), 'k' (черный), 'w' (белый);

·   цвет в формате RGB, задаваемый вектором из трех элементов [R G B], причем R,G,B могут меняться от 0 до 1 для задания интенсивности, например [1 0 0] соответствует предопределенному цвету 'r', а [0.9 0.9 0.9] - светло-серому.

 

Color - цвет фона осей. Значения:

·   'none' делает оси прозрачными, становится видимой часть графического окна под осями;

·   один из предопределенных цветов или цвет в формате RGB (см. свойство XColor).

 

ColorOrder - порядок выбора цвета при добавлении линий функциями plot и plot 3 на оси. Это свойство принимается во внимание, только если цвет линии не задан во входных аргументах plot или plot3. Значением ColorOrder должна быть матрица размера m x 3, каждая строка которой задает цвет в формате RGB. При добавлении первой линии цвет определяется первой строкой матрицы, при добавлении второй - второй строкой. После достижении последней строки происходит переход к первой и новый проход по строкам. После определения собственного порядка выбора цвета, следует установить свойство осей NextPlot в значение 'replacechildren'.

Пример, в котором линии выводятся оттенками красного цвета:

C = 1./(1:0.05:1.4)';

C(:,2:3) = 0;

axes('ColorOrder', C, 'NextPlot', 'replacechildren')

plot(rand(10))

 

AmbientLightColor - цвет рассеянного света, который присутствует, только при наличии хотя бы одного источника света (потомка осей). Значение  - одно из сокращений для цвета или цвет в формате RGB.

 

Шрифт разметки и подписей к осям

FontAngle - наклон шрифта. Значения:

·   'normal' - прямой (по умолчанию);

·   'italic' и 'oblique' - наклонный.

 

FontName - имя одного из шрифтов, установленных на компьютере, например: 'Arial Narrow'. Для задания моноширинного шрифта - 'FixedWidth'. При установке значения этому свойству, автоматически изменяется только шрифт разметки осей, а автоматического изменения шрифта подписей к осям не происходит. Для их обновления следует заново задать подписи, воспользовавшись свойствами XLabel, YLabel и ZLabel, или соответствующими командами высокоуровневой графики xlabel, ylabel, zlabel.

 

FontSize - размер шрифта (по умолчанию 12) в единицах измерения, заданных свойством FontUnits (по умолчанию пункты). Значением может быть целое число, большее нуля. Аналогично со свойством FontName, при установке значения свойству FontSize, не происходит автоматического изменения шрифта подписей к осям. Для их обновления следует заново задать подписи, воспользовавшись свойствами XLabel, YLabel и ZLabel, или соответствующими командами высокоуровневой графики xlabel, ylabel, zlabel.

 

FontUnits - единицы измерения размера шрифта. Значения:

·   'points' - пункты (по умолчанию);

·   'normalized' - нормализованные, т.е. доля от высоты осей, а высота осей принимается равной единице;

·   'inches' - дюймы;

·   'centimeters' - сантиметры

·   'pixels' - пиксели.

 

FontWeight - толщина шрифта. Значения:

·   'normal' - обычный;

·   'bold' - жирный;

·   'demi' - полужирный;

·   'light' - тонкий.

Аналогично со свойством FontName, при установке значения свойству FontWeight, не происходит автоматического изменения шрифта подписей к осям. Для их обновления следует заново задать подписи, воспользовавшись свойствами XLabel, YLabel и ZLabel, или соответствующими командами высокоуровневой графики xlabel, ylabel, zlabel.

 

Масштаб

 

XScale, YScale, ZScale - масштаб каждой из осей. Значения:

·   'linear' - линейный (по умолчанию).

·   'log' - логарифмический.

Разметка осей

 

TickDirMode - режим выбора направления штрихов разметки осей. Значения:

·   'auto'  - автоматический выбор (по умолчанию), при котором штрихи направлены внутрь для двумерных осей и наружу для двумерных;

·   'manual' - направление определяется значением свойства TickDir.

 

TickDir - направление штрихов разметки осей. Значения:

·   'in' - внутрь осей;

·   'out' - наружу.

Задание этого свойства приводит к автоматической установке TickDirMode в 'maunal'.

 

TickLength - длина штрихов разметки осей. Значение: вектор из двух элементов, первая компонента которого определяет длину штрихов для двумерных осей, а вторая - для трехмерных. Длина штрихов задается в долях от самой длинной оси из x, y или z.

 

XTickMode, YTickMode, ZTickMode - способ выбора координат разметки осей x, y и z. Значения:

·   'auto' - автоматически (по умолчанию);

·   'manual' - координаты разметки определяются значениями свойств XTick, YTick или ZTick.

 

XTick, YTick, ZTick  - координаты разметки осей. Значение:

·   вектор, содержащий упорядоченные по возрастанию значения координат.

·   пустой массив [] для скрытия разметки.

Задание значения этим свойствам приводит к автоматической установке TickDirMode в 'maunal'.

 

XTickLabelMode, YTickLabelMode, ZTickLabelMode - способ выбора подписей к разметке.

·   auto - размещаются числовые значения (по умолчанию);

·   manual - используются значения, заданные при помощи свойств XTickLabel, YTickLabel и ZTickLabel.

 

XTickLabel, YTickLabel, ZTickLabel - подписи к штрихам разметки осей. Существует несколько способов их задания:

·   вектором из чисел, которые будут автоматически преобразованы в строки;

·   строкой, в которой для разделения подписей ставится знак вертикальной черты |;

·   массивом строк;

·   массивом ячеек, содержащим строки.

При выборе любого из способов желательно следить за совпадением числа подписей и значений координат разметки, установленных в свойствах XTick, YTick и ZTick. Если подписей меньше, чем координат, то они используются снова, начиная с первой. Формулы в TeX не интерпретируются.

Пример:

x = -pi:pi/30:pi;

y = sin(x);

hA = axes;

plot(x, y)

set(hA, 'XTick', [-pi/2 0 pi/2])

set(hA, 'XTickLabel', {'min'; 'zero'; 'max'})

set(hA, 'XGrid', 'on')

 

 

Основная и вспомогательная сетки

XGrid, YGrid, ZGrid - отображение линий основной сетки, перпендикулярных оси x, y или z, соответственно. Значения: 'on', или 'off' (по умолчанию). Координаты линий сетки совпадают с координатами разметки, определяемыми значениями свойств XTick, YTick, ZTick и XTickMode, YTickMode и ZTickMode. Для отображения линий сетки должна быть включена разметка оси.

 

GridLineStyle - стиль линий основной сетки. Значения:

·   '-' - сплошная линия;

·   '--' - штриховая линия;

·   ':' -пунктирная линия (по умолчанию);

·   '-.' - штрих-пунктирная линия.

 

XMinorGrid, YMinorGrid, ZMinorGrid - отображение линий вспомогательной сетки, перпендикулярных оси x, y или z, соответственно. Значения: 'on', или 'off' (по умолчанию). Координаты линий сетки совпадают с координатами дополнительной разметки, которые выбираются автоматически. Для отображения линий вспомогательной сетки не обязательно устанавливать соответствующее свойство XMinorTick, YMinorTick или ZMinorTick в 'on', т.е. дополнительная разметка оси может быть скрыта.

MinorGridLineStyle - стиль линий вспомогательной сетки. Значения те же, что у свойства GridLineStyle.

 

Layer - размещение линий сетки (а так же штрихов разметки и линий осей) поверх или за отображаемыми объектами. Значения:

·   'bottom' - линии сетки находятся за объектами (по умолчанию);

·   'top' - линии сетки расположены поверх объектов.

Пример:

hA=axes

set(hA,'Xgrid','on','YGrid','on')

x=[-1 0 1];

y=[0 1 0];

patch(x,y,'g')

set(hA,'Layer','top')

Пределы осей

 

XLimMode, YLimMode, ZLimMode - способ выбора пределов осей:

·   'auto' - автоматический выбор в зависимости от предельных значений визуализируемых данных.

·   'manual' - пределы осей определяются значением соответствующих свойств XLim, YLim и ZLim.

 

XLim, YLim, ZLim - пределы каждой их осей. Значение: вектор из двух элементов (по умолчанию [0 1]).

 

Толщина осей и рамка

 

LineWidth - толщина линий осей в пунктах (0.5 по умолчанию).

 

Box - наличие рамки вокруг осей. Значения:

·   'on' - рисовать рамку;

·   'off' - скрыть (по умолчанию).

Управление положением осей

 

XAxisLocation  - положение оси абсцисс. Значения:

·   'top' - вверху;

·   'bottom' - внизу (по умолчанию).

 

YAxisLocation - положение оси ординат. Значения:

·   'right' - справа;

·   'left' - слева (по умолчанию).

 

XDir, YDir, ZDir - направление координатных осей. Значения:

·   'normal' - обычное (по умолчанию);

·   'reverse' - в обратном направлении.

Обычное направление осей таково: ось x направлена слева направо, y - сверху вниз (на двумерных осях) и от наблюдателя (на трехмерных), ось z - снизу вверх.

 

 

Units - единицы измерения для задания положения осей в графическом окне. Значения:

·   'inches' - дюймы;

·   'centimeters' - сантиметры;

·   'normalized' - нормализованные (по умолчанию), нижний левый угол окна имеет координаты (0,0), а правый верхний - (1, 1);

·   'points' - пункты;

·   'pixels' - пиксели;

·   'characters' - символы, ширина символа x системного шрифта, высота между строками текста.

 

Position - положение осей в графическом окне. Значение: вектор из четырех элементов [x y width height], задающий координаты левого нижнего угла осей, их ширину и высоту в единицах, указанных в свойстве Units. Если при помощи свойств PlotBoxAspectRatioMode и PlotBoxAspectRatio задано соотношение осей, то оси занимают максимально возможную часть выделенной для них прямоугольной области.

 

OuterPosition - положение прямоугольника, содержащего оси, подписи к ним и заголовок, в графическом окне. Значение: вектор из четырех элементов [x y width height], задающий координаты левого нижнего угла осей, их ширину и высоту в единицах, указанных в свойстве Units. Если при помощи свойств PlotBoxAspectRatioMode и PlotBoxAspectRatio задано соотношение осей, то оси занимают максимально возможную часть выделенной для них прямоугольной области.

 

ActivePositionProperty - способ изменения размеров осей при изменении размеров графического окна. Значения:

·   'outerposition' - на основе значения свойства OuterPosition (по умолчанию);

·   'position' - на основе значения свойства Position;

 

TightInset - размеры полей вокруг осей, которые служат для размещения заголовка и подписей к осям. Это свойство доступно только для чтения. Его значением является вектор из четырех элементов [left bottom right top], определяющих ширину левого поля, высоту нижнего, ширину правого и высоту верхнего соответственно. Данные значения добавляются к указанным в свойстве Position.

 

PlotBoxAspectRatioMode - способ выбора соотношения размеров осей. Значения

·   'auto' - автоматический (по умолчанию);

·   'manual' - соотношение размеров определяется значением свойства PlotBoxAspectRatio.

 

PlotBoxAspectRatio - относительные размеры осей x, y и z. Значение: вектор из трех элементов [px py pz], задающий относительные размеры, например [1 1 1] для равных размеров по всем трем координатным осям. Это свойство связано с рядом других (см. таблицу).

 

DataAspectRatioMode - способ выбора соотношения масштабов осей. Значения

·   'auto' - автоматический (по умолчанию);

·   'manual' - соотношение масштабов определяется значением свойства DataAspectRatio.

 

DataAspectRatio - относительные масштабы осей x, y и z. Значение: вектор из трех элементов [dx dy dz], задающий относительные масштабы, например [1 1 1] для равных масштабов по всем трем координатным осям. Это свойство связано с рядом других (см. таблицу).

 

Таблица. Связь свойств, отвечающих за размеры осей.

Пределы осей x, y и z

Соотношение масштабов осей

Соотношение пределов осей

Результат

автоматически

XLimMode='auto'

YLimMode='auto'

ZLimMode='auto'

автоматически

DataAspectRatioMode=

'auto'

автоматически

PlotBoxAspectRatioMode=

'auto'

Автоматический подбор размеров с учетом границ значений данных

автоматически

XLimMode='auto'

YLimMode='auto'

ZLimMode='auto'

автоматически

DataAspectRatioMode=

'auto'

определяются свойством

PlotBoxAspectRatioMode при

PlotBoxAspectRatioMode=

'manual'

Автоматический подбор размеров с учетом границ значений данных. Значение DataAspectRatio изменяется с учетом заданного значения PlotBoxAspectRatio и автоматически выбранных пределов осей.

автоматически

XLimMode='auto'

YLimMode='auto'

ZLimMode='auto'

определяются свойством

DataAspectRatio при

DataAspectRatioMode=

'manual'

автоматически

PlotBoxAspectRatioMode=

'auto'

Автоматический подбор размеров с учетом границ значений данных. Значение PlotBoxAspectRatio изменяется с учетом заданного значения

DataAspectRatio и автоматически выбранных пределов осей.

автоматически

XLimMode='auto'

YLimMode='auto'

ZLimMode='auto'

определяются свойством

DataAspectRatio при

DataAspectRatioMode=

'manual'

определяются свойством

PlotBoxAspectRatioMode при

PlotBoxAspectRatioMode=

'manual'

Автоматический подбор размеров с учетом границ значений данных относительных масштабов и относительных размеров осей.

определяются свойствами

XLim, YLim,

ZLim

при XLimMode='auto'

YLimMode='auto'

ZLimMode='auto'

автоматически

DataAspectRatioMode=

'auto'

автоматически

PlotBoxAspectRatioMode=

'auto'

Автоматический подбор размеров с учетом границ значений данных

определяются свойствами

XLim, YLim,

ZLim

при

XLimMode='auto'

YLimMode='auto'

ZLimMode='auto'

автоматически

DataAspectRatioMode=

'auto'

определяются свойством

PlotBoxAspectRatioMode при

PlotBoxAspectRatioMode=

'manual'

При подборе размеров учитываются пределы и соотношение размеров осей

определяются свойствами

XLim, YLim,

ZLim

при

XLimMode='auto'

YLimMode='auto'

ZLimMode='auto'

определяются свойством

DataAspectRatio при

DataAspectRatioMode=

'manual'

автоматически

PlotBoxAspectRatioMode=

'auto'

При подборе размеров учитываются пределы и соотношение масштабов осей

Пределы по одной из осей, к примеру x, указаны в XLim,

а YLimMode='auto'

ZLimMode='auto'

определяются свойством

DataAspectRatio при

DataAspectRatioMode=

'manual'

определяются свойством

PlotBoxAspectRatioMode при

PlotBoxAspectRatioMode=

'manual'

При подборе размеров учитываются пределы и соотношение масштабов и размеров осей

 

Заданы пределы по двум или трем осям, к примеру x и y, указаны в XLim и YLim,

ZLimMode='auto'

определяются свойством

DataAspectRatio при

DataAspectRatioMode=

'manual'

определяются свойством

PlotBoxAspectRatioMode при

PlotBoxAspectRatioMode=

'manual'

Значение PlotBoxAspectRatio игнорируется


Поиск по сайту:

Система Orphus

Яндекс.Метрика