5.5.1 Экспорт в файл

Эти функции экспортируют текущую картинку (кадр) в файл. Имя файла fname должно иметь соответствующее расширение. Параметр descr дает краткое описание картинки. Пока прозрачность поддерживается только для форматов PNG, SVG, OBJ и PRC.

Команда MGL: write ['fname'='']
Метод класса mglGraph: void WriteFrame (const char *fname="", const char *descr="")
Функция С: void mgl_write_frame (HMGL gr, const char *fname, const char *descr)

Экспортирует текущий кадр в файл fname с типом, определяемым по расширению. Параметр descr добавляет описание (может быть пустым). Если fname пустой, то используется имя ‘frame####.jpg’, где ‘####’ – текущий номер кадра и имя ‘frame’ определяется переменной plotid.

Команда MGL: bbox x1 y1 [x2=-1 y2=-1]
Метод класса mglGraph: void SetBBox (int x1=0, int y1=0, int x2=-1, int y2=-1)
Функция С: void mgl_set_bbox (HMGL gr, int x1, int y1, int x2, int y2)

Задает область изображения, которая будет сохранена в файл 2D формата. Если x2<0 (y2<0), то исходная ширина (высота) рисунка будет использована. Если x1<0 или y1<0 или x1>=x2|Width или y1>=y2|Height, то обрезания рисунка не будет.

Метод класса mglGraph: void WritePNG (const char *fname, const char *descr="", int compr="", bool alpha=true)
Функция С: void mgl_write_png (HMGL gr, const char *fname, const char *descr)
Функция С: void mgl_write_png_solid (HMGL gr, const char *fname, const char *descr)

Экспортирует текущий кадр в PNG файл. Параметры функции следующие: fname – имя файла, descr – описание файла, alpha – прозрачность фона. Если при компиляции MathGL не был определен флаг HAVE_PNG, то экспорт в файл не производится.

Метод класса mglGraph: void WriteJPEG (const char *fname, const char *descr="")
Функция С: void mgl_write_jpg (HMGL gr, const char *fname, const char *descr)

Экспортирует текущий кадр в JPEG файл. Параметры функции следующие: fname – имя файла, descr – описание файла. Если при компиляции MathGL не был определен флаг HAVE_JPEG, то экспорт в файл не производится.

Метод класса mglGraph: void WriteGIF (const char *fname, const char *descr="")
Функция С: void mgl_write_gif (HMGL gr, const char *fname, const char *descr)

Экспортирует текущий кадр в GIF файл. Параметры функции следующие: fname – имя файла, descr – описание файла. Если при компиляции MathGL не был определен флаг HAVE_GIF, то экспорт в файл не производится.

Метод класса mglGraph: void WriteBMP (const char *fname, const char *descr="")
Функция С: void mgl_write_bmp (HMGL gr, const char *fname, const char *descr)

Экспортирует текущий кадр в BMP файл. Параметры функции следующие: fname – имя файла, descr – описание файла.

Метод класса mglGraph: void WriteTGA (const char *fname, const char *descr="")
Функция С: void mgl_write_tga (HMGL gr, const char *fname, const char *descr)

Экспортирует текущий кадр в TGA файл. Параметры функции следующие: fname – имя файла, descr – описание файла.

Метод класса mglGraph: void WriteEPS (const char *fname, const char *descr="")
Функция С: void mgl_write_eps (HMGL gr, const char *fname, const char *descr)

Экспортирует текущий кадр в EPS файл, используя векторное представление графика. Вследствие чего не рекомендуется сохранять большие графики (поверхности, а особенно поверхности уровня) из-за большого размера файла. Хотя никаких внутренних ограничений на размер выходного файла нет. Для них лучше использовать растровый формат (например, PNG или JPEG). Параметры функции следующие: fname – имя файла, descr – описание файла. Если имя файла оканчивается на ‘z’ (например, ‘fname.eps.gz’), то файл автоматически архивируется в формате gzip. Отмечу, что формат EPS не поддерживает интерполяцию цвета, и картинка будет выглядеть как при использовании quality=1.

Метод класса mglGraph: void WriteBPS (const char *fname, const char *descr="")
Функция С: void mgl_write_eps (HMGL gr, const char *fname, const char *descr)

Экспортирует текущий кадр в EPS файл, используя растровое представление графика. Параметры функции следующие: fname – имя файла, descr – описание файла. Если имя файла оканчивается на ‘z’ (например, ‘fname.eps.gz’), то файл автоматически архивируется в формате gzip.

Метод класса mglGraph: void WriteSVG (const char *fname, const char *descr="")
Функция С: void mgl_write_svg (HMGL gr, const char *fname, const char *descr)

Экспортирует текущий кадр в SVG файл, используя векторное представление графика. Вследствие чего не рекомендуется сохранять большие графики (поверхности, а особенно поверхности уровня) из-за большого размера файла. Хотя никаких внутренних ограничений на размер выходного файла нет. Для них лучше использовать растровый формат (например, PNG или JPEG). Параметры функции следующие: fname – имя файла, descr – описание файла. Если имя файла оканчивается на ‘z’ (например, ‘fname.svgz’), то файл автоматически архивируется в формате gzip. Отмечу, что формат SVG не поддерживает интерполяцию цвета, и картинка будет выглядеть как при использовании quality=1.

Метод класса mglGraph: void WriteTEX (const char *fname, const char *descr="")
Функция С: void mgl_write_tex (HMGL gr, const char *fname, const char *descr)

Экспортирует текущий кадр в LaTeX файл (пакет Tikz/PGF), используя векторное представление графика. Вследствие чего не рекомендуется сохранять большие графики (поверхности, а особенно поверхности уровня) из-за большого размера файла. Хотя никаких внутренних ограничений на размер выходного файла нет. Для них лучше использовать растровый формат (например, PNG или JPEG). Параметры функции следующие: fname – имя файла, descr – описание файла. Отмечу, что сейчас отсутствует изменение размера текста (например, в subplot), что может приводить к неправильному положению надписей.

Метод класса mglGraph: void WritePRC (const char *fname, const char *descr="", bool make_pdf=true)
Функция С: void mgl_write_prc (HMGL gr, const char *fname, const char *descr, int make_pdf)

Экспортирует текущий кадр в PRC файл, используя векторное представление графика (см. http://en.wikipedia.org/wiki/PRC_%28file_format%29). Вследствие чего не рекомендуется сохранять большие графики (поверхности, а особенно поверхности уровня) из-за большого размера файла. Хотя никаких внутренних ограничений на размер выходного файла нет. Для них лучше использовать растровый формат (например, PNG или JPEG). Параметры функции следующие: fname – имя файла, descr – описание файла. Если параметр make_pdf=true и PDF был выбран при конфигурировании MathGL, то также создается соответствующий PDF файл с 3D изображением.

Метод класса mglGraph: void WriteOBJ (const char *fname, const char *descr="")
Функция С: void mgl_write_obj (HMGL gr, const char *fname, const char *descr)

Экспортирует текущий кадр в OBJ/MTL файл, используя векторное представление графика (см. OBJ формат). Вследствие чего не рекомендуется сохранять большие графики (поверхности, а особенно поверхности уровня) из-за большого размера файла. Хотя никаких внутренних ограничений на размер выходного файла нет. Для них лучше использовать растровый формат (например, PNG или JPEG). Параметры функции следующие: fname – имя файла, descr – описание файла.

Метод класса mglGraph: void WriteXYZ (const char *fname, const char *descr="")
Функция С: void mgl_write_xyz (HMGL gr, const char *fname, const char *descr)

Экспортирует текущий кадр в XYZ/XYZL/XYZF файлы, используя векторное представление графика (см. XYZ формат). Вследствие чего не рекомендуется сохранять большие графики (поверхности, а особенно поверхности уровня) из-за большого размера файла. Хотя никаких внутренних ограничений на размер выходного файла нет. Для них лучше использовать растровый формат (например, PNG или JPEG). Параметры функции следующие: fname – имя файла, descr – описание файла.

Метод класса mglGraph: void WriteSTL (const char *fname, const char *descr="")
Функция С: void mgl_write_stl (HMGL gr, const char *fname, const char *descr)

Экспортирует текущий кадр в STL файл, используя векторное представление графика (см. STL формат). Вследствие чего не рекомендуется сохранять большие графики (поверхности, а особенно поверхности уровня) из-за большого размера файла. Хотя никаких внутренних ограничений на размер выходного файла нет. Для них лучше использовать растровый формат (например, PNG или JPEG). Параметры функции следующие: fname – имя файла, descr – описание файла.

Метод класса mglGraph: void WriteOFF (const char *fname, const char *descr="", bool colored=false)
Функция С: void mgl_write_off (HMGL gr, const char *fname, const char *descr, bool colored)

Экспортирует текущий кадр в OFF файл, используя векторное представление графика (см. OFF формат). Вследствие чего не рекомендуется сохранять большие графики (поверхности, а особенно поверхности уровня) из-за большого размера файла. Хотя никаких внутренних ограничений на размер выходного файла нет. Для них лучше использовать растровый формат (например, PNG или JPEG). Параметры функции следующие: fname – имя файла, descr – описание файла.

Метод класса mglGraph: void ShowImage (const char *viewer, bool nowait=false)
Функция С: void mgl_show_image (const char *viewer, int nowait)

Отображает текущий кадр используя внешнюю программу просмотра viewer. Функция сохраняет картинку во временный файл и вызывает viewer для его отображения. Если nowait=true, то функция возвращает управление немедленно – не ждет пока окно просмотра будет закрыто.

Метод класса mglGraph: void WriteJSON (const char *fname, const char *descr="")
Функция С: void mgl_write_json (HMGL gr, const char *fname, const char *descr)

Экспортирует точки и примитивы в текстовый файл используя JSON format. В дальнейшем этот файл можно загрузить и просмотреть в JavaScript скрипте. Параметры функции следующие: fname – имя файла, descr – описание файла.

Метод класса mglGraph: void ExportMGLD (const char *fname, const char *descr="")
Функция С: void mgl_export_mgld (HMGL gr, const char *fname, const char *descr)

Экспортирует точки и примитивы в файл MGLD format. В дальнейшем этот файл можно загрузить и просмотреть с помощью mglview. Параметры функции следующие: fname – имя файла, descr – описание файла.

Метод класса mglGraph: void ImportMGLD (const char *fname, bool add=false)
Функция С: void mgl_import_mgld (HMGL gr, const char *fname, int add)

Импортирует точки и примитивы из файла в MGLD format. Параметры функции следующие: fname – имя файла, add – флаг добавления или замены существующих точек и примитивов.