使用 Java 管理演示文稿中的图片框

简介

图片框是一种包含图像的形状——它就像框中的图片。

您可以通过图片框向幻灯片添加图像。这样，您可以通过格式化图片框来对图像进行格式化。

提示

Aspose 提供免费的转换器——JPEG 转 PowerPoint 和 PNG 转 PowerPoint——可帮助用户快速从图像创建演示文稿。

创建图片框

创建一个 Presentation 类的实例。
通过索引获取幻灯片的引用。
通过向与演示对象关联的 IImagescollection 添加图像，创建一个 IPPImage 对象，用于填充形状。
指定图像的宽度和高度。
通过引用幻灯片关联的形状对象提供的 AddPictureFrame 方法，基于图像的宽度和高度创建一个 PictureFrame。
将包含图片的图片框添加到幻灯片。
将修改后的演示文稿写入为 PPTX 文件。

此 Java 代码演示了如何创建图片框：

// 实例化表示 PPTX 文件的 Presentation 类
Presentation pres = new Presentation();
try {
    // 获取第一张幻灯片
    ISlide sld = pres.getSlides().get_Item(0);
    
    // 实例化 Image 类
    IPPImage imgx = pres.getImages().addImage(new FileInputStream(new File("asp1.jpg")));
    
    // 添加一个图片框，其高度和宽度与图片相等
    sld.getShapes().addPictureFrame(ShapeType.Rectangle, 50, 150, imgx.getWidth(), imgx.getHeight(), imgx);
    
    // 将 PPTX 文件写入磁盘
    pres.save("RectPicFrame.pptx", SaveFormat.Pptx);
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

图片框使您能够快速基于图像创建演示幻灯片。将图片框与 Aspose.Slides 的保存选项结合使用时，您可以操作输入/输出以将图像从一种格式转换为另一种格式。您可能想查看以下页面：将图像转换为 JPG；将 JPG 转换为图像；将 JPG 转换为 PNG，将 PNG 转换为 JPG；将 PNG 转换为 SVG，将 SVG 转换为 PNG。

使用相对缩放创建图片框

通过改变图像的相对缩放，您可以创建更复杂的图片框。

创建一个 Presentation 类的实例。
通过索引获取幻灯片的引用。
将图像添加到演示文稿的图像集合中。
通过向与演示对象关联的 IImagescollection 添加图像，创建一个 IPPImage 对象，用于填充形状。
在图片框中指定图像的相对宽度和高度。
将修改后的演示文稿写入为 PPTX 文件。

此 Java 代码演示了如何使用相对缩放创建图片框：

// 实例化表示 PPTX 的 Presentation 类
Presentation pres = new Presentation();
try {
    // 获取第一张幻灯片
    ISlide sld = pres.getSlides().get_Item(0);
    
    // 实例化 Image 类
    IPPImage imgx = pres.getImages().addImage(new FileInputStream(new File("asp1.jpg")));
    
    
    // 添加图片框，其高度和宽度等同于图片
    IPictureFrame pf = sld.getShapes().addPictureFrame(ShapeType.Rectangle, 50, 150, imgx.getWidth(), imgx.getHeight(), imgx);
    
    // 设置相对缩放的高度和宽度
    pf.setRelativeScaleHeight(0.8f);
    pf.setRelativeScaleWidth(1.35f);
    
    // 将 PPTX 文件写入磁盘
    pres.save("RectPicFrame.pptx", SaveFormat.Pptx);
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

从图片框中提取光栅图像

您可以从 PictureFrame 对象中提取光栅图像，并将其保存为 PNG、JPG 等格式。下面的代码示例演示了如何从文档 “sample.pptx” 中提取图像并以 PNG 格式保存。

Presentation presentation = new Presentation("sample.pptx");

try {
    ISlide firstSlide = presentation.getSlides().get_Item(0);
    IShape firstShape = firstSlide.getShapes().get_Item(0);

    if (firstShape instanceof IPictureFrame) {
        IPictureFrame pictureFrame = (IPictureFrame) firstShape;
        try {
			IImage slideImage = pictureFrame.getPictureFormat().getPicture().getImage().getImage();
			slideImage.save("slide_1_shape_1.png", ImageFormat.Png);
		} finally {
			if (slideImage != null) slideImage.dispose();
		}
    }
} catch (IOException e) {
} finally {
    presentation.dispose();
}

从图片框中提取 SVG 图像

当演示文稿在 PictureFrame 形状中包含 SVG 图形时，Aspose.Slides for Java 允许您完整保真地检索原始矢量图像。通过遍历幻灯片的形状集合，您可以识别每个 PictureFrame，检查其底层的 IPPImage 是否包含 SVG 内容，然后将该图像以原生 SVG 格式保存到磁盘或流中。

以下代码示例演示了如何从图片框中提取 SVG 图像：

Presentation presentation = new Presentation("sample.pptx");

try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IShape shape = slide.getShapes().get_Item(0);

    if (shape instanceof IPictureFrame) {
        IPictureFrame pictureFrame = (IPictureFrame) shape;
        ISvgImage svgImage = pictureFrame.getPictureFormat().getPicture().getImage().getSvgImage();

        FileOutputStream fos = new FileOutputStream("output.svg");
        fos.write(svgImage.getSvgData());
        fos.close();
    }
} catch (IOException e) {
    System.out.println(e.getMessage());
} finally {
    presentation.dispose();
}

获取图像的透明度

Aspose.Slides 允许您获取应用于图像的透明度效果。下面的 Java 代码演示了该操作：

Presentation presentation = new Presentation("Test.pptx");

var pictureFrame = (IPictureFrame) presentation.getSlides().get_Item(0).getShapes().get_Item(0);
var imageTransform = pictureFrame.getPictureFormat().getPicture().getImageTransform();
for (var effect : imageTransform) {
    if (effect instanceof IAlphaModulateFixed) {
        var alphaModulateFixed = (IAlphaModulateFixed) effect;
        var transparencyValue = 100 - alphaModulateFixed.getAmount();
        System.out.println("Picture transparency: " + transparencyValue);
    }
}

获取图像的亮度和对比度

Aspose.Slides 允许您获取应用于图像的亮度和对比度效果。ILuminance 接口表示此图像变换效果。

下面的 Java 代码演示了如何从图片框获取亮度和对比度设置：

Presentation presentation = new Presentation("sample.pptx");

try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IShape shape = slide.getShapes().get_Item(0);
    IPictureFrame pictureFrame = (IPictureFrame) shape;

    IImageTransformOperationCollection imageTransform = pictureFrame.getPictureFormat().getPicture().getImageTransform();
    for (IImageTransformOperation effect : imageTransform) {
        if (effect instanceof ILuminance) {
            ILuminanceEffectiveData luminance = ((ILuminance) effect).getEffective();
            float brightness = luminance.getBrightness();
            float contrast = luminance.getContrast();

            System.out.println("Brightness: " + brightness);
            System.out.println("Contrast: " + contrast);
        }
    }
} finally {
    presentation.dispose();
}

图片框格式化

Aspose.Slides 提供了许多可应用于图片框的格式化选项。使用这些选项，您可以对图片框进行调整，以满足特定需求。

创建一个 Presentation 类的实例。
通过索引获取幻灯片的引用。
通过向与演示对象关联的 IImagescollection 添加图像，创建一个 IPPImage 对象，用于填充形状。
指定图像的宽度和高度。
通过 IShapes 对象提供的 AddPictureFrame 方法，基于图像的宽度和高度创建一个 PictureFrame。
将包含图片的图片框添加到幻灯片。
设置图片框的线条颜色。
设置图片框的线条宽度。
通过提供正值或负值来旋转图片框。
- 正值将图像顺时针旋转。
- 负值将图像逆时针旋转。
将包含图片的图片框添加到幻灯片。
将修改后的演示文稿写入为 PPTX 文件。

此 Java 代码演示了图片框格式化过程：

// 实例化表示 PPTX 的 Presentation 类
Presentation pres = new Presentation();
try {
    // 获取第一张幻灯片
    ISlide sld = pres.getSlides().get_Item(0);
    
    // 实例化 Image 类
    IPPImage imgx = pres.getImages().addImage(new FileInputStream(new File("asp1.jpg")));
    
    // 添加图片框，其高度和宽度与图片等同
    IPictureFrame pf = sld.getShapes().addPictureFrame(ShapeType.Rectangle, 50, 150, imgx.getWidth(), imgx.getHeight(), imgx);
    
    // 对 PictureFrameEx 应用一些格式化
    pf.getLineFormat().getFillFormat().setFillType(FillType.Solid);
    pf.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE);
    pf.getLineFormat().setWidth(20);
    pf.setRotation(45);
    
    // 将 PPTX 文件写入磁盘
    pres.save("RectPicFrame.pptx", SaveFormat.Pptx);
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

提示

Aspose 最近开发了一个免费拼贴制作器。如果您需要合并 JPG/JPEG或 PNG 图像，或从照片创建网格，可以使用此服务。

将图像添加为链接

为了避免演示文稿体积过大，您可以通过链接方式添加图像（或视频），而不是直接嵌入文件。下面的 Java 代码演示了如何向占位符中添加图像和视频：

Presentation presentation = new Presentation("input.pptx");
try {
    ArrayList<IShape> shapesToRemove = new ArrayList<IShape>();
    int shapesCount = presentation.getSlides().get_Item(0).getShapes().size();

    for (int i = 0; i < shapesCount; i++)
    {
        IShape autoShape = presentation.getSlides().get_Item(0).getShapes().get_Item(i);

        if (autoShape.getPlaceholder() == null)
        {
            continue;
        }

        switch (autoShape.getPlaceholder().getType())
        {
            case PlaceholderType.Picture:
                IPictureFrame pictureFrame = presentation.getSlides().get_Item(0).getShapes().addPictureFrame(ShapeType.Rectangle,
                        autoShape.getX(), autoShape.getY(), autoShape.getWidth(), autoShape.getHeight(), null);

                pictureFrame.getPictureFormat().getPicture().setLinkPathLong(
                        "https://upload.wikimedia.org/wikipedia/commons/3/3a/I.M_at_Old_School_Public_Broadcasting_in_October_2016_02.jpg");

                shapesToRemove.add(autoShape);
                break;

            case PlaceholderType.Media:
                IVideoFrame videoFrame = presentation.getSlides().get_Item(0).getShapes().addVideoFrame(
                        autoShape.getX(), autoShape.getY(), autoShape.getWidth(), autoShape.getHeight(), "");

                videoFrame.getPictureFormat().getPicture().setLinkPathLong(
                        "https://upload.wikimedia.org/wikipedia/commons/3/3a/I.M_at_Old_School_Public_Broadcasting_in_October_2016_02.jpg");

                videoFrame.setLinkPathLong("https://youtu.be/t_1LYZ102RA");

                shapesToRemove.add(autoShape);
                break;
        }
    }

    for (IShape shape : shapesToRemove)
    {
        presentation.getSlides().get_Item(0).getShapes().remove(shape);
    }

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

裁剪图像

下面的 Java 代码演示了如何裁剪幻灯片上已有的图像：

Presentation pres = new Presentation();
// 创建新的图像对象
try {
    IPPImage picture;
    IImage image = Images.fromFile(imagePath);
    try {
        picture = pres.getImages().addImage(image);
    } finally {
        if (image != null) image.dispose();
    }

    // 向幻灯片添加图片框
    IPictureFrame picFrame = pres.getSlides().get_Item(0).getShapes().addPictureFrame(
            ShapeType.Rectangle, 100, 100, 420, 250, picture);

    // 裁剪图像（百分比值）
    picFrame.getPictureFormat().setCropLeft(23.6f);
    picFrame.getPictureFormat().setCropRight(21.5f);
    picFrame.getPictureFormat().setCropTop(3);
    picFrame.getPictureFormat().setCropBottom(31);

    // 保存结果
    pres.save(outPptxFile, SaveFormat.Pptx);
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

删除图片的裁剪区域

如果您想删除框中图像的裁剪区域，可以使用 deletePictureCroppedAreas() 方法。该方法在不需要裁剪时返回原始图像，否则返回裁剪后的图像。

此 Java 代码演示了该操作：

Presentation presentation = new Presentation("PictureFrameCrop.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    // 获取第一张幻灯片上的 PictureFrame
    IPictureFrame picFrame = (IPictureFrame)slide.getShapes().get_Item(0);

    // 删除 PictureFrame 图像的裁剪区域并返回裁剪后的图像
    IPPImage croppedImage = picFrame.getPictureFormat().deletePictureCroppedAreas();

    // 保存结果
    presentation.save("PictureFrameDeleteCroppedAreas.pptx", SaveFormat.Pptx);
} finally {
    if (presentation != null) presentation.dispose();
}

注释

deletePictureCroppedAreas() 方法会将裁剪后的图像添加到演示文稿的图像集合中。如果该图像仅在已处理的 PictureFrame 中使用，此设置可以减小演示文稿的体积。否则，生成的演示文稿中的图像数量会增加。

该方法在裁剪操作中会将 WMF/EMF 元文件转换为光栅 PNG 图像。

压缩图像

您可以使用 IPictureFillFormat.compressImage 方法压缩演示文稿中的图片。该方法通过根据形状大小和指定分辨率降低图像大小，并可选择删除裁剪区域，从而实现压缩。

它的效果类似于 PowerPoint 的 图片格式 → 压缩图片 → 分辨率 功能。

下面的 Java 示例演示了如何通过指定目标分辨率并可选删除裁剪区域来压缩演示文稿中的图像：

Presentation presentation = new Presentation("demo.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IPictureFrame pictureFrame = (IPictureFrame)slide.getShapes().get_Item(0);

    // 使用目标分辨率 150 DPI（网页分辨率）压缩图像并删除裁剪区域。
    boolean result = pictureFrame.getPictureFormat().compressImage(true, PicturesCompression.Dpi150);

    // 检查压缩结果。
    if (result) {
        System.out.println("Image successfully compressed.");
    } else {
        System.out.println("Image compression failed or no changes were necessary.");
    }

    presentation.save("CompressedImage.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

或直接使用自定义 DPI 值：

Presentation presentation = new Presentation("demo.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IPictureFrame pictureFrame = (IPictureFrame)slide.getShapes().get_Item(0);

    // 将图像压缩至 150 DPI（网页分辨率），并删除裁剪区域。
    pictureFrame.getPictureFormat().compressImage(true, 150f);

    presentation.save("CompressedImage.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

注释

该方法根据形状大小和提供的 DPI 将图像转换为较低分辨率。裁剪区域也可以被删除以优化文件大小。
如果图像是元文件（WMF/EMF）或 SVG，则不会进行压缩。JPEG 的质量会根据分辨率保持或略有下降，类似于 PowerPoint 处理高分辨率 JPEG 的方式。

锁定宽高比

如果您希望包含图像的形状在更改图像尺寸后仍保持宽高比，可以使用 setAspectRatioLocked 方法设置 锁定宽高比。

下面的 Java 代码演示了如何锁定形状的宽高比：

Presentation pres = new Presentation("pres.pptx");
try {
    ILayoutSlide layout = pres.getLayoutSlides().getByType(SlideLayoutType.Custom);
    ISlide emptySlide = pres.getSlides().addEmptySlide(layout);
    IPPImage picture;
    IImage image = Images.fromFile("image.png");
    try {
        picture = pres.getImages().addImage(image);
    } finally {
        if (image != null) image.dispose();
    }
    IPictureFrame pictureFrame = emptySlide.getShapes().addPictureFrame(
            ShapeType.Rectangle, 50, 150, presImage.getWidth(), presImage.getHeight(), picture);

    // 设置形状在调整大小时保持宽高比
    pictureFrame.getPictureFrameLock().setAspectRatioLocked(true);
} catch(IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

注释

此 锁定宽高比 设置仅保留形状的宽高比，而不影响其内部图像。

使用 StretchOff 属性

使用来自 IPictureFillFormat 接口和 PictureFillFormat 类的 StretchOffsetLeft、StretchOffsetTop、StretchOffsetRight 与 StretchOffsetBottom 属性，您可以指定填充矩形。

当对图像指定拉伸时，源矩形会按比例缩放以适应指定的填充矩形。填充矩形的每条边由相对于形状边界框相应边的百分比偏移定义。正百分比表示内缩，负百分比表示外延。

创建一个 Presentation 类的实例。
通过索引获取幻灯片的引用。
添加一个矩形 AutoShape。
创建图像。
设置形状的填充类型。
设置形状的图片填充模式。
添加设置的图像以填充形状。
指定图像相对于形状边界框相应边的偏移。
将修改后的演示文稿写入为 PPTX 文件。

此 Java 代码演示了使用 StretchOff 属性的过程：

// 实例化表示 PPTX 文件的 Presentation 类
Presentation pres = new Presentation();
try {
    // 获取第一张幻灯片
    ISlide slide = pres.getSlides().get_Item(0);

    // 实例化 ImageEx 类
    IPPImage picture;
    IImage image = Images.fromFile("aspose-logo.jpg");
    try {
        picture = pres.getImages().addImage(image);
    } finally {
        if (image != null) image.dispose();
    }

    // 添加一个设置为矩形的 AutoShape
    IAutoShape aShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 300, 300);

    // 设置形状的填充类型
    aShape.getFillFormat().setFillType(FillType.Picture);

    // 设置形状的图片填充模式
    aShape.getFillFormat().getPictureFillFormat().setPictureFillMode(PictureFillMode.Stretch);

    // 设置图像以填充形状
    aShape.getFillFormat().getPictureFillFormat().getPicture().setImage(picture);

    // 指定图像相对于形状边界框相应边的偏移
    aShape.getFillFormat().getPictureFillFormat().setStretchOffsetLeft(25);
    aShape.getFillFormat().getPictureFillFormat().setStretchOffsetRight(25);
    aShape.getFillFormat().getPictureFillFormat().setStretchOffsetTop(-20);
    aShape.getFillFormat().getPictureFillFormat().setStretchOffsetBottom(-10);
    
    // 将 PPTX 文件写入磁盘
    pres.save("StretchOffsetLeftForPictureFrame_out.pptx", SaveFormat.Pptx);
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

常见问题

如何了解 PictureFrame 支持的图像格式？

Aspose.Slides 通过分配给 PictureFrame 的图像对象，支持光栅图像（PNG、JPEG、BMP、GIF 等）和矢量图像（例如 SVG）。支持的格式列表通常与幻灯片和图像转换引擎的功能相吻合。

大量大型图像会如何影响 PPTX 大小和性能？

嵌入大型图像会增加文件大小和内存使用；通过链接图像可以降低演示文稿大小，但需要确保外部文件保持可访问。Aspose.Slides 提供通过链接方式添加图像的功能，以减小文件体积。

如何锁定图像对象，防止意外移动/缩放？

对 PictureFrame 使用形状锁定（例如，禁用移动或缩放）。锁定机制在针对形状的保护文章中有详细说明，适用于包括 PictureFrame 在内的多种形状类型。

导出演示文稿为 PDF/图像时，SVG 矢量保真度是否得到保留？

Aspose.Slides 允许从 PictureFrame 中提取原始 SVG 矢量图像。对 PDF（/slides/zh/java/convert-powerpoint-to-pdf/）或光栅格式（/slides/zh/java/convert-powerpoint-to-png/）的导出可能会根据导出设置进行光栅化；提取行为确认了原始 SVG 仍以矢量形式存储。