Пакет: mlreportgen.report
Суперклассы: mlreportgen.report.Reporter
Репортер фигуры
Создайте репортер рисунка с заголовком, рисунком и подписью.
The mlreportgen.report.Figure
класс является handle
класс.
HandleCompatible | true |
Для получения информации об атрибутах класса см. раздел «Атрибуты класса».
fig = mlreportgen.report.Figure()
создает репортер, который делает снимок рисунка, открытый в данный момент в MATLAB® и добавляет его к отчету. Используйте свойства рисунка для добавления подписи или изменения размера фигуры. Изображение снимка хранится во временной папке отчета. Когда отчет закроется, изображение снимка копируется в отчет, и изображение удаляется из временной папки. Чтобы предотвратить удаление файлов изображений моментального снимка, используйте Debug
свойство отчета. См. mlreportgen.report.Report
.
Примечание
Рисунок должен оставаться открытым до тех пор, пока не будет добавлен репортер фигуры в отчет.
fig = mlreportgen.report.Figure(source)
создает репортер, который добавляет рисунок, заданную source
и устанавливает свойство Source на source
.
fig = mlreportgen.report.Figure(Name,Value)
устанавливает свойства с помощью пар "имя-значение". Можно задать несколько аргументы пары "имя-значение" в любом порядке. Заключайте каждое имя свойства в одинарные или двойные кавычки.
Snapshot
- Изображение фигурыmlreportgen.report.FormalImage
объектИзображение фигуры, заданное как объект mlreportgen.report.FormalImage
класс reporter. Репортер использует gcf
для получения текущей фигуры MATLAB. Он использует формального репортера изображений, чтобы вставить рисунок в отчет. Чтобы задать размер моментального снимка или подписи, используйте свойства FormalImage
объект.
Примечание
Репортер рисунка инициализирует Snapshot
свойство. Не сбрасывайте это свойство.
Source
- Источник фигурыИсточник фигуры, заданный как:
Вектор символов или строковый скаляр, который указывает путь к допустимому файлу рисунка
Допустимый указатель на графику
SnapshotFormat
- Формат изображения снимка'svg'
(по умолчанию) |...Формат изображения снимка, заданный как вектор символов или строковый скаляр. Поддерживаемые форматы:
'bmp'
- Растровое изображение.
'gif'
- Формат графического обмена.
'jpg'
- изображение JPEG.
'png'
- Изображение PNG.
'emf'
- Расширенный метафайл, поддерживаемый только в DOCX выходных данных в Windows® платформы.
'svg'
- Масштабируемая векторная графика.
'tif'
- Тег Image File формат, не поддерживается в HTML выходных данных.
'pdf'
- PDF-изображение (поддерживается только в формате PDF).
Scaling
- Опции масштабирования для изображения моментального снимка рисунка'auto'
(по умолчанию) | 'custom'
| 'ни один'Опции масштабирования для изображения моментального снимка рисунка, заданные как вектор символов или строковый скаляр. Scaling
управляет размером рисунка изображения снимка в файле изображения. Поддерживаемые опции масштабирования:
'auto'
- Для выхода PDF или Word (DOCX) масштабирует изображение снимка рисунка так, чтобы оно совпадало с текущим макетом страницы, сохраняя при этом соотношение сторон. Во-первых, изображение снимка рисунка масштабируется до ширины страницы. Если высота изображения превышает высоту страницы, изображение снова масштабируется. Это дополнительное масштабирование гарантирует, что изображение подходит для текущей страницы с дополнительным интервалом в один дюйм. Масштабирование не применяется к выходным данным HTML.
'custom'
- Масштабирует изображение моментального снимка рисунка на основе значений Height
и Width
свойства.
Когда вы задаете Scaling
на custom
и иметь большие значения для Height
и Width
свойства, а java.lang.OutOfMemoryError
может происходить во время генерации PDF. Чтобы избежать этой ошибки и убедиться, что рисунок помещается на странице, используйте меньшие Height
и Width
значения.
'none'
- Калибровка не выполняется
Примечание
The 'auto'
и 'custom'
опции используют MATLAB print
команда для изменения размера рисунка. Если рисунок слишком велика для четкого расположения в заданном пространстве, print
команда обрабатывает изображение моментального снимка. Чтобы избежать обрезки, можно задать 'none'
как значение Scaling
опция и использовать репортер, заданный Snapshot
свойство для размера изображения рисунка. Этот репортер уменьшает размер текста с остальной частью изображения, и пользователю, возможно, потребуется увеличить изображение в средстве просмотра, чтобы различить мелкие детали. См. раздел Изменение размера изображения снимка фигуры.
Height
- Высота снимка изображенияВысота изображения снимка, заданная как вектор символов или строковый скаляр, который состоит из числа, за которым следует сокращение для единицы измерения. Для примера '2in' задает два дюйма. Допустимые сокращения:
px
- пиксели (по умолчанию)
cm
- сантиметров
in
- дюймы
mm
- миллиметры
pc
- picas
pt
- точки
Пример: '2in'
Width
- Ширина изображения моментального снимкаШирина изображения моментального снимка, заданная как вектор символов или строковый скаляр, который состоит из числа, за которым следует сокращение для единицы измерения. Для примера '2in' задает два дюйма. Допустимые сокращения:
px
- пиксели (по умолчанию)
cm
- сантиметров
in
- дюймы
mm
- миллиметры
pc
- picas
pt
- точки
Пример: '3in'
PreserveBackgroundColor
- Сохраните цвет фона рисункаСохраните цвет фона рисунка в моментальном снимке, заданный как true
или false
. Если PreserveBackgroundColor
является true
цвет фона снимка совпадает с цветом фона рисунка. Если PreserveBackgroundColor
является false
цвет фона снимка белый.
TemplateSrc
- Источник шаблона для этого репортера[]
(по умолчанию) | вектор символов | строковый скаляр | репортер или отчет | документе DOM или части документаИсточник шаблона для этого репортера, заданный одним из следующих способов:
Вектор символов или строковый скаляр, который задает путь к файлу, содержащему шаблон для этого репортера
Репортер или отчет, шаблон которого используется для этого репортера или библиотека шаблонов которого содержит шаблон для этого репортера
DOM-документ или деталь документа, шаблон которой используется для этого репортера или библиотека шаблонов которой содержит шаблон для этого репортера
Указанный шаблон должен совпадать с типом отчета, к которому добавлен этот репортер. Для примера, для Microsoft® Отчет о словах, TemplateSrc
должен быть шаблоном репортера Word. Если на TemplateSrc
свойство пусто, этот репортер использует шаблон репортера по умолчанию для типа выхода отчета.
TemplateName
- Имя шаблона для этого репортераИмя шаблона для этого репортера, заданное как вектор символов или строковый скаляр. Шаблон для этого репортера должен быть в библиотеке шаблонов источника шаблона (TemplateSrc
) для этого репортера.
LinkTarget
- Цель гиперссылки для этого репортера[]
(по умолчанию) | вектор символов | строковый скаляр | mlreportgen.dom.LinkTarget
объектЦель гиперссылки для этого репортера, заданная как вектор символов или строковый скаляр, задающий идентификатор цели ссылки или mlreportgen.dom.LinkTarget
объект. Вектор символов или строковое скалярное значение преобразуется в LinkTarget
объект. Цель ссылки непосредственно предшествует содержимому этого репортера в выход отчете.
getSnapshotImage | Путь к изображению моментального снимка |
mlreportgen.report.Figure.getClassFolder | Расположение файла определения класса фигуры |
mlreportgen.report.Figure.createTemplate | Создайте шаблон рисунка |
mlreportgen.report.Figure.customizeReporter | Создайте пользовательский класс figure reporter |
copy | Создайте копию объекта reporter и сделайте глубокие копии определенных значений свойств |
getImpl | Получите реализацию reporter |
Добавьте фигуру объемной поверхностной диаграммы в отчет и установите заголовок и высоту рисунка.
import mlreportgen.report.* surf(peaks); rpt = Report('peaks'); chapter = Chapter(); chapter.Title = 'Figure Example'; add(rpt,chapter); fig = Figure(); fig.Snapshot.Caption = '3-D shaded surface plot'; fig.Snapshot.Height = '5in'; add(rpt,fig); delete(gcf); rptview(rpt);
Добавьте два рисунков к отчету. Чтобы разместить их рядом друг с другом на странице, используйте объект DOM Table.
import mlreportgen.report.* import mlreportgen.dom.* rpt = Report('peaks'); surf(peaks(20)); figure = Figure(); peaks20 = Image(getSnapshotImage(figure,rpt)); peaks20.Width = '3in'; peaks20.Height = []; delete(gcf); surf(peaks(40)); figure = Figure(); peaks40 = Image(getSnapshotImage(figure,rpt)); peaks40.Width = '3in'; peaks40.Height = []; delete(gcf); t = Table({peaks20,peaks40;'peaks(20)','peaks(40)'}); add(rpt,t); close(rpt); rptview(rpt);
Этот пример генерирует отчет PDF, который иллюстрирует различие между изменением размера изображения моментального снимка рисунка с помощью print
команда и изменение размера с помощью репортера, заданного Snapshot
свойство Figure
репортер.
Создайте широкий рисунок MATLAB ®. Создайте три mlreportgen.report.Figure
репортеры из рисунка и добавить их в отчет.
Первый Figure
reporter не изменяет размер рисунка.
Вторая Figure
reporter использует print
команда для изменения размера рисунка.
The
третий Figure
reporter использует Snapshot
reporter, чтобы изменить размер рисунка.
import mlreportgen.report.* fig = figure(); ax = axes(fig); plot(ax, rand(1,100)); pos = fig.Position; fig.Position = [pos(1) pos(2) 2*pos(3) pos(4)]; rpt = Report('example','pdf'); add(rpt, "Intrinsic figure size"); figReporter0 = Figure(fig); figReporter0.Scaling = 'none'; add(rpt,figReporter0); add(rpt, "Resized by print command"); figReporter1 = Figure(fig); add(rpt,figReporter1); add(rpt, "Resized by snapshot reporter"); figReporter2 = Figure(fig); figReporter2.Scaling = 'none'; figReporter2.Snapshot.ScaleToFit = true; add(rpt,figReporter2);
close(rpt); delete(fig) rptview(rpt);
Вот рисунки в сгенерированном отчете:
SnapshotFormat
является 'svg'
для всех типов отчетовПоведение изменено в R2019b
Начиная с R2019b, изображения масштабируемой векторной графики (SVG) поддерживаются для отчетов Word. Для всех типов отчетов (HTML, PDF и Word) значение по умолчанию для SnapshotFormat
свойство 'svg'
и значение 'auto'
указывает 'svg'
. В предыдущих релизах значение по умолчанию для SnapshotFormat
свойство было 'auto'
, который указал 'svg'
для HTML и PDF отчетов и 'emf'
или 'png'
для отчетов Word, в зависимости от платформы.
Для отчетов Word, содержащих изображения SVG, требуется Word 2016 или более поздняя версия. В MATLAB R2019b или более позднем релизе, чтобы сгенерировать отчет с изображениями, совместимыми с более ранними версиями Word, установите SnapshotFormat
свойство к значению, отличному от 'svg'
. Чтобы задать формат изображения, используемый по умолчанию в более ранних релизах MATLAB, установите SnapshotFormat
кому:
'emf'
для платформы Windows
'png'
для UNIX® или Mac-платформы
gca
| mlreportgen.dom.Table
| mlreportgen.report.FormalImage
| mlreportgen.report.Report
| mlreportgen.report.Reporter
У вас есть измененная версия этого примера. Вы хотите открыть этот пример с вашими правками?
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.