mlreportgen.ppt.Picture class

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

Создайте картинку для включения в презентацию

Описание

Создайте изображение для включения в презентацию.

Конструкция

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

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

Примечание

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

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

расширить все

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

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

Примечание

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

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

расширить все

Рисунок, возвращенный как mlreportgen.ppt.Picture объект.

Свойства

расширить все

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

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

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

  • cm - сантиметров

  • in - дюймы

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

  • pc - picas

  • pt - точки

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

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

  • cm - сантиметров

  • in - дюймы

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

  • pc - picas

  • pt - точки

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

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

  • cm - сантиметров

  • in - дюймы

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

  • pc - picas

  • pt - точки

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

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

  • cm - сантиметров

  • in - дюймы

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

  • pc - picas

  • pt - точки

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

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

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

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

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

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

Методы

Метод

Цель

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);

Вот сгенерированный слайд с изображением рисунка: