5.10 Легенда

Эти функции обеспечивают рисование легенды графика (полезно для 1D plotting). Запись в легенде состоит из двух строк: одна для стиля линии и маркеров, другая с текстом описания (с включенным разбором TeX-их команд). Можно использовать непосредственно массивы строк, или накопление во внутренние массивы с помощью функции AddLegend() с последующим отображением. Положение легенды можно задать автоматически или вручную. Параметры fnt и size задают стиль и размер шрифта (см. Font settings). Опция value задает зазор между примером линии и текстом (по умолчанию 0.1). Опция size задает размер текста. Если стиль линии пустой, то соответствующий текст печатается без отступа. Строка fnt может содержать:

• стиль текста для записей;
• ‘A’ для расположения относительно всего рисунка, а не текущего subplot;
• ‘^’ для размещения снаружи от указанных координат;
• ‘#’ для вывода прямоугольника вокруг легенды;
• ‘-’ для горизонтального расположения записей;
• цвета для заливки (1-ый), для границы (2-ой) и для текста записей (3-ий). Если указано меньше трех цветов, то цвет границы черный (для 2 и менее цветов), и цвет заливки белый (для 1 и менее цвета).

См. раздел Legend sample, для примеров кода и графика.

Команда MGL: legend [pos=3 'fnt'='#']

Метод класса mglGraph: void Legend (int pos=0x3, const char *fnt="#", const char *opt="")

Функция С: void mgl_legend (HMGL gr, int pos, const char *fnt, const char *opt)

Рисует легенду из накопленных записей шрифтом fnt. Параметр pos задает положение легенды: ‘0’ – в нижнем левом углу, ‘1’ – нижнем правом углу, ‘2’ – верхнем левом углу, ‘3’ – верхнем правом углу (по умолчанию). Опция value задает зазор между примером линии и текстом (по умолчанию 0.1).

Команда MGL: legend x y ['fnt'='#']

Метод класса mglGraph: void Legend (mreal x, mreal y, const char *fnt="#", const char *opt="")

Функция С: void mgl_legend_pos (HMGL gr, mreal x, mreal y, const char *fnt, const char *opt)

Рисует легенду из накопленных записей шрифтом fnt. Положение легенды задается параметрами x, y, которые полагаются нормированными в диапазоне [0,1]. Опция value задает зазор между примером линии и текстом (по умолчанию 0.1).

Команда MGL: addlegend 'text' 'stl'

Метод класса mglGraph: void AddLegend (const char *text, const char *style)

Метод класса mglGraph: void AddLegend (const wchar_t *text, const char *style)

Функция С: void mgl_add_legend (HMGL gr, const char *text, const char *style)

Функция С: void mgl_add_legendw (HMGL gr, const wchar_t *text, const char *style)

Добавляет описание text кривой со стилем style (см. Line styles) во внутренний массив записей легенды.

Команда MGL: clearlegend

Метод класса mglGraph: void ClearLegend ()

Функция С: void mgl_clear_legend (HMGL gr)

Очищает внутренний массив записей легенды.

Команда MGL: legendmarks val

Метод класса mglGraph: void SetLegendMarks (int num)

Функция С: void mgl_set_legend_marks (HMGL gr, int num)

Задает число маркеров в легенде. По умолчанию используется 1 маркер.