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

幻灯片中的图像

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

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

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

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

Presentation pres = new Presentation();
try {
	ISlide slide = pres.getSlides().get_Item(0);
	    IPPImage picture;
        IImage image = Images.fromFile("image.png");
        try {
            picture = pres.getImages().addImage(image);
        } finally {
            if (image != null) image.dispose();
        }
	slide.getShapes().addPictureFrame(ShapeType.Rectangle, 10, 10, 100, 100, picture);

	pres.save("pres.pptx", SaveFormat.Pptx);
} finally {
	if (pres != null) pres.dispose();
}

从网络向幻灯片添加图像

如果要添加的图像在计算机上不可用,您可以直接从网络添加该图像。

以下示例代码展示了如何在 Java 中将网络图像添加到幻灯片:

Presentation pres = new Presentation();
try {
	ISlide slide = pres.getSlides().get_Item(0);

	URL imageUrl = new URL("[REPLACE WITH URL]");
	URLConnection connection = imageUrl.openConnection();
	InputStream inputStream = connection.getInputStream();

	ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
	try {
		byte[] buffer = new byte[1024];
		int read;

		while ((read = inputStream.read(buffer, 0, buffer.length)) != -1)
			outputStream.write(buffer, 0, read);

		outputStream.flush();

		IPPImage image = pres.getImages().addImage(outputStream.toByteArray());
		slide.getShapes().addPictureFrame(ShapeType.Rectangle, 10, 10, 100, 100, image);
	} finally {
		if (inputStream != null) inputStream.close();
		outputStream.close();
	}

	pres.save("pres.pptx", SaveFormat.Pptx);
} catch(IOException e) {
} finally {
	if (pres != null) pres.dispose();
}

向母版幻灯片添加图像

母版幻灯片是存储并控制其下所有幻灯片信息(主题、布局等)的顶层幻灯片。因此,在母版上添加的图像会出现在该母版下的每一张幻灯片中。

以下 Java 示例代码展示了如何向母版添加图像:

Presentation pres = new Presentation();
try {
	ISlide slide = pres.getSlides().get_Item(0);
	IMasterSlide masterSlide = slide.getLayoutSlide().getMasterSlide();

    IPPImage picture;
    IImage image = Images.fromFile("image.png");
    try {
        picture = pres.getImages().addImage(image);
    } finally {
        if (image != null) image.dispose();
    }
	masterSlide.getShapes().addPictureFrame(ShapeType.Rectangle, 10, 10, 100, 100, picture);

	pres.save("pres.pptx", SaveFormat.Pptx);
} finally {
	if (pres != null) pres.dispose();
}

将图像设为幻灯片背景

您可能决定将图片设为特定幻灯片或多张幻灯片的背景。此时,请参阅 Setting Images as Backgrounds for Slides

向演示文稿添加 SVG

您可以使用属于 IShapeCollection 接口的 addPictureFrame 方法将任意图像插入演示文稿。

要基于 SVG 图像创建图像对象,可按以下方式操作:

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

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

// 实例化表示 PPTX 文件的 Presentation 类
Presentation pres = new Presentation();
try {
    String svgContent = new String(Files.readAllBytes(Paths.get("image.svg")));
    ISvgImage svgImage = new SvgImage(svgContent);
    IPPImage ppImage = pres.getImages().addImage(svgImage);
    pres.getSlides().get_Item(0).getShapes().addPictureFrame(ShapeType.Rectangle, 0, 0, 
            ppImage.getWidth(), ppImage.getHeight(), ppImage);
    pres.save("output.pptx", SaveFormat.Pptx);
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

将 SVG 转换为形状集合

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

PowerPoint Popup Menu

该功能由 IShapeCollection 接口的一个重载的 addGroupShape 方法提供,该方法的第一个参数接受 ISvgImage 对象。

以下示例代码展示了如何使用该方法将 SVG 文件转换为形状集合:

// 创建新演示文稿
IPresentation presentation = new Presentation();
try {
    // 读取 SVG 文件内容
    byte[] svgContent = Files.readAllBytes(Paths.get("image.svg"));

    // 创建 SvgImage 对象
    ISvgImage svgImage = new SvgImage(svgContent);

    // 获取幻灯片尺寸
    Dimension2D slideSize = presentation.getSlideSize().getSize();

    // 将 SVG 图像转换为形状组,并按幻灯片尺寸缩放
    presentation.getSlides().get_Item(0).getShapes().
            addGroupShape(svgImage, 0f, 0f, (float)slideSize.getWidth(), (float)slideSize.getHeight());

    // 以 PPTX 格式保存演示文稿
    presentation.save("output.pptx", SaveFormat.Pptx);
} catch (IOException e) {
} finally {
    if (presentation != null) presentation.dispose();
}

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

Aspose.Slides for Java 允许您从 Excel 工作表生成 EMF 图像,并使用 Aspose.Cells 将这些图像以 EMF 形式添加到幻灯片中。

以下示例代码展示了如何完成上述任务:

Workbook book = new Workbook("chart.xlsx");
Worksheet sheet = book.getWorksheets().get(0);
ImageOrPrintOptions options = new ImageOrPrintOptions();
options.setHorizontalResolution(200);
options.setVerticalResolution(200);
options.setImageType(ImageType.EMF);

//Save the workbook to stream
SheetRender sr = new SheetRender(sheet, options);
Presentation pres = new Presentation();
try {
    pres.getSlides().removeAt(0);
    
    String EmfSheetName = "";
    for (int j = 0; j < sr.getPageCount(); j++)
    {
    
        EmfSheetName = "test" + sheet.getName() + " Page" + (j + 1) + ".out.emf";
        sr.toImage(j, EmfSheetName);

        IPPImage picture;
        IImage image = Images.fromFile(EmfSheetName);
        try {
            picture = pres.getImages().addImage(image);
        } finally {
            if (image != null) image.dispose();
        }
        ISlide slide = pres.getSlides().addEmptySlide(pres.getLayoutSlides().getByType(SlideLayoutType.Blank));
        IShape m = slide.getShapes().addPictureFrame(ShapeType.Rectangle, 0, 0,
					(float)pres.getSlideSize().getSize().getWidth(), 
					(float)pres.getSlideSize().getSize().getHeight(), 
					picture);
    }
    
    pres.save("output.pptx", SaveFormat.Pptx);
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

替换图像集合中的图像

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

请按以下步骤操作:

  1. 使用 Presentation 类加载包含图像的演示文稿文件。
  2. 将新图像从文件加载到字节数组。
  3. 使用字节数组将目标图像替换为新图像。
  4. 在第二种方法中,将图像加载为 IImage 对象,并使用该对象替换目标图像。
  5. 在第三种方法中,将目标图像替换为演示文稿图像集合中已存在的图像。
  6. 将修改后的演示文稿写入为 PPTX 文件。
// 实例化表示演示文稿文件的 Presentation 类。
Presentation presentation = new Presentation("sample.pptx");
try {
    // 第一种方法。
    byte[] imageData = Files.readAllBytes(Paths.get("image0.jpeg"));
    IPPImage oldImage = presentation.getImages().get_Item(0);
    oldImage.replaceImage(imageData);
    
    // 第二种方法。
    IImage newImage = Images.fromFile("image1.png");
    oldImage = presentation.getImages().get_Item(1);
    oldImage.replaceImage(newImage);
    newImage.dispose();
    
    // 第三种方法。
    oldImage = presentation.getImages().get_Item(2);
    oldImage.replaceImage(presentation.getImages().get_Item(3));
    
    // 将演示文稿保存到文件。
    presentation.save("output.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

常见问题

插入后原始图像分辨率是否保持不变?
是的。源像素得以保留,但最终显示效果取决于幻灯片上 picture 的缩放方式以及保存时是否进行压缩。

一次性替换数十张幻灯片中的相同徽标的最佳方法是什么?
将徽标放置在母版或布局上,并在演示文稿的图像集合中进行替换——这样所有使用该资源的元素都会同步更新。

插入的 SVG 能否转换为可编辑的形状?
可以。您可以将 SVG 转换为形状组,之后各个部件即可通过标准形状属性进行编辑。

如何一次性为多张幻灯片设置图片背景?
在母版或相应布局上 Assign the image as the background,使用该母版/布局的所有幻灯片都会继承该背景。

如何防止由于大量图片导致演示文稿体积“膨胀”?
复用单一图像资源而非复制多个,选择合适的分辨率,保存时启用压缩,并在适当位置将重复图形放置在母版上。