5.9 Оси и Colorbar

Эти функции рисуют объекты для "измерения" типа осей координат, цветовой таблицы (colorbar), сетку по осям, обрамляющий параллелепипед и подписи по осям координат. См. также см. Настройки осей координат.

Команда MGL: axis ['dir'='xyz' 'stl'='']
Метод класса mglGraph: void Axis (const char *dir="xyz", const char *stl="", const char *opt="")
Функция С: void mgl_axis (HMGL gr, const char *dir, const char *stl, const char *opt)

Рисует оси координат и метки на них (см. Настройки осей координат) в направлениях ‘xyz’, указанных строкой dir. Строка dir может содержать:

  • xyz’ для рисования соответствующих осей;
  • XYZ’ для рисования соответствующих осей с метками с другой стороны;
  • ~’ или ‘_’ для осей без подписей;
  • U’ для невращаемых подписей;
  • ^’ для инвертирования положения по умолчанию;
  • !’ для отключения улучшения вида меток (см. tuneticks);
  • AKDTVISO’ для вывода стрелки на конце оси;
  • a’ для принудительной автоматической расстановки меток;
  • :’ для рисования линий через точку (0,0,0);
  • f’ для вывода чисел в фиксированном формате;
  • E’ для вывода ‘E’ вместо ‘e’;
  • F’ для вывода в формате LaTeX;
  • +’ для вывода ‘+’ для положительных чисел;
  • -’ для вывода обычного ‘-’;
  • 0123456789’ для задания точности при выводе чисел.

Стиль меток и оси(ей) задается строкой stl. Опция value задает угол вращения меток оси. См. раздел Axis and ticks, для примеров кода и графика.

Команда MGL: colorbar ['sch'='']
Метод класса mglGraph: void Colorbar (const char *sch="", const char *opt="")
Функция С: void mgl_colorbar (HMGL gr, const char *sch, const char *opt)

Рисует полосу соответствия цвета и числовых значений (colorbar) для цветовой схемы sch (используется текущая для sch="") с краю от графика. Строка sch также может содержать:

  • <>^_’ для расположения слева, справа, сверху или снизу соответственно;
  • I’ для расположения около осей (по умолчанию, на краях subplot);
  • A’ для использования абсолютных координат (относительно рисунка);
  • ~’ для colorbar без подписей;
  • !’ для отключения улучшения вида меток (см. tuneticks);
  • a’ для принудительной автоматической расстановки меток;
  • f’ для вывода чисел в фиксированном формате;
  • E’ для вывода ‘E’ вместо ‘e’;
  • F’ для вывода в формате LaTeX;
  • +’ для вывода ‘+’ для положительных чисел;
  • -’ для вывода обычного ‘-’;
  • 0123456789’ для задания точности при выводе чисел.

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

Команда MGL: colorbar vdat ['sch'='']
Метод класса mglGraph: void Colorbar (const mglDataA &v, const char *sch="", const char *opt="")
Функция С: void mgl_colorbar_val (HMGL gr, HCDT v, const char *sch, const char *opt)

Аналогично предыдущему, но для цветовой схемы без сглаживания с заданными значениями v. См. раздел Sample ‘contd, для примеров кода и графика.

Команда MGL: colorbar 'sch' x y [w=1 h=1]
Метод класса mglGraph: void Colorbar (const char *sch, mreal x, mreal y, mreal w=1, mreal h=1, const char *opt="")
Функция С: void mgl_colorbar_ext (HMGL gr, const char *sch, mreal x, mreal y, mreal w, mreal h, const char *opt)

Аналогично первому, но в произвольном месте графика {x, y} (полагаются в диапазоне [0,1]). Параметры w, h задают относительную ширину и высоту colorbar.

Команда MGL: colorbar vdat 'sch' x y [w=1 h=1]
Метод класса mglGraph: void Colorbar (const mglDataA &v, const char *sch, mreal x, mreal y, mreal w=1, mreal h=1, const char *opt="")
Функция С: void mgl_colorbar_val_ext (HMGL gr, HCDT v, const char *sch, mreal x, mreal y, mreal w, mreal h, const char *opt)

Аналогично предыдущему, но для цветовой схемы sch без сглаживания с заданными значениями v. См. раздел Sample ‘contd, для примеров кода и графика.

Команда MGL: grid ['dir'='xyz' 'pen'='B']
Метод класса mglGraph: void Grid (const char *dir="xyz", const char *pen="B", const char *opt="")
Функция С: void mgl_axis_grid (HMGL gr, const char *dir, const char *pen, const char *opt)

Рисует линии сетки в направлениях перпендикулярным dir. Если dir содержит ‘!’, то линии рисуются также и для координат под-меток. Шаг сетки такой же как у меток осей координат. Стиль линий задается параметром pen (по умолчанию – сплошная темно синяя линия ‘B-’).

Команда MGL: box ['stl'='k' ticks=on]
Метод класса mglGraph: void Box (const char *col="", bool ticks=true)
Функция С: void mgl_box (HMGL gr)
Функция С: void mgl_box_str (HMGL gr, const char *col, int ticks)

Рисует ограничивающий параллелепипед цветом col. Если col содержит ‘@’, то рисуются закрашенные задние грани. При этом первый цвет используется для граней (по умолчанию светло жёлтый), а последний для рёбер и меток.

Команда MGL: xlabel 'text' [pos=1]
Команда MGL: ylabel 'text' [pos=1]
Команда MGL: zlabel 'text' [pos=1]
Команда MGL: tlabel 'text' [pos=1]
Команда MGL: clabel 'text' [pos=1]
Метод класса mglGraph: void Label (char dir, const char *text, mreal pos=1, const char *opt="")
Метод класса mglGraph: void Label (char dir, const wchar_t *text, mreal pos=1, const char *opt="")
Функция С: void mgl_label (HMGL gr, char dir, const char *text, mreal pos, const char *opt)
Функция С: void mgl_labelw (HMGL gr, char dir, const wchar_t *text, mreal pos, const char *opt)

Выводит подпись text для оси dir=‘x’,‘y’,‘z’,‘t’,‘c’, где ‘t’ – “тернарная” ось t=1-x-y; ‘c’ – для цвета (следует вызывать после colorbar). Параметр pos задает положение подписи: при pos=0 – по центру оси, при pos>0 – около максимальных значений, при pos<0 – около минимальных значений. Опция value задает дополнительный сдвиг текста. See Вывод текста.