В этом примере показано, как центрировать снимок рисунка на странице ландшафта для отчетов PDF и Microsoft ® Word.
Пример создает отчет Report API с ландшафтным размещением, создает фигуры MATLAB, а затем использует centerFigure
локальная функция для создания и добавления моментальных снимков этих рисунков в центре страницы.
Импортируйте пакеты DOM и Report API так, чтобы не использовать длинные, полные имена классов.
import mlreportgen.dom.* import mlreportgen.report.*
Создание отчета PDF. Чтобы создать отчет Microsoft ® Word, измените "pdf"
на "docx"
.
rpt = Report("myreport","pdf"); open(rpt);
Создайте объект макета страницы.
if strcmpi(rpt.Type,"pdf") pageLayoutObj = PDFPageLayout; else pageLayoutObj = DOCXPageLayout; end
Укажите ориентацию, высоту и ширину страницы.
pageLayoutObj.PageSize.Orientation = "landscape"; pageLayoutObj.PageSize.Height = "8.5in"; pageLayoutObj.PageSize.Width = "11in";
Укажите поля страницы.
pageLayoutObj.PageMargins.Top = "0.5in"; pageLayoutObj.PageMargins.Bottom = "0.5in"; pageLayoutObj.PageMargins.Left = "0.5in"; pageLayoutObj.PageMargins.Right = "0.5in"; pageLayoutObj.PageMargins.Header = "0.3in"; pageLayoutObj.PageMargins.Footer = "0.3in";
Добавьте объект макета страницы в отчет.
add(rpt,pageLayoutObj);
Создать рисунок с линейным графиком.
f = figure();
plot(1:1:10,2:2:20);
grid on;
Вызовите centerFigure
локальная функция для добавления рисунка снимка в центр страницы. Затем удалите объект рисунка.
centerFigure(f,rpt);
delete(f);
Точно так же добавьте снимок мембраны объемной поверхностной диаграммы в центр страницы.
centerFigure(surf(membrane),rpt);
delete(gcf);
Закройте и просмотрите отчет.
close(rpt); rptview(rpt);
centerFigure
Локальная функцияЭта функция создает снимок указанного рисунка и добавляет ее в центр страницы в указанном отчете. Функция использует Report API Figure
reporter, чтобы сделать снимок рисунка и невидимый DOM Table
для выполнения размещения.
function centerFigure(figure,rpt)
Импортируйте пакеты DOM API, Report API и утилиты генератора отчетов, чтобы не использовать длинные, полные имена классов.
import mlreportgen.dom.* import mlreportgen.report.* import mlreportgen.utils.*
Получите текущий макет страницы отчета, чтобы определить текущий размер страницы и поля страницы. Информация о макете страницы используется для вычисления размера тела страницы в порядок размера таблицы размещения, созданной на следующем шаге.
pageLayout = getReportLayout(rpt); pageSize = pageLayout.PageSize; pageMargins = pageLayout.PageMargins;
Вычислите ширину тела страницы. Ширина тела страницы обозначает ширину страницы, доступную для содержимого, и определяется путем вычитания размера левого и правого полей из ширины страницы. Для выхода DOCX также необходимо вычесть размер желоба.
bodyWidth = units.toInches(pageSize.Width) - ... units.toInches(pageMargins.Left) - ... units.toInches(pageMargins.Right); if strcmpi(rpt.Type,"docx") bodyWidth = bodyWidth - ... units.toInches(pageMargins.Gutter); end bodyWidth = sprintf("%0.2fin",bodyWidth);
Вычислите высоту тела страницы. Высота тела страницы обозначает высоту страницы, доступную для содержимого, и определяется путем вычитания размера верхнего и нижнего полей из высоты страницы. Для вывода PDF необходимо также вычесть размеры верхнего и нижнего колонтитулов, поскольку тело простирается от нижней части заголовка до верхней части нижнего колонтитула.
bodyHeight = units.toInches(pageSize.Height) - ... units.toInches(pageMargins.Top) - ... units.toInches(pageMargins.Bottom); if strcmpi(rpt.Type,"pdf") bodyHeight = bodyHeight - ... units.toInches(pageMargins.Header) - ... units.toInches(pageMargins.Footer); end bodyHeight = sprintf("%0.2fin",bodyHeight);
Создайте Figure
объект для заданного рисунка. Затем создайте Image
объект, обернутый вокруг файла изображения моментального снимка рисунка. Масштабирование изображения в соответствии с записью размещения, созданной на следующем шаге.
fig = Figure(figure); figImg = Image(getSnapshotImage(fig,rpt)); figImg.Style = [figImg.Style {ScaleToFit}];
Поместите изображение в абзац, так как PDF требует, чтобы изображение находилось в абзаце. Обновите стиль абзаца, чтобы убедиться, что вокруг изображения нет свободного пространства.
para = Paragraph(figImg); para.Style = [para.Style {OuterMargin("0in","0in","0in","0in")}];
Добавьте абзац, который содержит снимок рисунка в невидимое размещение 1 на 1 (lo_table
). Таблица считается невидимой, если границы не определены для таблицы и ее записей.
lo_table = Table({para});
Отобразить таблицу на доступную ширину тела страницы.
lo_table.Width = bodyWidth;
Пролет единственной записи таблицы на доступную высоту тела страницы. Кроме того, задайте вертикальный и горизонтальный форматы выравнивания, чтобы убедиться, что изображение центрировано как вертикально, так и горизонтально внутри записи таблицы.
lo_table.TableEntriesStyle = [lo_table.TableEntriesStyle ... { ... Height(bodyHeight), ... HAlign("center"), ... VAlign("middle") ... }];
Добавьте форматированную таблицу к отчету.
add(rpt,lo_table);
end
getReportLayout
| mlreportgen.dom.DOCXPageLayout
| mlreportgen.dom.PDFPageLayout
| mlreportgen.dom.Table
| mlreportgen.report.Figure
| mlreportgen.report.Report
| mlreportgen.utils.units