在 Android 上管理簡報中的影像變換效果

本頁內容簡介

使用 Aspose.Slides for Android（Java）套用、鏈結、檢查、移除並驗證圖片框的影像變換效果。

概觀

Aspose.Slides 將圖片調整表示為有序的影像變換操作集合。對於圖片框，從框的 ISlidesPicture 開始，存取 ISlidesPicture.getImageTransform。回傳的 IImageTransformOperationCollection 讓您可以追加、列舉、檢查、移除以及清除效果，而不必重新寫入原始影像位元組。

本文示範了完整的工作流程，包括亮度與對比度、顏色變換、模糊、透明度、有序效果鏈、有效值、移除以及 PPTX 循環驗證。

了解效果所有權與影像重複使用

影像資源與顯示該影像的圖片是不同的物件：

IPPImage 儲存或參照簡報擁有的來源影像資料。
ISlidesPicture 屬於圖片填色，參照影像資源，同時儲存影像變換集合。
IPictureFrame 為投影片形狀，擁有相關的圖片填色、幾何、裁切設定以及其他框層級格式。

因此，影像變換操作不會修改 IPPImage 中的位元組。當同一個 IPPImage 被多次傳遞給 IShapeCollection.addPictureFrame 時，每個新圖片框都會取得自己的 ISlidesPicture 與自己的變換集合。對其中一個框套用灰階不會使其他框變成灰階，即使它們共用相同的嵌入式影像資源。

相同的 ISlidesPicture.getImageTransform 模型也被其他圖片填色使用，例如形狀或投影片背景。以下範例聚焦於圖片框。

使用有效的參數範圍與單位

示範的方法使用下列語意範圍與單位。即使特定函式庫版本不會立即拒絕每個超出範圍的值，也請維持在這些範圍內；目標簡報格式可能在儲存或 PowerPoint 開啟檔案時正規化、忽略或拒絕無效資料。

操作	參數	有效範圍與單位
addBrightnessContrastEffect	`brightness`, `contrast`	`-100` 至 `100`，百分比；`0` 表示保持元件不變。
addGrayScaleEffect	無	無數值參數。Alpha 保持不變。
addDuotoneEffect	`color1`, `color2`	兩個顏色分別對應暗色與亮色像素。`android.graphics.Color` 使用的 RGB 與 alpha 通道值範圍為 `0` 至 `255`。
addTintEffect	`hue`, `amount`	色相為 `0`（含）至 `360`（未含）度；`amount` 為 `-100` 至 `100`，百分比。
addHSLEffect	`hue`, `saturation`, `luminance`	色相為 `0`（含）至 `360`（未含）度；飽和度與亮度為 `-100` 至 `100`，百分比。
addColorReplaceEffect	`color`	替換顏色使用的通道值在 `0` 至 `255` 之間。現有的 alpha 值保持不變。
addBlurEffect	`radius`, `grow`	半徑為非負數，單位為點（points）；`grow` 為布林值，決定模糊內容是否可延伸至原始邊界之外。
addAlphaModulateFixedEffect	`amount`	非負百分比。使用 `0` 至 `100` 進行普通不透明度縮放：`0` 為完全透明，`100` 保留現有 alpha。
addAlphaReplaceEffect	`alpha`	`0` 至 `100`，百分比不透明度。
addAlphaBiLevelEffect	`threshold`	`0` 至 `100`，百分比 alpha 閾值。低於閾值的像素變為透明，等於或高於閾值的像素變為不透明。

對於固定的 alpha 調變，透明度與不透明度是互補的。例如，35% 的透明度對應 65% 的 alpha 調變量。

套用亮度與對比度

IImageTransformOperationCollection.addBrightnessContrastEffect 會回傳一個 IBrightnessContrast 操作。其純量設定在建立操作時提供。IBrightnessContrast.getEffective 會回傳計算後的唯讀值，可供檢查或記錄。

以下範例將亮度提升 15%，對比度提升 20%，然後產生預覽而不修改嵌入的影像：

import com.aspose.slides.*;

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

    IPPImage image;
    IImage sourceImage = Images.fromFile("photo.png");
    try {
        image = presentation.getImages().addImage(sourceImage);
    } finally {
        sourceImage.dispose();
    }
    IPictureFrame pictureFrame = slide.getShapes().addPictureFrame(ShapeType.Rectangle, 50, 50, 400, 260, image);

    IImageTransformOperationCollection imageTransform = pictureFrame.getPictureFormat().getPicture().getImageTransform();
    IBrightnessContrast brightnessContrast = imageTransform.addBrightnessContrastEffect(15f, 20f);

    IBrightnessContrastEffectiveData effectiveValues = brightnessContrast.getEffective();
    System.out.println("Brightness: " + effectiveValues.getBrightness() + "%");
    System.out.println("Contrast: " + effectiveValues.getContrast() + "%");

    IImage preview = slide.getImage();
    try {
        preview.save("brightness-contrast-preview.png", ImageFormat.Png);
    } finally {
        preview.dispose();
    }
} finally {
    presentation.dispose();
}

BrightnessContrast 是 Office 2010 的圖片效果延伸，較不具可移植性，若需在 PPTX 循環後仍保持可編輯，請使用 IImageTransformOperationCollection.addLuminanceEffect 並在重新開啟檔案後驗證結果。格式限制章節對此區別有更詳細說明。

套用顏色變換

即使多個圖片框共用同一影像資源，也能獨立套用顏色效果。以下範例建立五個框，分別套用灰階、雙調、色調、HSL 調整與顏色替換。

IDuotone 包含兩個可獨立編輯的顏色參數：color1 對應暗像素，color2 對應亮像素。這是個顯示設定較為複雜、超過單一純量值的效果範例。

import com.aspose.slides.*;
import android.graphics.Color;

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

    IPPImage image;
    IImage sourceImage = Images.fromFile("photo.png");
    try {
        image = presentation.getImages().addImage(sourceImage);
    } finally {
        sourceImage.dispose();
    }

    IPictureFrame grayFrame = slide.getShapes().addPictureFrame(ShapeType.Rectangle, 20, 20, 180, 120, image);
    grayFrame.getPictureFormat().getPicture().getImageTransform().addGrayScaleEffect();

    IPictureFrame duotoneFrame = slide.getShapes().addPictureFrame(ShapeType.Rectangle, 220, 20, 180, 120, image);
    IDuotone duotone = duotoneFrame.getPictureFormat().getPicture().getImageTransform().addDuotoneEffect();
    duotone.getColor1().setColor(Color.rgb(0, 0, 128));
    duotone.getColor2().setColor(Color.rgb(255, 215, 0));

    IPictureFrame tintFrame = slide.getShapes().addPictureFrame(ShapeType.Rectangle, 420, 20, 180, 120, image);
    tintFrame.getPictureFormat().getPicture().getImageTransform().addTintEffect(210f, 35f);

    IPictureFrame hslFrame = slide.getShapes().addPictureFrame(ShapeType.Rectangle, 120, 170, 180, 120, image);
    hslFrame.getPictureFormat().getPicture().getImageTransform().addHSLEffect(30f, 20f, -10f);

    IPictureFrame replacementFrame = slide.getShapes().addPictureFrame(ShapeType.Rectangle, 320, 170, 180, 120, image);
    IColorReplace colorReplacement = replacementFrame.getPictureFormat().getPicture().getImageTransform().addColorReplaceEffect();
    colorReplacement.getColor().setColor(Color.rgb(100, 149, 237));

    presentation.save("color-transformations.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

addColorReplaceEffect 會以固定顏色取代每個像素的顏色，同時保留 alpha。它不同於 addColorChangeEffect，後者會將一個來源顏色映射到另一個顏色，且同時公開來源與目標顏色的格式。

新增模糊、透明度與 Alpha 效果

addBlurEffect 會影響所有顏色通道，包括 alpha。當模糊邊緣可能超出原始圖片範圍時，請將 grow 設為 true。

若需均勻透明度，使用 addAlphaModulateFixedEffect。它會將每個既有 alpha 值乘以指定比例，因而保留部分透明像素之間的相對差異。addAlphaReplaceEffect 則會將所有像素的 alpha 設為相同值。addAlphaBiLevelEffect 會根據閾值將 alpha 轉為兩個層級。

import com.aspose.slides.*;

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

    IPPImage image;
    IImage sourceImage = Images.fromFile("photo.png");
    try {
        image = presentation.getImages().addImage(sourceImage);
    } finally {
        sourceImage.dispose();
    }

    IPictureFrame blurredFrame = slide.getShapes().addPictureFrame(ShapeType.Rectangle, 20, 20, 200, 140, image);
    IBlur blur = blurredFrame.getPictureFormat().getPicture().getImageTransform().addBlurEffect(4.5, true);
    blur.setRadius(5);

    IPictureFrame transparentFrame = slide.getShapes().addPictureFrame(ShapeType.Rectangle, 240, 20, 200, 140, image);
    IAlphaModulateFixed alphaModulate = transparentFrame.getPictureFormat().getPicture().getImageTransform().addAlphaModulateFixedEffect(65f);
    alphaModulate.setAmount(60f);

    IPictureFrame uniformAlphaFrame = slide.getShapes().addPictureFrame(ShapeType.Rectangle, 20, 180, 200, 140, image);
    uniformAlphaFrame.getPictureFormat().getPicture().getImageTransform().addAlphaReplaceEffect(55f);

    IPictureFrame binaryAlphaFrame = slide.getShapes().addPictureFrame(ShapeType.Rectangle, 240, 180, 200, 140, image);
    IAlphaBiLevel alphaBiLevel = binaryAlphaFrame.getPictureFormat().getPicture().getImageTransform().addAlphaBiLevelEffect(50f);
    alphaBiLevel.setThreshold(45f);
    binaryAlphaFrame.getPictureFormat().getPicture().getImageTransform().addAlphaInverseEffect();

    presentation.save("blur-and-alpha-effects.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

其他無參數的 alpha 操作還包括 addAlphaCeilingEffect（將每個非零 alpha 變為完全不透明）、addAlphaFloorEffect（將低於 100% 的 alpha 變為完全透明）以及 addAlphaInverseEffect（將 alpha 變為 100% - alpha）。

建立有序的效果鏈

每個 add...Effect 方法都會將新操作附加至集合的末端。渲染器會將集合視為有序的管線：操作 0 的輸出成為操作 1 的輸入，依此類推。因此，以不同順序排列相同操作可能產生不同的影像。

例如，先執行灰階再執行色調會先去除色彩資訊，然後對亮度結果重新著色。若先執行色調再執行灰階，則會再次去除色調。類似地，alpha 替換會覆寫先前操作計算的 alpha 值，而 alpha 調變則保留它們之間的相對差異。

以下範例建立四個操作的鏈，將其儲存為 PPTX，重新開啟簡報，檢查操作類型與順序，並渲染重新開啟的結果：

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IPPImage image;
    IImage sourceImage = Images.fromFile("photo.png");
    try {
        image = presentation.getImages().addImage(sourceImage);
    } finally {
        sourceImage.dispose();
    }
    IPictureFrame pictureFrame = slide.getShapes().addPictureFrame(ShapeType.Rectangle, 50, 50, 400, 260, image);

    IImageTransformOperationCollection imageTransform = pictureFrame.getPictureFormat().getPicture().getImageTransform();
    imageTransform.addGrayScaleEffect();
    imageTransform.addTintEffect(220f, 25f);
    imageTransform.addBlurEffect(2.5, false);
    imageTransform.addAlphaModulateFixedEffect(80f);

    presentation.save("image-transform-chain.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Presentation reopenedPresentation = new Presentation("image-transform-chain.pptx");
try {
    IShape reopenedShape = reopenedPresentation.getSlides().get_Item(0).getShapes().get_Item(0);

    if (reopenedShape instanceof IPictureFrame) {
        IPictureFrame reopenedFrame = (IPictureFrame) reopenedShape;
        IImageTransformOperationCollection reopenedTransform = reopenedFrame.getPictureFormat().getPicture().getImageTransform();
        boolean orderIsPreserved = reopenedTransform.size() == 4 && 
                reopenedTransform.get_Item(0) instanceof IGrayScale && 
                reopenedTransform.get_Item(1) instanceof ITint && 
                reopenedTransform.get_Item(2) instanceof IBlur && 
                reopenedTransform.get_Item(3) instanceof IAlphaModulateFixed;
        System.out.println(orderIsPreserved ? "The effect chain was preserved." : "The effect chain changed during the round trip.");

        IImage renderedSlide = reopenedPresentation.getSlides().get_Item(0).getImage();
        try {
            renderedSlide.save("reopened-effect-chain.png", ImageFormat.Png);
        } finally {
            renderedSlide.dispose();
        }
    } else {
        System.out.println("The reopened shape is not a picture frame.");
    }
} finally {
    reopenedPresentation.dispose();
}

此集合不會強制相容性矩陣，限制顏色、alpha 與模糊操作只能在不同鏈中使用。它們可以組合，但組合未必都有意義。固定的顏色替換會移除先前顏色效果產生的 RGB 變化；在雙調之後再執行灰階會移除兩個選取的顏色；alpha ceiling、floor、replace 或 bi‑level 操作會捨棄先前建立的 alpha 細節。請根據所需的像素處理序列構建鏈，而非將其項目視為無序的格式旗標。

檢查可編輯與有效值

可編輯的操作是儲存在 ISlidesPicture.getImageTransform 中的物件。依據效果不同，可能直接公開可寫成員。例如，IBlur 會公開可寫的 radius 與 grow，IAlphaModulateFixed 會公開可寫的 amount，IAlphaBiLevel 會公開可寫的 threshold。像 IDuotone 這類顏色效果會公開可變的 IColorFormat 物件。

某些操作介面（例如 IBrightnessContrast、IHSL、ITint、IAlphaReplace）不會將建立時的純量公開為可寫屬性。若要變更這些設定，請先移除該操作，再在需要的位置加入替代操作。

getEffective() 回傳的有效資料是計算後的唯讀值。它可用於解析主題相依的顏色，並取得渲染器實際使用的正規化值，但不是另一個可編輯的介面。以下範例列舉鏈並在相應的 API 提供時檢查有效值：

import com.aspose.slides.*;

Presentation presentation = new Presentation("image-transform-chain.pptx");
try {
    IPictureFrame pictureFrame = null;

    for (IShape shape : presentation.getSlides().get_Item(0).getShapes()) {
        if (shape instanceof IPictureFrame) {
            pictureFrame = (IPictureFrame) shape;
            break;
        }
    }

    if (pictureFrame != null) {
        IImageTransformOperationCollection imageTransform = pictureFrame.getPictureFormat().getPicture().getImageTransform();

        for (int index = 0; index < imageTransform.size(); index++) {
            IImageTransformOperation operation = imageTransform.get_Item(index);
            System.out.println(index + ": " + operation.getClass().getSimpleName());

            if (operation instanceof IBrightnessContrast) {
                IBrightnessContrastEffectiveData data = ((IBrightnessContrast) operation).getEffective();
                System.out.println("  Brightness: " + data.getBrightness());
                System.out.println("  Contrast: " + data.getContrast());
            } else if (operation instanceof ILuminance) {
                ILuminanceEffectiveData data = ((ILuminance) operation).getEffective();
                System.out.println("  Brightness: " + data.getBrightness());
                System.out.println("  Contrast: " + data.getContrast());
            } else if (operation instanceof IDuotone) {
                IDuotoneEffectiveData data = ((IDuotone) operation).getEffective();
                System.out.println("  Dark color: " + data.getColor1());
                System.out.println("  Light color: " + data.getColor2());
            } else if (operation instanceof IColorReplace) {
                IColorReplaceEffectiveData data = ((IColorReplace) operation).getEffective();
                System.out.println("  Replacement color: " + data.getColor());
            } else if (operation instanceof IHSL) {
                IHSLEffectiveData data = ((IHSL) operation).getEffective();
                System.out.println("  HSL: " + data.getHue() + ", " + data.getSaturation() + ", " + data.getLuminance());
            } else if (operation instanceof ITint) {
                ITintEffectiveData data = ((ITint) operation).getEffective();
                System.out.println("  Tint: " + data.getHue() + ", " + data.getAmount());
            } else if (operation instanceof IBlur) {
                IBlurEffectiveData data = ((IBlur) operation).getEffective();
                System.out.println("  Blur radius: " + data.getRadius() + " pt");
            } else if (operation instanceof IAlphaModulateFixed) {
                IAlphaModulateFixedEffectiveData data = ((IAlphaModulateFixed) operation).getEffective();
                System.out.println("  Alpha amount: " + data.getAmount() + "%");
            } else if (operation instanceof IAlphaReplace) {
                IAlphaReplaceEffectiveData data = ((IAlphaReplace) operation).getEffective();
                System.out.println("  Replacement alpha: " + data.getAlpha() + "%");
            } else if (operation instanceof IAlphaBiLevel) {
                IAlphaBiLevelEffectiveData data = ((IAlphaBiLevel) operation).getEffective();
                System.out.println("  Alpha threshold: " + data.getThreshold() + "%");
            }
        }
    }
} finally {
    presentation.dispose();
}

雖然灰階、alpha ceiling、alpha inverse 等無參數效果仍有有效資料物件，但沒有可列印的純量設定。它們在集合中的存在與位置即為重要資訊。

移除或清除影像變換

使用 IImageTransformOperationCollection.removeAt 依索引移除單一操作。因為移除後索引會變動，請先搜尋目標再於列舉完畢後移除。使用 ImageTransformOperationCollection.clear 可一次清除整個鏈。

import com.aspose.slides.*;

Presentation presentation = new Presentation("image-transform-chain.pptx");
try {
    IPictureFrame pictureFrame = null;

    for (IShape shape : presentation.getSlides().get_Item(0).getShapes()) {
        if (shape instanceof IPictureFrame) {
            pictureFrame = (IPictureFrame) shape;
            break;
        }
    }

    if (pictureFrame != null) {
        IImageTransformOperationCollection imageTransform = pictureFrame.getPictureFormat().getPicture().getImageTransform();
        int blurIndex = -1;

        for (int index = 0; index < imageTransform.size(); index++) {
            if (imageTransform.get_Item(index) instanceof IBlur) {
                blurIndex = index;
                break;
            }
        }

        if (blurIndex >= 0) {
            imageTransform.removeAt(blurIndex);
            System.out.println("The blur operation was removed.");
        }

        imageTransform.clear();
        System.out.println("Remaining operations: " + imageTransform.size());
        presentation.save("image-transforms-cleared.pptx", SaveFormat.Pptx);
    }
} finally {
    presentation.dispose();
}

移除或清除變換僅會改變圖片的格式設定，並不會刪除、重新壓縮或以其他方式更改重複使用的 IPPImage 資源。

考慮簡報格式與輸出目標

影像變換起源於 DrawingML，故 PPTX 為效果鏈的首選可編輯格式。即使是 PPTX，也不是所有操作都有相同的可移植性：

標準 DrawingML 操作（如 luminance、grayscale、duotone、tint、HSL、blur 以及常見的 alpha 操作）最有可能在 PPTX 循環後仍然保留。若有保存需求，請務必重新開啟產生的檔案並檢查集合。
BrightnessContrast 為 Office 2010 的延伸，而非標準 DrawingML luminance 操作。它可用於記憶體內渲染，但無法保證在儲存與重新開啟 PPTX 後仍以可編輯的 IBrightnessContrast 形式存在。請使用 addLuminanceEffect 以取得持久的亮度與對比度調整。
舊版 PPT 二進位格式早於完整的 DrawingML 效果模型。儲存為 PPT 可能會省略不支援的操作、將鏈縮減為受支援子集，或以近似方式呈現。不要將 PPT 作為驗證複雜可編輯鏈的格式。
輸出為 PNG、JPEG、TIFF、PDF、SVG、HTML 或其他視覺格式時，會將支援的鏈套用至最終渲染結果。這些輸出不會包含可編輯的 IImageTransformOperationCollection；點陣格式會把結果鋪平為像素，文件/向量匯出則儲存自己的渲染表示。
效果並不會使鏈結的影像變成自包含。渲染鏈結圖片仍然需要在載入簡報時能取得該鏈結資源。

不同的簡報消費端在處理邊緣案例時可能表現不同，特別是同時結合多個 alpha 或顏色量化操作時。對於關鍵輸出，請使用與生產環境相同的 Aspose.Slides 版本，同時測試可編輯的循環與最終匯出格式。

常見問題

影像變換效果會修改嵌入的影像資料嗎？

不會。這些操作屬於圖片填色所使用的 ISlidesPicture，底層的 IPPImage 位元組保持不變。

重複使用同一影像的兩個圖片框會共享它們的效果嗎？

不會。重複使用 IPPImage 只是避免影像資料重複存儲，但每個圖片框通常都有各自的 ISlidesPicture 與影像變換集合。

顏色、模糊與 alpha 效果可以組合使用嗎？

可以。集合接受它們在同一有序鏈中。請考慮每個操作對前一步輸出的影響，因為替換與閾值操作可能會捨棄先前的顏色或 alpha 細節。

為何有效值是唯讀的？

有效資料代表渲染時使用的計算值，包含已解析的顏色。請在變換集合中編輯具有可寫成員的操作；若無可寫成員，請將該操作移除，並以新的建立參數加入替代操作。

應使用哪種格式才能保留變換鏈？

使用 PPTX 並於產生後重新開啟以驗證。舊版 PPT 無法完整表示 DrawingML 效果模型，而視覺匯出格式僅保留外觀，無法保留可編輯的變換操作。

在 Android 上管理簡報中的音訊