管理 Android 上簡報中的圖片框

簡介

圖片框是一種包含影像的形狀──就像在框架中的圖片。

您可以透過圖片框將影像加入投影片。這樣就能透過格式化圖片框來格式化影像。

提示

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

建立相對比例的圖片框

透過調整影像的相對縮放，您可以建立更複雜的圖片框。

建立 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 Android（透過 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 的 Picture Format > Compress Pictures > Resolution 功能相似。

以下 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 方法設定 Lock Aspect Ratio 屬性。

以下 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();
}

注意

此 Lock Aspect Ratio 設定僅保留形狀本身的寬高比，並不影響其內含的影像。

使用 StretchOff 屬性

使用 StretchOffsetLeft、StretchOffsetTop、StretchOffsetRight 與 StretchOffsetBottom 屬性，透過 IPictureFillFormat 介面及 PictureFillFormat 類別，您可以指定填充矩形。

當對影像指定拉伸時，來源矩形會依據指定的填充矩形比例縮放。填充矩形的每一邊皆以相對於形狀邊界框相應邊緣的百分比偏移來定義。正百分比代表內縮，負百分比代表外延。

建立 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 提供透過連結加入影像的功能，以降低檔案體積。

如何防止影像物件被意外移動或調整大小？

可使用 shape locks 針對 PictureFrame 設定鎖定（例如停用移動或調整大小）。此鎖定機制支援多種形狀類型，包括 PictureFrame。

匯出簡報為 PDF 或影像時，SVG 向量的保真度是否得以保留？

Aspose.Slides 允許從 PictureFrame 提取 SVG 作為原始向量。匯出至 PDF 或點陣格式（如 PNG）時，結果可能會根據匯出設定被點陣化；然而，透過提取行為可驗證原始 SVG 仍以向量形式儲存。