exponenta event banner

saveas

Сохранить фигуру в определенном формате файла

Описание

пример

saveas(fig,filename) сохраняет рисунок или блок-схему Simulink ®, указанную fig к файлу filename. Укажите имя файла в виде символьного вектора или строки, содержащей расширение файла, например: 'myplot.jpg'. Расширение файла определяет формат файла. Если внутренний номер не указан, то saveas сохраняет рисунок в файл FIG. Чтобы сохранить текущую цифру, укажите fig как gcf.

пример

saveas(fig,filename,formattype) создает файл в указанном формате, formattype. Если в имени файла не указано расширение, например, 'myplot', то стандартное расширение, соответствующее указанному формату, автоматически добавляется к имени файла. Если указано расширение файла, оно не обязательно должно соответствовать формату. saveas использование formattype для формата, но сохраняет файл с указанным расширением. Таким образом, расширение файла может не соответствовать фактическому используемому формату.

Примеры

свернуть все

Создайте гистограмму и сохраните ее как PNG-файл.

x = [2 4 7 2 4 5 2 5 1 4];
bar(x);
saveas(gcf,'Barchart.png')

Создайте гистограмму и сохраните ее как файл EPS. Укажите 'epsc' драйвер, чтобы сохранить его в цвете.

x = [2 4 7 2 4 5 2 5 1 4];
bar(x);
saveas(gcf,'Barchart','epsc')

saveas сохраняет гистограмму как Barchart.eps.

Сохранение блок-схемы Simulink с именем 'sldemo_tank' в виде файла BMP. Использовать get_param получить дескриптор схемы. Для запуска этого кода необходимо установить программу Simulink.

sldemo_tank
fig = get_param('sldemo_tank','Handle');
saveas(fig,'MySimulinkDiagram.bmp');

Входные аргументы

свернуть все

Рисунок для сохранения, указанный как объект рисунка или блок-схема Simulink. Если указать другие типы графических объектов, например оси, то saveas сохраняет родительскую фигуру в объекте.

Пример: saveas(gcf,'MyFigure.png')

Чтобы сохранить блок-схему Simulink, используйте get_param получить дескриптор схемы. Например, сохраните блок-схему с именем 'sldemo_tank'.

sldemo_tank
saveas(get_param('sldemo_tank','Handle'),'MySimulinkDiagram.bmp');

Имя файла, указанное как символьный вектор или строка с расширением файла или без него.

Пример: 'Bar Chart'

Пример: 'Bar Chart.png'

Если указано расширение файла, то saveas использует связанный формат. Если вы указываете расширение файла и дополнительно указываете formattype входной аргумент, затем saveas использование formattype для формата и сохраняет файл с указанным именем. Таким образом, расширение файла может не соответствовать фактическому используемому формату.

Можно указать любое расширение, соответствующее формату файла. В этой таблице перечислены некоторые распространенные расширения файлов.

РасширениеРезультирующий формат
.fig

MATLAB ® FIG-файл (недопустимый для блок-схем Simulink)

.m

MATLAB FIG-файл и код MATLAB, открывающий рисунок (недопустимый для блок-схем Simulink)

.jpg

Изображение JPEG

.png

Портативная сетевая графика

.eps

Черно-белый уровень 3 EPS

.pdf

Формат переносимого документа

.bmp

Растровое изображение Windows ®

.emf

Улучшенный метафайл

.pbm

Переносной растровый рисунок

.pcx

Кисть 24-битная

.pgm

Переносная карта серого цвета

.ppm

Переносной Pixmap

.tif

Изображение TIFF, сжатое

Типы данных: char | string

Формат файла, указанный как один из следующих параметров:

  • 'fig' - Сохраните фигуру как файл фигуры MATLAB с помощью .fig расширение. Открытие фигур, сохраненных с помощью .fig расширение, используйте openfig функция. Этот формат недопустим для блок-схем Simulink.

  • 'm' или 'mfig' - сохраните фигуру как файл фигуры MATLAB и дополнительно создайте файл MATLAB, который откроет фигуру. Чтобы открыть рисунок, запустите файл MATLAB. Этот параметр недопустим для блок-схем Simulink.

  • Формат файла растрового изображения - укажите формат в качестве одного из параметров растрового изображения в таблице «Форматы растрового изображения».

  • Формат файла векторной графики (Vector graphics file format) - укажите формат в качестве одного из параметров векторной графики в таблице Форматы векторной графики (Vector Graphics Formats).

Файл растрового изображения

Растровые изображения содержат пиксельное представление фигуры. Размер созданного файла зависит от рисунка, формата и разрешения системы. Растровые изображения широко используются веб-браузерами и другими приложениями, которые отображают графику. Однако они плохо поддерживают прозрачность или масштаб, и нельзя изменять отдельные графические объекты (например, линии и текст) в других графических приложениях.

Форматы растровых изображений

ВыборФорматРасширение файла по умолчанию
'jpeg'24-разрядный JPEG.jpg
'png'24-разрядный PNG.png
'tiff'TIFF 24-разрядный (сжатый).tif
'tiffn'TIFF 24-разрядный (не сжатый).tif
'meta'Расширенный метафайл (только для Windows).emf
'bmpmono'Монохромный БМП .bmp
'bmp'24-разрядный BMP .bmp
'bmp16m'24-разрядный BMP .bmp
'bmp256'BMP 8-битный (256 цветной, использует фиксированную карту цветов) .bmp
'hdf'24-разрядный HDF.hdf
'pbm'PBM (обычный формат) 1-бит.pbm
'pbmraw'PBM (необработанный формат) 1-бит.pbm
'pcxmono'1-разрядный PCX.pcx
'pcx24b'24-битный цвет PCX (три 8-битных плоскости).pcx
'pcx256'8-битный новый цвет PCX (256 цветов).pcx
'pcx16'Более старый цвет PCX (16-цветный EGA/VGA).pcx
'pgm'PGM (обычный формат).pgm
'pgmraw'PGM (необработанный формат).pgm
'ppm'PPM (обычный формат).ppm
'ppmraw'PPM (необработанный формат).ppm

Файл векторной графики

В файлах векторной графики хранятся команды, которые перерисовывают рисунок. Этот тип формата хорошо масштабируется, но может привести к большому файлу. В некоторых случаях формат векторной графики может привести к неправильному 3-D расположению объектов. Некоторые приложения поддерживают обширное редактирование форматов векторной графики, но другие не поддерживают редактирование, кроме изменения размеров графики. Оптимальная практика состоит в том, чтобы внести все необходимые изменения, пока ваш показатель остается в MATLAB.

Как правило, saveas использует средство визуализации Painters при создании файлов векторной графики. Для некоторых сложных фигур, saveas использует средство визуализации OpenGL ®. Если используется средство визуализации OpenGL, то файл векторной графики содержит внедренное изображение, что может ограничить возможности редактирования изображения в других приложениях. Также, еслиsaveas использует средство визуализации OpenGL для создания файла, тогда прозрачность не поддерживается. Обеспечить, чтобы saveas использует средство визуализации Painters, установите Renderer свойство для фигуры в 'painters'.

Если установить Renderer свойство для фигуры, затем saveas использует это средство визуализации. В противном случае выбирается соответствующее средство визуализации. Однако, если saveas выбирает средство визуализации, которое отличается от средства визуализации, используемого для фигуры на дисплее, тогда некоторые детали сохраненной фигуры могут отличаться от отображаемой фигуры. При необходимости можно сделать так, чтобы отображаемая фигура и сохраненная фигура использовали одно и то же средство визуализации, установив Renderer свойство для фигуры.

Форматы векторной графики

ВыборФорматРасширение файла по умолчанию
'pdf'Полностраничный формат переносимых документов (PDF).pdf
'eps'Инкапсулированный PostScript ® (EPS) Уровень 3 черно-белый.eps
'epsc'Цвет инкапсулированного PostScript (EPS) уровня 3.eps
'eps2'Инкапсулированный PostScript (EPS) Уровень 2 черно-белый.eps
'epsc2'Цвет инкапсулированного PostScript (EPS) уровня 2.eps
'meta'Улучшенный метафайл (только для Windows).emf
'svg'SVG (масштабируемая векторная графика).svg
'ps'Полностраничный PostScript (PS) Уровень 3 черно-белый.ps
'psc'Полностраничный PostScript (PS) уровень 3 цвет.ps
'ps2'Полностраничный PostScript (PS) Уровень 2 черно-белый.ps
'psc2'Полностраничный PostScript (PS) Уровень 2 цвет.ps

Примечание

Только форматы PDF и PS используют PaperOrientation свойство фигуры и left и bottom элементы PaperPosition собственность. Другие форматы игнорируют эти значения.

Подробнее

свернуть все

Вопросы совместимости

Начиная с R2016a сохраненные фигуры по умолчанию соответствуют размеру фигуры на экране. Ранее сохраненные цифры  по умолчанию составляли 8 на 6 дюймов.

Совет

  • Для управления размером или разрешением при сохранении фигуры используйте print вместо этого функция.

  • saveas функция и диалоговое окно Сохранить как (Save As) (доступное из меню Файл (File)) не дают идентичных результатов. В диалоговом окне «Сохранить как» создаются изображения с разрешением экрана и размером экрана. saveas функция использует разрешение 150 DPI и использует PaperPosition и PaperPositionMode свойства фигуры для определения размера изображения.

  • Подробные данные сохраненных и напечатанных рисунков могут отличаться от рисунка на дисплее. Для получения выходных данных, которые более согласуются с отображением, см. раздел Сохранение фигуры с определенным размером, разрешением или цветом фона.

Альтернативная функциональность

Начиная с R2020a, вы можете использовать exportgraphics функция для сохранения содержимого любых осей, фигур, диаграмм, которые могут быть дочерними для фигуры, разметки мозаичной диаграммы или контейнера, такого как панель. Эта функция обеспечивает лучшую альтернативу saveas функция при необходимости:

  • Сохранение графики, отображаемой в приложении или в MATLAB Online™

  • Минимизация пробела вокруг содержимого

  • Сохранение фрагмента PDF с встраиваемыми шрифтами

  • Сохранение подмножества содержимого на рисунке

  • Управление цветом фона без необходимости изменения свойств фигуры

Представлен до R2006a