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

本页内容简介

使用 Aspose.Slides for Node.js（通过 Java）在演示文稿中创建、格式化、链接、裁剪、提取和压缩图片框。

概述

图片框是显示图像的幻灯片形状。在 Aspose.Slides 中，图像资源和显示它的形状是分离的对象：一个 Presentation 通过其 ImageCollection 拥有嵌入的图像资源，而 PictureFrame 控制图像的位置、大小、线条格式、旋转、裁剪、图片效果以及其他框级设置。

这种分离在同一图像需要显示多次时非常有用。将图像一次添加到演示文稿中，保留返回的 PPImage，在创建图片框时使用该图像资源。

图片框可以包含 PNG 或 JPEG 等光栅图像，也可以包含 SVG 矢量图像。它们还可以引用链接图像，而不是将图像字节存储在演示文稿中。选择哪种方式会影响可移植性、文件大小、提取和导出行为，因此在进行格式设置或优化之前，最好先决定图像的存储方式。

添加并格式化嵌入图像

对于嵌入图像，将图像数据添加到演示文稿并使用 ShapeCollection.addPictureFrame 创建图片框。图像会成为演示文稿包的一部分，因此在将演示文稿移动到另一台计算机时仍保持自包含。

下面的示例添加了一张 PNG 图像，按图像的原始尺寸创建框，并应用线条格式和旋转：

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    let image;
    const sourceImage = aspose.slides.Images.fromFile("image.png");
    try {
        image = presentation.getImages().addImage(sourceImage);
    } finally {
        sourceImage.dispose();
    }

    const pictureFrame = slide.getShapes().addPictureFrame(aspose.slides.ShapeType.Rectangle, 50, 100, image.getWidth(), image.getHeight(), image);
    pictureFrame.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    pictureFrame.getLineFormat().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLUE"));
    pictureFrame.getLineFormat().setWidth(3);
    pictureFrame.setRotation(15);

    presentation.save("picture-frame.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

图片框控制显示的几何形状；更改框的大小不会改变嵌入图像资源中存储的原始像素尺寸。此区别在后续对图像进行裁剪或压缩时尤为重要。

使用相对比例

PictureFrame 通过 setRelativeScaleWidth 和 setRelativeScaleHeight 提供相对宽度和高度的缩放。值为 1.0 对应原始图片大小的 100%。相对比例在需要保留与源图像尺寸的相对关系而不是手动计算最终尺寸的工作流中非常有用。

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    let image;
    const sourceImage = aspose.slides.Images.fromFile("image.png");
    try {
        image = presentation.getImages().addImage(sourceImage);
    } finally {
        sourceImage.dispose();
    }

    const pictureFrame = slide.getShapes().addPictureFrame(aspose.slides.ShapeType.Rectangle, 50, 50, 100, 100, image);
    pictureFrame.setRelativeScaleWidth(java.newFloat(1.35));
    pictureFrame.setRelativeScaleHeight(java.newFloat(0.8));

    presentation.save("relative-scale.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

相对比例仅更改框的缩放设置；它不会重新采样或压缩嵌入的图像。

嵌入图像和链接图像

嵌入图片将图像数据存储在演示文稿内部，是可移植性和可预测渲染最安全的选择。链接图片则通过 Picture.setLinkPathLong 方法存储外部位置，而不是以相同方式嵌入图像数据。

链接图像可以减小 PPTX 中的图像数据量，但会引入外部依赖。链接的文件必须保持对打开或渲染演示文稿的应用程序可访问。如果路径更改、文件移动或资源不可用，链接图片可能无法如预期显示。对于需要通过电子邮件发送、归档或在隔离环境中渲染的演示文稿，嵌入图像通常更可靠。

添加链接图像

下面的示例创建一个图片框并指向本地图像文件。它仅处理图像链接；视频链接是另一套媒体工作流，故此示例中未混入。

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const path = require("path");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const pictureFrame = slide.getShapes().addPictureFrame(aspose.slides.ShapeType.Rectangle, 50, 50, 320, 180, null);
    const linkPath = path.resolve("image.png");
    pictureFrame.getPictureFormat().getPicture().setLinkPathLong(linkPath);

    presentation.save("linked-image.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

在有意进行外部文件管理时使用链接。不要仅将其用作压缩的替代方案：一个带有损坏图像依赖关系的轻量 PPTX 往往不如一个更大的自包含演示文稿实用。

从图片框提取图像

在从现有演示文稿中提取图像之前，首先检查形状是否实际为 PictureFrame 且是否包含嵌入图像。链接图片框可能不包含可用的图像字节，无法以相同方式提取。

提取光栅图像

最新的图像 API 直接使用 IImage。下面的示例在幻灯片上找到第一个嵌入的光栅图片并保存为 PNG：

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

const presentation = new aspose.slides.Presentation("input.pptx");
try {
    const slide = presentation.getSlides().get_Item(0);

    for (let i = 0; i < slide.getShapes().size(); i++) {
        const shape = slide.getShapes().get_Item(i);
        if (!java.instanceOf(shape, "com.aspose.slides.IPictureFrame")) {
            continue;
        }

        const embeddedImage = shape.getPictureFormat().getPicture().getImage();
        if (embeddedImage == null || embeddedImage.getSvgImage() != null) {
            continue;
        }

        const rasterImage = embeddedImage.getImage();
        try {
            rasterImage.save("extracted-image.png", aspose.slides.ImageFormat.Png);
        } finally {
            rasterImage.dispose();
        }
        break;
    }
} finally {
    presentation.dispose();
}

通过 IImage.save 保存会将提取的图像转换为请求的输出格式。如果需要演示文稿中存储的编码字节而不是已转换的光栅文件，请使用图像资源的二进制数据。

提取 SVG 图像

对于 SVG 图片，PPImage 暴露出一个 SvgImage 对象。这样可以直接检索 SVG 数据，而无需先栅格化图片。

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const fs = require("fs");
const java = require("java");

const presentation = new aspose.slides.Presentation("input.pptx");
try {
    const slide = presentation.getSlides().get_Item(0);

    for (let i = 0; i < slide.getShapes().size(); i++) {
        const shape = slide.getShapes().get_Item(i);
        if (!java.instanceOf(shape, "com.aspose.slides.IPictureFrame")) {
            continue;
        }

        const embeddedImage = shape.getPictureFormat().getPicture().getImage();
        const svgImage = embeddedImage != null ? embeddedImage.getSvgImage() : null;
        if (svgImage == null) {
            continue;
        }

        fs.writeFileSync("extracted-image.svg", svgImage.getSvgData());
        break;
    }
} finally {
    presentation.dispose();
}

将 SVG 内容保持为 SVG 可以在演示文稿内部保留矢量源。PNG 或 JPEG 等光栅导出必然将该矢量内容渲染为像素。PDF 或 SVG 幻灯片导出也是一种渲染操作，因此导出的图形不应被视为原始嵌入 SVG 的逐字节拷贝；当需要原始矢量资源本身时，请使用嵌入的 SvgImage.getSvgData 数据。

裁剪图像

裁剪会改变帧内可见的图像部分。PictureFillFormat 上的裁剪值以源图像尺寸的百分比表示。裁剪不会立即从嵌入的图像中删除隐藏的像素；它仅改变可见区域。

下面的示例安全地找到图片框并应用裁剪值：

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

const presentation = new aspose.slides.Presentation("input.pptx");
try {
    const slide = presentation.getSlides().get_Item(0);
    let pictureFrame = null;

    for (let i = 0; i < slide.getShapes().size(); i++) {
        const shape = slide.getShapes().get_Item(i);
        if (java.instanceOf(shape, "com.aspose.slides.IPictureFrame")) {
            pictureFrame = shape;
            break;
        }
    }

    if (pictureFrame != null) {
        pictureFrame.getPictureFormat().setCropLeft(java.newFloat(23.6));
        pictureFrame.getPictureFormat().setCropRight(java.newFloat(21.5));
        pictureFrame.getPictureFormat().setCropTop(java.newFloat(3));
        pictureFrame.getPictureFormat().setCropBottom(java.newFloat(31));
        presentation.save("cropped-image.pptx", aspose.slides.SaveFormat.Pptx);
    }
} finally {
    presentation.dispose();
}

因为隐藏的图像数据仍然存在，裁剪可以在以后更改而不会丢失原始像素。如果文件大小比可逆性更重要，可以按照下一节所述物理删除裁剪区域。

删除裁剪图像数据

PictureFillFormat.deletePictureCroppedAreas 会删除当前裁剪矩形之外的图像数据并返回结果图像资源。这可以减小文件大小，但是一种破坏性优化：演示文稿保存后，被删除的像素将不再可用于后续的取消裁剪操作。

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

const presentation = new aspose.slides.Presentation("input.pptx");
try {
    const slide = presentation.getSlides().get_Item(0);
    let pictureFrame = null;

    for (let i = 0; i < slide.getShapes().size(); i++) {
        const shape = slide.getShapes().get_Item(i);
        if (java.instanceOf(shape, "com.aspose.slides.IPictureFrame")) {
            pictureFrame = shape;
            break;
        }
    }

    if (pictureFrame != null) {
        const croppedImage = pictureFrame.getPictureFormat().deletePictureCroppedAreas();
        if (croppedImage != null) {
            presentation.save("cropped-data-removed.pptx", aspose.slides.SaveFormat.Pptx);
        }
    }
} finally {
    presentation.dispose();
}

该方法可能会向演示文稿添加一个新图像资源。如果原始图像也被其他图片框使用，这些框仍需要其现有资源，因此删除裁剪区域不一定会减少图像总数。使用此方法裁剪 WMF 或 EMF 内容会将裁剪结果栅格化为 PNG。

压缩光栅图像

PictureFillFormat.compressImage 根据图片显示的尺寸相对降低光栅图像分辨率。它还可以在同一次操作中删除裁剪区域。当图像被重新大小或裁剪时返回 true，若无需更改则返回 false。

当标准目标分辨率足够时，可使用预定义的 PicturesCompression 值：

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

const presentation = new aspose.slides.Presentation("input.pptx");
try {
    const slide = presentation.getSlides().get_Item(0);
    let pictureFrame = null;

    for (let i = 0; i < slide.getShapes().size(); i++) {
        const shape = slide.getShapes().get_Item(i);
        if (java.instanceOf(shape, "com.aspose.slides.IPictureFrame")) {
            pictureFrame = shape;
            break;
        }
    }

    if (pictureFrame != null) {
        const compressed = pictureFrame.getPictureFormat().compressImage(true, aspose.slides.PicturesCompression.Dpi150);
        console.log(compressed ? "The image was compressed." : "No compression was necessary.");
        presentation.save("compressed-image.pptx", aspose.slides.SaveFormat.Pptx);
    }
} finally {
    presentation.dispose();
}

如果需要特定目标分辨率，也可以传入自定义的正 DPI 值。

压缩旨在针对光栅图像。SVG 和元文件内容不会通过此光栅压缩工作流降低。还要记住，降低分辨率和删除裁剪区域后，无法从优化后的演示文稿中恢复。应根据图像实际观看或导出的最大尺寸来选择目标分辨率，而不是全局使用最低 DPI。

管理图像变换效果

关于亮度、对比度、颜色变换、模糊、透明度效果、有序链、检查、移除以及往返验证的完整工作流，请参见 Image Transform Effects。

锁定图片框几何形状

PictureFrameLock 设置控制哪些编辑操作对图片框被禁用。例如，setAspectRatioLocked 在调整大小时保持形状的比例。

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    let image;
    const sourceImage = aspose.slides.Images.fromFile("image.png");
    try {
        image = presentation.getImages().addImage(sourceImage);
    } finally {
        sourceImage.dispose();
    }

    const pictureFrame = slide.getShapes().addPictureFrame(aspose.slides.ShapeType.Rectangle, 50, 100, image.getWidth(), image.getHeight(), image);
    pictureFrame.getPictureFrameLock().setAspectRatioLocked(true);

    presentation.save("locked-picture-frame.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

锁定作用于图片框形状本身，并不强制对源图像进行重新采样或永久改变其比例。

调整 StretchOffset 值

当图片填充模式为 stretch 时，PictureFillFormat 上的 stretch‑offset 值相对于图片框的边界框定义填充矩形。正百分比会从边缘向内收缩，负百分比会向外延伸。

这与裁剪不同。裁剪值决定源图像的可见部分；stretch offset 改变可见图片填充被拉伸到的矩形。

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    let image;
    const sourceImage = aspose.slides.Images.fromFile("image.png");
    try {
        image = presentation.getImages().addImage(sourceImage);
    } finally {
        sourceImage.dispose();
    }

    const pictureFrame = slide.getShapes().addPictureFrame(aspose.slides.ShapeType.Rectangle, 10, 10, 400, 300, image);
    pictureFrame.getPictureFormat().setPictureFillMode(java.newByte(aspose.slides.PictureFillMode.Stretch));
    pictureFrame.getPictureFormat().setStretchOffsetLeft(java.newFloat(12));
    pictureFrame.getPictureFormat().setStretchOffsetRight(java.newFloat(12));
    pictureFrame.getPictureFormat().setStretchOffsetTop(java.newFloat(8));
    pictureFrame.getPictureFormat().setStretchOffsetBottom(java.newFloat(8));

    presentation.save("stretch-offsets.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

使用 stretch offset 来定位填充。若目的是隐藏源图像的边缘，请使用裁剪属性。

存储、文件大小和导出考虑因素

当图像存储和图片框格式分开处理时，主要权衡更易管理：

嵌入图像 使演示文稿自包含，是共享和服务器端渲染最可靠的选择，但大型光栅图像会增加 PPTX 大小和内存使用。
链接图像 可以保持包体积更小，但演示文稿依赖外部文件在存储路径或位置保持可用。
裁剪起初是非破坏性的。隐藏的像素会一直嵌入，直到显式删除裁剪区域或在压缩时移除。
压缩可以显著减小超大光栅图像的文件大小，但会牺牲源分辨率。应在确定幻灯片上实际显示尺寸后再应用。
SVG 图像 在需要保留矢量时应保持为 SVG。需要矢量资源本身时直接提取嵌入的 SVG。光栅幻灯片导出始终将渲染的幻灯片转换为像素。
重复图像 应尽可能复用已有的 PPImage 资源，而不是在演示文稿工作流中反复加载同一文件。

对于大型演示文稿，图像优化通常在有针对性地执行时最有效：将标志和图表保持为矢量内容，根据实际显示尺寸压缩照片，仅在不需要后续编辑时删除裁剪像素，并除非部署设计中已考虑依赖管理，否则避免使用外部链接。

常见问答

图片框与图像资源有什么区别？

PPImage 表示与演示文稿关联的图像资源。PictureFrame 是幻灯片上的形状，用于显示图像并存储框级几何和格式（如尺寸、旋转、裁剪值、效果和锁）。

应该嵌入还是链接图像？

在演示文稿必须可移植、归档或在没有外部资源的情况下渲染时嵌入图像。仅在有意将图像文件保留在 PPTX 外部且可以可靠维护外部位置时才使用链接图像。

裁剪会减小 PPTX 文件大小吗？

单独裁剪不会。普通的裁剪设置会隐藏源图像的部分，但仍保留底层像素。需要使用 PictureFillFormat.deletePictureCroppedAreas 或在压缩时删除裁剪区域，才能永久丢弃这些像素。

压缩后可以恢复图像质量吗？

不能。压缩会降低存储的光栅分辨率，删除裁剪区域会丢弃图像数据。如果以后可能需要高分辨率编辑，请在演示文稿外保留原始源图像。

SVG 图像应如何处理？

在矢量保真度重要时保持 SVG 内容为 SVG。嵌入的 SvgImage 可直接提取。将幻灯片渲染为 PNG 或 JPEG 等光栅格式会将 SVG 栅格化为幻灯片图像的一部分。

读取现有幻灯片时如何避免不安全的强制转换？

在使用图片框特有成员之前检查形状类型。对 PictureFrame 进行 java.instanceOf 检查，可避免无效的强制转换，并让代码能够处理不包含图片框的幻灯片。

演示文稿查看器