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

EPS уровня 3 черно-белый

.pdf

Формат переносимых документов

.bmp

Windows® битовый массив

.emf

Усиленный метафайл

.pbm

Портативное растровое изображение

.pcx

Краска 24-битная

.pgm

Портативная граймап

.ppm

Портативная пиксельная карта

.tif

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

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

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

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

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

  • Формат файла растрового изображения - Задайте формат как один из опций растрового изображения в таблице, Bitmap Image Formats.

  • Вектор формат графического файла - Задайте формат как один из вектора графических опций в таблице Вектора Graphics Форматов.

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

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

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

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

Примечание

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

Подробнее о

свернуть все

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

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

Совет

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

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

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

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

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

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

  • Минимизируйте пустое пространство вокруг содержимого

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

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

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

Представлено до R2006a
Для просмотра документации необходимо авторизоваться на сайте