mlreportgen.ppt.Picture class

Пакет: mlreportgen.ppt
Суперклассы:

Создайте изображение, чтобы включать в представление

Описание

Создайте изображение, чтобы включать в представление.

Конструкция

pictureObj = mlreportgen.ppt.Picture() создает пустой объект изображения.

pictureObj = mlreportgen.ppt.Picture(picturePath) создает объект изображения, содержащий изображение, заданное picturePath.

Примечание

Содержимое заданного файла изображения копируется в выходное представление, когда представление закрывается. Не удаляйте или перезаписывайте файл изображения, прежде чем он будет скопирован в представление. Если вы создаете файл изображения и соответствующий mlreportgen.ppt.Picture объект в цикле, для каждой итерации цикла, использует уникальное имя файла для файла изображения.

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

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

Путь файла изображения в виде вектора символов. API PPT поддерживает форматы изображения в таблице. Формат Масштабируемой векторной графики (SVG) не поддерживается.

'imageFormat' Расширение файла
Битовый массив.bmp
Расширенный метафайл.emf
Инкапсулированный PostScript®.eps
Формат обмена графическими данными .gif
Формат графических данных JPEG.jpeg, .jpg
Переносимая сетевая графика).png
Теговый формат графических файлов.tif, .tiff

Примечание

Чтобы гарантировать, что форматы изображения, используемые в вашем сгенерированном представлении, поддерживаются версией PowerPoint®, которую вы используете, смотрите Форматы файлов, которые поддерживаются в PowerPoint на веб-сайте Microsoft®.

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

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

Изображение, возвращенное как mlreportgen.ppt.Picture объект.

Свойства

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

Имя изображения в виде вектора символов.

Верхнее левое x-положение-координат изображения, заданного в форме valueUnits где Units сокращение от модулей. Допустимые сокращения:

  • px — пиксели (значение по умолчанию)

  • cm 'centimeters'

  • in 'inches'

  • mm — миллиметры

  • pc — цицеро

  • pt 'points'

Верхнее левое y-положение-координат изображения, заданного в форме valueUnits где Units сокращение от y-position модулей. Допустимые сокращения:

  • px — пиксели (значение по умолчанию)

  • cm 'centimeters'

  • in 'inches'

  • mm — миллиметры

  • pc — цицеро

  • pt 'points'

Ширина изображения, заданного в форме valueUnits где Units сокращение от модулей. Допустимые сокращения:

  • px — пиксели (значение по умолчанию)

  • cm 'centimeters'

  • in 'inches'

  • mm — миллиметры

  • pc — цицеро

  • pt 'points'

Высота изображения, заданного в форме valueUnits где Units сокращение от модулей. Допустимые сокращения:

  • px — пиксели (значение по умолчанию)

  • cm 'centimeters'

  • in 'inches'

  • mm — миллиметры

  • pc — цицеро

  • pt 'points'

Форматирование места для рисунка. Это свойство проигнорировано.

Дочерние элементы этого объекта в виде массива ячеек объектов PPT. Это свойство доступно только для чтения.

Родительский элемент этого объекта в виде объекта PPT. Это свойство доступно только для чтения.

Пометьте для этого объекта PPT API в виде вектора символов или строкового скаляра. Уникальный для сеанса тег сгенерирован как часть создания этого объекта. Сгенерированный тег имеет форму CLASS:ID, где CLASS класс объекта и ID значение Id свойство объекта.

Определение вашего собственного значения тега может помочь вам идентифицировать, где проблема произошла во время генерации представления.

ID для этого объекта PPT API в виде вектора символов или строкового скаляра. Уникальный идентификатор сеанса сгенерирован как часть создания объекта. Можно задать ID, чтобы заменить сгенерированный ID.

Методы

Метод

Цель

replace

Замените изображение на другое изображение.

Примеры

свернуть все

Создайте представление с двумя слайдами.

import mlreportgen.ppt.*

slidesFile = 'myPicturePresentation.pptx';
slides = Presentation(slidesFile);

add(slides,'Title Slide');
add(slides,'Title and Content');

Создайте Picture объект с помощью изображения самолета, доступного в MATLAB®. Задайте размер для изображения.

plane = Picture(which('b747.jpg'));
plane.Width = '5in';
plane.Height = '2in';

Замените содержимое второго понижения с plane изображение.

replace(slides,'Content',plane);

Закройте представление.

close(slides);

Открытый myPicturePresentation.pptx. На платформе Windows® можно открыть представление в MATLAB:

if ispc
    winopen(slidesFile);
end

Чтобы добавить изображение фигуры MATLAB к представлению, этот пример распечатывает фигуру к файлу изображения, создает mlreportgen.ppt.Picture объект из файла, и добавляет Picture возразите против понижения в представлении.

Создайте представление.

import mlreportgen.ppt.*

ppt = Presentation("myFigurePresentation.pptx");
open(ppt);

Добавьте понижение в представление.

slide = add(ppt,"Title and Content");

Добавьте заголовок на понижение.

replace(slide,"Title","surf(peaks)");

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

fig = figure;
surf(peaks);

Распечатайте фигуру к файлу изображения. Не удаляйте файл изображения прежде, чем сгенерировать представление.

figSnapshotImage = "figSnapshot.png";
print(fig,"-dpng",figSnapshotImage);

Создайте mlreportgen.ppt.Picture объект с помощью файла изображения.

figPicture = Picture(figSnapshotImage);

Добавьте Picture возразите против понижения.

replace(slide,"Content",figPicture);

Закройте представление.

close(ppt);

Удалите фигуру и файл изображения.

delete(fig);
delete(figSnapshotImage);

Просмотрите представление.

rptview(ppt);

Вот сгенерированное понижение с изображением фигуры: