print

Распечатайте фигуру или сохраните в определенный формат файла

Описание

пример

print(filename,formattype) сохраняет текущую фигуру в файл с помощью заданного формата файла, такого как print('BarPlot','-dpng'). Если имя файла не включает расширение, то print добавляет соответствующий.

print(filename,formattype,formatoptions) задает дополнительные опции, которые доступны для некоторых форматов.

пример

print распечатывает текущую фигуру к принтеру по умолчанию.

print(printer) задает принтер. Задайте принтер как вектор символов или строку, содержащую имя принтера, которому предшествует -P, например, '-Pmy printer'. Принтер должен быть настроен в вашей системе.

print(driver) задает драйвер. Используйте эту опцию, если вы хотите гарантировать, что печатный выход является или черным и белым или цвет.

print(printer,driver) задает принтер и драйвер.

пример

print('-clipboard',clipboardformat) копирует текущую фигуру в буфер обмена с помощью формата, заданного clipboardformat. Можно вставить скопированную фигуру в другие приложения.

пример

print(resize,___) максимизирует размер фигуры, чтобы заполнить страницу. Задайте resize как '-bestfit' сохранить соотношение сторон фигуры или '-fillpage' проигнорировать соотношение сторон. Эти опции допустимы только при сохранении в формат страниц (PDF и PS) или печати к принтеру. Используйте эту опцию с любым из входных параметров от предыдущих синтаксисов.

пример

print(resolution,___) использует заданное разрешение. Задайте разрешение как вектор символов или строку, содержащую целочисленное значение, которому предшествует -r, например, '-r200'. Используйте эту опцию с любым из входных параметров от предыдущих синтаксисов.

print(renderer,___) использует заданное средство отображения. Задайте средство отображения как любой '-vector' или '-image'.

пример

print('-noui',___) исключает средства управления пользовательским интерфейсом, такие как кнопки и ползунки, от сохраненного или распечатанного выхода. Это не исключает объекты пользовательского интерфейса, которые могут содержать оси, такие как uitab или uipanel.

пример

print(fig,___) сохраняет или распечатывает фигуру или Simulink® блок-схема задана fig.

пример

cdata = print('-RGBImage'); возвращает данные изображения RGB для текущей фигуры. Эта опция отличается от снимков экрана, в которых все функции печати применяются к выходу. Можно также задать resolution, renderer, '-noui', и fig опции с этим синтаксисом. Однако вы не можете задать Диаграмму Simulink.

Примеры

свернуть все

Создайте столбчатую диаграмму и распечатайте ее к своему принтеру системного значения по умолчанию. Если вы не задаете фигуру, чтобы распечатать, то print использует текущую фигуру.

bar(1:10)
print

Создайте график и скопируйте его в системный буфер обмена.

plot(1:10)
print('-clipboard','-dmeta')

Можно вставить скопированный график в другие приложения.

Создайте график и сохраните его как файл изображения PNG.

bar(1:10)
print('BarPlot','-dpng')

print сохраняет график как BarPlot.png.

Создайте график и сохраните его как Инкапсулированный формат PostScript® файл.

bar(1:10)
print('BarPlot','-depsc')

print сохраняет график как BarPlot.eps.

Сохраните текущую фигуру как Файл Инкапсулированного формата PostScript и добавьте предварительный просмотр TIFF.

surf(peaks)
print('SurfacePlot','-depsc','-tiff')

Сохраните определенную фигуру путем передачи его переменной объекта print.

fig = figure;
plot(1:10)
print(fig,'MySavedPlot','-dpng')

В качестве альтернативы обратитесь к фигуре, использующей значение его Number свойство, которое является целочисленным значением, которое отображается в строке заголовка окна рисунка. Например, сохраните фигуру с Figure 2 отображенный в строке заголовка. Предшествуйте целочисленному значению -f.

figure(2);
plot(1:10)
print('-f2','MySavedPlot','-dpng')

Сохраните объемную поверхностную диаграмму в файл PNG. Установите PaperPositionMode свойство для фигуры к 'auto' так, чтобы это сохранило в размере, отображенном на экране. Используйте '-r0' сохранить его с разрешением экрана.

surf(peaks)
set(gcf,'PaperPositionMode','auto')
print('PeaksSurface','-dpng','-r0')

Сохраните фигуру, которая заполняет страницу с помощью '-fillpage' опция.

bar([1 10 7 8 2 2 9 3 6])
print('FillPageFigure','-dpdf','-fillpage')

Создайте фигуру с кнопкой, которая очищает оси. Сохраните фигуру в файл JPEG, не сохраняя кнопку.

surf(peaks)
uicontrol('Style','pushbutton','String','Clear',...
    'Position',[20 20 50 20],'Callback','cla');
print('SurfacePlot','-djpeg','-noui')

Возвратите данные изображения RGB для фигуры.

surf(peaks)
cdata = print('-RGBImage');

Отобразите данные изображения в полном разрешении с помощью imshow.

imshow(cdata)

Создайте объемную поверхностную диаграмму. Возвратите данные изображения RGB для фигуры и задайте разрешение изображения. Затем преобразуйте данные изображения в кадр фильма, F.

surf(peaks)
cdata = print('-RGBImage','-r120');
F = im2frame(cdata);

Входные параметры

свернуть все

Имя файла в виде вектора символов или строки, содержащей желаемое имя файла и путь.

Пример: 'My Saved Chart'

Пример: 'Folder\My Saved Chart'

Пример: "My Saved Chart"

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

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

Формат файла в виде одной из опций в этих таблицах.

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

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

Эта таблица приводит поддерживаемые форматы растрового изображения.

ОпцияФормат растрового изображенияСоответствующее расширение файла
'-djpeg'24-битный JPEG.jpg
'-dpng'24-битный PNG.png
'-dtiff'TIFF, 24-битный (сжатый).tif
'-dtiffn'24-битный TIFF (не сжатый).tif
'-dmeta'Расширенный метафайл (только Windows).emf
'-dbmpmono'Монохром BMP .bmp
'-dbmp'24-битный BMP .bmp
'-dbmp16m'24-битный BMP .bmp
'-dbmp256'8-битный BMP (256 цветов, использует фиксированную палитру), .bmp
'-dhdf'24-битный HDF.hdf
'-dpbm'PBM (простой формат) 1-битный.pbm
'-dpbmraw'PBM 1-битный (формат .raw).pbm
'-dpcxmono'1-битный PCX.pcx
'-dpcx24b'PCX 24-битный цвет (три 8-битных плоскости).pcx
'-dpcx256'PCX 8-битный более новый цвет (256 цветов).pcx
'-dpcx16'PCX более старый цвет (EGA/VGA, с 16 цветами).pcx
'-dpgm'PGM (простой формат).pgm
'-dpgmraw'PGM (формат .raw).pgm
'-dppm'PPM (простой формат).ppm
'-dppmraw'PPM (формат .raw).ppm

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

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

Если вы устанавливаете Renderer свойство для фигуры, затем print использование, что средство отображения, когда генерация выводится. В противном случае, print выбирает соответствующее средство отображения. Как правило, print генерирует файлы векторной графики, которые масштабируются хорошо, когда изменено. Для некоторых комплексных фигур файлы могут содержать встроенные растровые изображения вместо этого. Эти растровые изображения не масштабируются хорошо, и степень, до которой можно отредактировать их в других приложениях, ограничивается. Гарантировать тот print использует средство отображения векторной графики, задайте '-vector' как входной параметр к print функция.

Если вы хотите выход, который имеет прозрачность, то создайте файл векторной графики с помощью Метафайла, PDF или формата SVG. Если вы используете PS или формат EPS, то прозрачность только поддерживается для фонов осей и фигуры. Растровые изображения не поддерживают прозрачность, но будут тесно совпадать с тем, что, как показывают, на экране дает внешний вид прозрачности.

Примечание

Средством отображения фигуры по умолчанию является OpenGL®. Если средство отображения фигуры отличается от средства отображения, используемого, когда генерация вывела, некоторые детали сохраненной фигуры могут отличаться от фигуры по отображению. При необходимости можно заставить отображенную фигуру и сохраненную фигуру использовать то же средство отображения. Установите Renderer свойство для фигуры или задает renderer входной параметр к print функция.

Эта таблица приводит поддерживаемые форматы векторной графики.

ОпцияФормат векторной графикиСоответствующее расширение файла
'-dpdf'Полная страница цвет формата переносимых документов (PDF).pdf
'-deps'Инкапсулированный формат PostScript (EPS) Уровень 3, черный и белый.eps
'-depsc'Инкапсулированный формат PostScript (EPS) цвет Уровня 3.eps
'-deps2'Инкапсулированный формат PostScript (EPS) Уровень 2, черный и белый.eps
'-depsc2'Инкапсулированный формат PostScript (EPS) цвет Уровня 2.eps
'-dmeta'Расширенный метафайл (Windows® только).emf
'-dsvg'SVG (масштабируемая векторная графика).svg
'-dps'Полностраничный PostScript (PS) Уровень 3, черный и белый.ps
'-dpsc'Полностраничный PostScript (PS) цвет Уровня 3.ps
'-dps2'Полностраничный PostScript (PS) Уровень 2, черный и белый.ps
'-dpsc2'Полностраничный PostScript (PS) цвет Уровня 2.ps

Вы не можете сохранить Диаграммы Simulink в форматах EPS или PostScript.

Примечание

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

Дополнительные параметры форматирования, поддержанные некоторыми форматами файлов в виде одного или нескольких из этих значений:

  • '-tiff' — Включайте предварительный просмотр TIFF. Файлы EPS только.

  • '-loose' — Используйте свободную ограничительную рамку. EPS и файлы PS только.

  • '-cmyk' — Используйте цвета CMYK вместо цветов RGB. EPS и файлы PS только.

  • '-append' — Добавьте фигуру к существующему файлу PS. Файлы PS только.

Пример: print('my file','-deps','-tiff','-loose') сохраняет текущую фигуру в файл my file.eps использование свободной ограничительной рамки и включает предварительный просмотр TIFF.

Имя принтера в виде вектора символов или строки, содержащей -P и имя принтера.

Пример: '-Pmy local printer'

Пример: "-Pmy local printer"

Чтобы просмотреть список доступных принтеров, используйте эту команду:

[~,printers] = findprinters

Если вы не задаете принтер, то print использует принтер системного значения по умолчанию. Если вы хотите настроить новый принтер или выбрать различный принтер по умолчанию, используйте утилиты управления принтером операционной системы. Перезапустите MATLAB, если вы не видите принтер, который уже настраивается.

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

Драйвер принтера в виде '-dwin', '-dwinc', '-dprn', или '-dprnc'. Если вы не задаете драйвер, то print использует драйвер, возвращенный из printopt функция.

Опция, которую вы используете, зависит от вашей системы, например:

СистемаДрайверВывод
Windows'-dwin'Черный и белый
'-dwinc'Цвет
Linux® или Mac'-dprn' Черный и белый
'-dprnc'Цвет

Формат, скопированный в буфер обмена в виде одной из этих опций:

  • '-dmeta' — Расширенный метафайл (только Windows)

  • '-dbitmap' — Растровое изображение (Windows и Mac OS)

  • '-dpdf' — Файл PDF (Windows и Mac OS)

Опция, чтобы расширить фигуру, чтобы заполнить страницу в виде одного из этих значений:

  • '-fillpage' — Максимизируйте размер фигуры, чтобы заполнить страницу. Оставьте.25дюймовое поле на всех сторонах страницы. Отметки деления, размещение и соотношение сторон фигуры могут измениться.

  • '-bestfit' — Максимизируйте размер фигуры, чтобы заполнить страницу, но сохранить соотношение сторон фигуры. Фигура не может заполнить целую страницу. Эта опция оставляет минимальное поле страницы.25 дюймов.

Обе опции допустимы только при печати фигуры к принтеру или сохранении в формат страниц, такой как PDF и PS. Они не допустимы для Диаграмм Simulink.

Разрешение в виде вектора символов или строки, содержащей -r и целочисленное значение, указывающее на разрешение в точках на дюйм. Например, '-r300' устанавливает выходное разрешение на 300 точек на дюйм. Чтобы задать разрешение экрана, используйте '-r0'.

В общем случае использование более высокого значения разрешения дает к более высокому качеству выход, но за счет более высокого использования памяти и больших выходных файлов. Чем выше настройка разрешения, тем дольше она берет, чтобы представить вашу фигуру.

Определение разрешения полезно при создании растрового изображения или при использовании средства отображения OpenGL с форматом файла векторной графики (поскольку OpenGL производит растровое изображение даже с векторными форматами). Определение разрешения не оказывает влияния при использовании средства отображения Живописцев с форматом файла векторной графики, поскольку Живописцы производят истинный файл векторной графики, который содержит команды, которые перерисовывают фигуру.

Примечание

Печать Simulink не поддерживает параметр разрешения. По более высокому качеству выход моделей Simulink используйте векторный формат, такой как SVG или PDF.

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

Графическое средство отображения в виде '-image' или '-vector'.

  • '-image' — Средство отображения OpenGL. Используйте это средство отображения при сохранении растровых образов. OpenGL производит растровое изображение даже с векторными форматами, которые могут ограничить степень, до которой можно отредактировать изображение в других приложениях.

  • '-vector' — Средство отображения живописцев. Используйте это средство отображения, сохранив файлы векторной графики. Если вы сохраняете в файл векторной графики и если фигура RendererMode свойство установлено в 'auto', затем print автоматически попытки использовать средство отображения Живописцев. Если вы хотите гарантировать, что ваш выходной формат является истинным файлом векторной графики, то задайте '-vector' опция. Например:

    print('-vector','-deps','myVectorFile')

Примечание

Иногда, сохранив файл с '-vector' опция может вызвать более длительные времена рендеринга и, в редких случаях, не может точно расположить графические объекты в 3-D представлениях. Кроме того, средство отображения Живописцев не может распечатать или сохранить разбавитель линий, чем один пиксель.

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

Объект фигуры или Диаграмма Simulink. Можно обратиться к фигуре, использующей или его имя переменной объекта или использующей номер фигуры, которому предшествует -f. Например, -f2 относится к фигуре с Number значение свойства 2. При определении Диаграммы Simulink предшествуйте имени модели с -s. Задайте текущую модель с помощью '-s'.

Вы не можете сохранить Диаграммы Simulink в форматах EPS или PostScript.

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

свернуть все

Данные изображения, возвращенные как n m 3 массивами. Размер массива данных изображения зависит от PaperPosition свойство фигуры и выходного разрешения.

Примечание

Запуск в R2015b, если вы используете print с '-r0' опция в системе с высоким разрешением, затем размер cdata выходной массив больше, чем в предыдущих релизах или в других системах. Кроме того, число элементов в cdata не может совпадать с размером фигуры в пикселях на основе PaperPosition фигуры свойство и ScreenPixelsPerInch корня свойство. Для получения дополнительной информации смотрите учитывающее DPI Поведение в MATLAB.

Ограничения

  • Стартовый MATLAB ни в каком режиме отображения на Linux или использовании -noFigureWindows опция запуска на любой платформе имеет эти ограничения для print:

    • Печать или сохранение фигур с видимыми ошибками uicontrol. Чтобы распечатать или сохранить фигуру, скройте uicontrol путем установки их Visible свойства к 'off', или используйте '-noui' опция с print функция.

    • Всегда использует средство отображения живописцев, даже если вы задаете '-image' опция.

  • В MATLAB Online™, print только печать к PDF. Для дополнительных параметров формата файлов сохраните фигуру в файл путем определения filename.

Больше о

свернуть все

CurrentFigure

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

Чтобы распечатать определенную фигуру, задайте фигуру как первый входной параметр. Если вы не задаете фигуру, то print функционируйте действия на фигуре, возвращенной gcbf. Если gcbf возвращается пустой, затем print действия на фигуре, возвращенной gcf.

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

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

Советы

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

    Изобразите свойствоОписание
    PaperPositionРазмер печатной или сохраненной фигуры. При печати к принтеру или полностраничному выходному формату, затем это свойство также определяет местоположение фигуры на странице.
    PaperPositionModeЗадает, использовать ли PaperPosition свойство или размер фигуры по экрану, чтобы установить размер печатной или сохраненной фигуры.
    InvertHardcopyЗадает, использовать ли текущий фоновый цвет фигуры или изменить цвет фона в белый при печати или сохранении фигуры.
    PaperOrientationИзобразите ориентацию на печатной странице.
    PaperTypeФормат бумаги стандартного принтера.
    PaperSizeПользовательская ширина и высота бумаги для принтера.
    PaperUnitsМодули для PaperSize и PaperPosition свойства.

  • Если вы используете систему Linux или Mac и получаете ошибку о недопустимом или нераспознанном принтере, то попытайтесь задать драйвер PostScript для driver опция. Если принтер поддерживает уровень 3 PostScript, попробуйте '-dps' для черного цвета и белого или '-dpsc' для цвета. Если принтер поддерживает уровень 2 PostScript, то попробуйте '-dps2' для черного цвета и белого или '-dps2c' для цвета. Например:

    print('-dpsc','-Pmy printer')
    Чтобы использовать этот драйвер в качестве драйвера по умолчанию, отредактируйте printopt файл. В качестве альтернативы распечатайте фигуру к файлу PDF. Затем распечатайте PDF от внешнего средства просмотра PDF.

  • Если вы распечатываете фигуру, которой задали коллбэк для SizeChangedFcn свойство и если выходной размер отличается от размера фигуры по экрану, то print функционируйте отображает предупреждающее сообщение. Чтобы избежать предупреждающего сообщения, установите PaperPositionMode свойство для фигуры к 'auto'.

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

С тех пор в R2020a

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

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

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

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

  • Сохраните многостраничную PDF (начиная с R2021b)

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

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

copygraphics функция обеспечивает большую часть той же функциональности как exportgraphics функция, за исключением того, что это копирует содержимое в ваш системный буфер обмена вместо того, чтобы сохранить его в файл. Используйте эту функцию, чтобы скопировать и вставить содержимое из MATLAB в другие приложения.

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

развернуть все

Не рекомендуемый запуск в R2021b

Поведение изменяется в R2016a

Смотрите также

| | | | |

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