15.3.3.4 Свойства легенды

Свойства объектов legend (см. легенду):

autoupdate: "off" | {"on"}

Управляет тем, обновляется ли количество элементов легенды автоматически при добавлении (или удалении) объектов на связанные оси. Например:

## Create a single plot with its legend.
figure ();
plot (1:10);
legend ("Slope 1");
## Add another plot and specify its displayname so that
## the legend is correctly updated.
hold on;
plot ((1:10) * 2, "displayname", "Slope 2");
## Stop automatic updates for further plots.
legend ("autoupdate", "off");
plot ((1:10) * 3);

box: "off" | {"on"}

Управляет наличием рамки вокруг легенды.

color: colorspec, def. [1 1 1]

Цвет фона легенды. См. colorspec.

edgecolor: colorspec, def. [0.1500 0.1500 0.1500]

Управляет цветом контура легенды.

fontangle: "italic" | {"normal"}

Управляет тем, является ли шрифт курсивом или нормальным.

fontname: строка, def. "*"

Имя шрифта, используемого для рендеринга текста. При установке этого свойства движок рендеринга текста будет искать соответствующий шрифт в вашей системе. Если он не найден, текст будет рендериться с использованием шрифта по умолчанию без засечек (такого же, как значение по умолчанию "*").

Примечание по программированию: В системах, которые не используют FontConfig напрямую (все кроме Linux), кэш шрифтов создаётся при установке Octave. После установки новых шрифтов необходимо вручную выполнить system ("fc-cache -fv").

fontsize: скаляр, def. 9

Размер шрифта, используемого для рендеринга текста. См. свойство fontunits.

fontunits: "centimeters" | "inches" | "normalized" | "pixels" | {"points"}

Единицы измерения, используемые для интерпретации свойства "fontsize".

fontweight: "bold" | {"normal"}

Управляет вариантом базового шрифта, используемого для рендеринга текста.

location: "best" | "bestoutside" | "east" | "eastoutside" | "none" | "north" | {"northeast"} | "northeastoutside" | "northoutside" | "northwest" | "northwestoutside" | "south" | "southeast" | "southeastoutside" | "southoutside" | "southwest" | "southwestoutside" | "west" | "westoutside"

Управление расположением легенды.

numcolumns: скалярный целочисленный, def. 1

Управление количеством столбцов, используемых в макете элементов легенды. Например:

figure ();
plot (rand (30));
legend ("numcolumns", 3);

Установка numcolumns также принудительно устанавливает свойство numcolumnsmode в значение "manual".

orientation: "horizontal" | {"vertical"}

Управляет тем, упорядочены ли элементы легенды вертикально (по столбцам) или горизонтально (по строкам).

position: четырехэлементный вектор

Указывает положение легенды без её заголовка. Четыре элемента вектора — координаты левого нижнего угла и ширина и высота легенды. Изменение этого свойства также переключает "location" на "none".

string: строка | массив строк

Список меток для элементов легенды. Например:

figure ();
plot (rand (20));
## Let legend choose names automatically
hl = legend ();
## Selectively change some names
str = get (hl, "string");
str(1:5:end) = "Garbage";
set (hl, "string", str);

textcolor: colorspec, def. [0 0 0]

Управляет цветом текстовых строк для элементов легенды.

title: графический дескриптор

Графический дескриптор объекта заголовка текста.

units: "centimeters" | "characters" | "inches" | {"normalized"} | "pixels" | "points"

Единицы измерения, используемые для интерпретации свойства "position".