使用 C++ 优化演示文稿中的图像管理

演示文稿幻灯片中的图像

图像使演示文稿更具吸引力和趣味性。在 Microsoft PowerPoint 中,您可以将来自文件、互联网或其他位置的图片插入到幻灯片中。同样,Aspose.Slides 也允许您通过不同的方式向演示文稿的幻灯片添加图像。

Aspose.Slides 支持对这些常用格式的图像进行操作:JPEG、PNG、GIF 等。

向幻灯片添加本地存储的图像

您可以添加一张或多张计算机上的图像到演示文稿的幻灯片中。以下 C++ 示例代码演示如何向幻灯片添加图像:

auto pres = System::MakeObject<Presentation>();

auto slide = pres->get_Slides()->idx_get(0);
auto image = pres->get_Images()->AddImage(File::ReadAllBytes(u"image.png"));
slide->get_Shapes()->AddPictureFrame(ShapeType::Rectangle, 10.0f, 10.0f, 100.0f, 100.0f, image);

pres->Save(u"pres.pptx", SaveFormat::Pptx);

从网络向幻灯片添加图像

如果您想添加到幻灯片的图像在计算机上不可用,您可以直接从网络添加该图像。以下 C++ 示例代码演示如何从网络向幻灯片添加图像:

auto pres = System::MakeObject<Presentation>();
auto slide = pres->get_Slides()->idx_get(0);
    
auto webClient = System::MakeObject<WebClient>();
auto imageData = webClient->DownloadData(System::MakeObject<Uri>(u"[REPLACE WITH URL]"));

auto image = pres->get_Images()->AddImage(imageData);
slide->get_Shapes()->AddPictureFrame(ShapeType::Rectangle, 10.0f, 10.0f, 100.0f, 100.0f, image);

pres->Save(u"pres.pptx", SaveFormat::Pptx);

向母版幻灯片添加图像

幻灯片母版是位于顶部的幻灯片,用于存储和控制其下所有幻灯片的信息(主题、布局等)。因此,当您向幻灯片母版添加图像时,该图像会出现在该母版下的每张幻灯片上。以下 C++ 示例代码演示如何向幻灯片母版添加图像:

auto pres = System::MakeObject<Presentation>();
auto slide = pres->get_Slides()->idx_get(0);
auto masterSlide = slide->get_LayoutSlide()->get_MasterSlide();

auto image = pres->get_Images()->AddImage(File::ReadAllBytes(u"image.png"));
masterSlide->get_Shapes()->AddPictureFrame(ShapeType::Rectangle, 10.0f, 10.0f, 100.0f, 100.0f, image);

pres->Save(u"pres.pptx", SaveFormat::Pptx);

将图像设为幻灯片背景

您可能决定将图片作为特定幻灯片或多张幻灯片的背景。在这种情况下,请参阅 将图像设为幻灯片背景

向演示文稿添加 SVG

您可以使用属于 IShapeCollection 接口的 AddPictureFrame 方法向演示文稿添加或插入任何图像。要基于 SVG 图像创建图像对象,可以按以下方式操作:

  1. 创建 SvgImage 对象并将其插入到 ImageShapeCollection 中
  2. 从 ISvgImage 创建 PPImage 对象
  3. 使用 IPPImage 接口创建 PictureFrame 对象

以下示例代码演示如何实现上述步骤,以将 SVG 图像添加到演示文稿中:

// 文档目录的路径
System::String dataDir = u"D:\\Documents\\";

// 源 SVG 文件名
System::String svgFileName = dataDir + u"sample.svg";

// 输出演示文稿文件名
System::String outPptxPath = dataDir + u"presentation.pptx";

// 创建新演示文稿
auto p = System::MakeObject<Presentation>();

// 读取 SVG 文件内容
System::String svgContent = File::ReadAllText(svgFileName);

// 创建 SvgImage 对象
System::SharedPtr<ISvgImage> svgImage = System::MakeObject<SvgImage>(svgContent);

// 创建 PPImage 对象
System::SharedPtr<IPPImage> ppImage = p->get_Images()->AddImage(svgImage);

// 创建新的 PictureFrame 
p->get_Slides()->idx_get(0)->get_Shapes()->AddPictureFrame(ShapeType::Rectangle, 200.0f, 100.0f, static_cast<float>(ppImage->get_Width()), static_cast<float>(ppImage->get_Height()), ppImage);

// 将演示文稿保存为 PPTX 格式
p->Save(outPptxPath, SaveFormat::Pptx);

将 SVG 转换为形状集合

Aspose.Slides 将 SVG 转换为形状集合的功能类似于 PowerPoint 用于处理 SVG 图像的功能:

PowerPoint Popup Menu

该功能由 IShapeCollection 接口的 AddGroupShape 方法的其中一个重载提供,该重载以 ISvgImage 对象作为第一个参数。以下示例代码演示如何使用上述方法将 SVG 文件转换为形状集合:

// 文档目录的路径
System::String dataDir = u"D:\\Documents\\";

// 源 SVG 文件名
System::String svgFileName = dataDir + u"sample.svg";

// 输出演示文稿文件名
System::String outPptxPath = dataDir + u"presentation.pptx";

// 创建新演示文稿
System::SharedPtr<IPresentation> presentation = System::MakeObject<Presentation>();

// 读取 SVG 文件内容
System::String svgContent = File::ReadAllText(svgFileName);

// 创建 SvgImage 对象
System::SharedPtr<ISvgImage> svgImage = System::MakeObject<SvgImage>(svgContent);

// 获取幻灯片尺寸
System::Drawing::SizeF slideSize = presentation->get_SlideSize()->get_Size();

// 将 SVG 图像转换为形状组,按幻灯片尺寸进行缩放
presentation->get_Slides()->idx_get(0)->get_Shapes()->AddGroupShape(svgImage, 0.f, 0.f, slideSize.get_Width(), slideSize.get_Height());

// 将演示文稿保存为 PPTX 格式
presentation->Save(outPptxPath, SaveFormat::Pptx);

将图像作为 EMF 添加到幻灯片

Aspose.Slides for C++ 允许您从 Excel 工作表生成 EMF 图像,并使用 Aspose.Cells 将这些图像作为 EMF 添加到幻灯片中。以下示例代码演示如何完成上述任务:

System::String dataDir = u"D:\\Documents\\";

StringPtr cellsXls = new String(dataDir.ToWCS().c_str());
cellsXls->Append(L"chart.xls");
intrusive_ptr<Aspose::Cells::IWorkbook> book = Aspose::Cells::Factory::CreateIWorkbook(cellsXls);

intrusive_ptr<Aspose::Cells::IWorksheet> sheet = book->GetIWorksheets()->GetObjectByIndex(0);
intrusive_ptr<Aspose::Cells::Rendering::IImageOrPrintOptions> options = Aspose::Cells::Factory::CreateIImageOrPrintOptions();
options->SetHorizontalResolution(200);
options->SetVerticalResolution(200);
options->SetImageFormat(Aspose::Cells::Systems::Drawing::Imaging::ImageFormat::GetEmf());

// Save the workbook to stream
intrusive_ptr<Aspose::Cells::Rendering::ISheetRender> sr = Aspose::Cells::Factory::CreateISheetRender(sheet, options);

System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>();

pres->get_Slides()->RemoveAt(0);

System::String EmfSheetName;
for (int32_t j = 0; j < sr->GetPageCount(); j++)
{
    EmfSheetName = dataDir + u"test" + System::String::FromWCS(sheet->GetName()->value()) + u" Page" + (j + 1) + u".out.emf";
    sr->ToImage(j, new String(EmfSheetName.ToWCS().c_str()));

    auto bytes = System::IO::File::ReadAllBytes(EmfSheetName);
    auto emfImage = pres->get_Images()->AddImage(bytes);

    System::SharedPtr<ISlide> slide = pres->get_Slides()->AddEmptySlide(pres->get_LayoutSlides()->GetByType(SlideLayoutType::Blank));
    auto slideSize = pres->get_SlideSize()->get_Size();
    slide->get_Shapes()->AddPictureFrame(ShapeType::Rectangle, 0.0f, 0.0f, slideSize.get_Width(), slideSize.get_Height(), emfImage);
}

pres->Save(dataDir + u"Saved.pptx", SaveFormat::Pptx);

替换图像集合中的图像

Aspose.Slides 允许您替换存储在演示文稿图像集合中的图像(包括幻灯片形状使用的图像)。本节展示了更新集合中图像的多种方法。API 提供了使用原始字节数据、IImage 实例或集合中已存在的另一图像来替换图像的直接方法。

  1. 使用 Presentation 类加载包含图像的演示文稿文件。
  2. 将新图像从文件加载到字节数组中。
  3. 使用字节数组将目标图像替换为新图像。
  4. 在第二种方法中,将图像加载到 IImage 对象中并使用该对象替换目标图像。
  5. 在第三种方法中,将目标图像替换为演示文稿图像集合中已经存在的图像。
  6. 将修改后的演示文稿写入为 PPTX 文件。
// 实例化表示演示文稿文件的 Presentation 类。
auto presentation = MakeObject<Presentation>(u"sample.pptx");

// 第一种方法。
auto imageData = File::ReadAllBytes(u"image0.jpeg");
auto oldImage = presentation->get_Image(0);
oldImage->ReplaceImage(imageData);

// 第二种方法。
auto newImage = Images::FromFile(u"image1.png");
oldImage = presentation->get_Image(1);
oldImage->ReplaceImage(newImage);
newImage->Dispose();

// 第三种方法。
oldImage = presentation->get_Image(2);
oldImage->ReplaceImage(presentation->get_Image(3));

// 将演示文稿保存到文件。
presentation->Save(u"output.pptx", SaveFormat::Pptx);
presentation->Dispose();

常见问题

插入后原始图像分辨率是否保持不变?

是的。源像素被保留,但最终显示效果取决于在幻灯片上如何缩放 图片 以及保存时是否进行压缩。

一次性在数十张幻灯片中替换相同徽标的最佳方法是什么?

将徽标放置在母版幻灯片或布局上,并在演示文稿的图像集合中进行替换——更新将传播到所有使用该资源的元素。

插入的 SVG 能否转换为可编辑的形状?

可以。您可以将 SVG 转换为形状组,随后各个部件即可使用标准形状属性进行编辑。

如何一次性将图片设置为多张幻灯片的背景?

在母版幻灯片或相应布局上 将图像指定为背景,使用该母版/布局的所有幻灯片都会继承该背景。

如何防止因大量图片导致演示文稿尺寸“膨胀”?

重复使用单一图像资源而非副本,选择合理的分辨率,保存时进行压缩,并在适当情况下将重复图形放在母版上。