使用 C++ 管理簡報中的影像變換效果

本頁內容簡介

使用 Aspose.Slides for C++ 套用、鏈接、檢查、移除並驗證圖片框的影像變換效果。

概述

Aspose.Slides 以有序的影像變換作業集合來表示圖片調整。對於圖片框，先取得框的 ISlidesPicture，再存取 ISlidesPicture::get_ImageTransform。回傳的 IImageTransformOperationCollection 允許您在不重新寫入原始影像位元組的情況下，追加、列舉、檢查、移除與清除效果。

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

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

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

• IPPImage 儲存或參考簡報所擁有的來源影像資料。
• ISlidesPicture 屬於圖片填充，指向影像資源，同時保存影像變換集合。
• IPictureFrame 是擁有相關圖片填充、幾何形狀、裁切設定及其他框級格式的投影片形狀。

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

相同的 ISlidesPicture::get_ImageTransform 模型也用於其他圖片填充，例如形狀或投影片背景。以下範例聚焦於圖片框。

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

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

Operation	Parameters	Valid range and unit
AddBrightnessContrastEffect	brightness, contrast	-100 到 100，百分比；0 表示保持元件不變。
AddGrayScaleEffect	None	無數值參數。Alpha 保持不變。
AddDuotoneEffect	Color1, Color2	兩個顏色分別用於暗像素與亮像素。System::Drawing::Color 的 RGB 與 Alpha 通道使用 0 到 255。
AddTintEffect	hue, amount	Hue 為包含 0 不含 360 的度數；amount 為 -100 到 100，百分比。
AddHSLEffect	hue, saturation, luminance	Hue 為包含 0 不含 360 的度數；saturation 與 luminance 為 -100 到 100，百分比。
AddColorReplaceEffect	Color	替換顏色的通道值為 0 到 255。現有的 Alpha 值保持不變。
AddBlurEffect	radius, grow	radius 為非負值，以點為單位；grow 控制模糊內容是否可延伸至原始邊界之外。
AddAlphaModulateFixedEffect	amount	非負百分比。使用 0 到 100 進行普通不透明度縮放：0 為完全透明，100 保持原有 Alpha。
AddAlphaReplaceEffect	alpha	0 到 100，百分比不透明度。
AddAlphaBiLevelEffect	threshold	0 到 100，百分比 Alpha 閾值。低於此值的像素變為透明；等於或高於此值的像素變為不透明。

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

套用亮度與對比度

IImageTransformOperationCollection::AddBrightnessContrastEffect 會回傳一個 IBrightnessContrast 作業。其標量設定在建立作業時即提供。IBrightnessContrast::GetEffective 方法會回傳計算後的唯讀值，可供檢查或記錄。

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

#include <DOM/Effects/IBrightnessContrast.h>
#include <DOM/Effects/IBrightnessContrastEffectiveData.h>
#include <DOM/Effects/IImageTransformOperationCollection.h>
#include <DOM/IImageCollection.h>
#include <DOM/IPictureFillFormat.h>
#include <DOM/IPictureFrame.h>
#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/ISlidesPicture.h>
#include <DOM/Presentation.h>
#include <DOM/ShapeType.h>
#include <IImage.h>
#include <ImageFormat.h>
#include <system/console.h>
#include <system/io/file.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Effects;
using namespace System;
using namespace System::IO;

auto presentation = MakeObject<Presentation>();
auto slide = presentation->get_Slide(0);

auto imageData = File::ReadAllBytes(u"photo.png");
auto image = presentation->get_Images()->AddImage(imageData);
auto pictureFrame = slide->get_Shapes()->AddPictureFrame(ShapeType::Rectangle, 50.0f, 50.0f, 400.0f, 260.0f, image);

auto imageTransform = pictureFrame->get_PictureFormat()->get_Picture()->get_ImageTransform();
auto brightnessContrast = imageTransform->AddBrightnessContrastEffect(15.0f, 20.0f);

auto effectiveValues = brightnessContrast->GetEffective();
Console::WriteLine(u"Brightness: {0}%", effectiveValues->get_Brightness());
Console::WriteLine(u"Contrast: {0}%", effectiveValues->get_Contrast());

auto preview = slide->GetImage();
preview->Save(u"brightness-contrast-preview.png", ImageFormat::Png);

presentation->Dispose();

BrightnessContrast 是 Office 2010 的圖片效果擴充，較不具可移植性，且不如標準 DrawingML 亮度效果通用。當亮度與對比度必須在 PPTX 循環後仍可編輯時，請使用 IImageTransformOperationCollection::AddLuminanceEffect 並在重新開啟檔案後驗證結果。格式限制章節會更詳細說明此差異。

套用顏色轉換

顏色效果可以獨立套用於重複使用同一影像資源的不同圖片框。以下範例建立五個框，分別套用灰階、雙調、色調、HSL 調整與顏色替換。

IDuotone 包含兩個可獨立編輯的顏色參數：get_Color1 用於暗像素，get_Color2 用於亮像素。這是一個設定比單一標量更複雜的效果範例。

#include <DOM/Effects/IColorReplace.h>
#include <DOM/Effects/IDuotone.h>
#include <DOM/Effects/IImageTransformOperationCollection.h>
#include <DOM/IColorFormat.h>
#include <DOM/IImageCollection.h>
#include <DOM/IPictureFillFormat.h>
#include <DOM/IPictureFrame.h>
#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/ISlidesPicture.h>
#include <DOM/Presentation.h>
#include <DOM/ShapeType.h>
#include <Export/SaveFormat.h>
#include <drawing/color.h>
#include <system/io/file.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;
using namespace System::Drawing;
using namespace System::IO;

auto presentation = MakeObject<Presentation>();
auto slide = presentation->get_Slide(0);

auto imageData = File::ReadAllBytes(u"photo.png");
auto image = presentation->get_Images()->AddImage(imageData);

auto grayFrame = slide->get_Shapes()->AddPictureFrame(ShapeType::Rectangle, 20.0f, 20.0f, 180.0f, 120.0f, image);
grayFrame->get_PictureFormat()->get_Picture()->get_ImageTransform()->AddGrayScaleEffect();

auto duotoneFrame = slide->get_Shapes()->AddPictureFrame(ShapeType::Rectangle, 220.0f, 20.0f, 180.0f, 120.0f, image);
auto duotone = duotoneFrame->get_PictureFormat()->get_Picture()->get_ImageTransform()->AddDuotoneEffect();
duotone->get_Color1()->set_Color(Color::get_Navy());
duotone->get_Color2()->set_Color(Color::get_Gold());

auto tintFrame = slide->get_Shapes()->AddPictureFrame(ShapeType::Rectangle, 420.0f, 20.0f, 180.0f, 120.0f, image);
tintFrame->get_PictureFormat()->get_Picture()->get_ImageTransform()->AddTintEffect(210.0f, 35.0f);

auto hslFrame = slide->get_Shapes()->AddPictureFrame(ShapeType::Rectangle, 120.0f, 170.0f, 180.0f, 120.0f, image);
hslFrame->get_PictureFormat()->get_Picture()->get_ImageTransform()->AddHSLEffect(30.0f, 20.0f, -10.0f);

auto replacementFrame = slide->get_Shapes()->AddPictureFrame(ShapeType::Rectangle, 320.0f, 170.0f, 180.0f, 120.0f, image);
auto colorReplacement = replacementFrame->get_PictureFormat()->get_Picture()->get_ImageTransform()->AddColorReplaceEffect();
colorReplacement->get_Color()->set_Color(Color::get_CornflowerBlue());

presentation->Save(u"color-transformations.pptx", SaveFormat::Pptx);
presentation->Dispose();

AddColorReplaceEffect 會將每個像素的顏色全部替換為固定顏色，同時保留 Alpha。它不同於 AddColorChangeEffect，後者會將一個來源顏色映射到另一個顏色，並同時公開來源與目標顏色格式。

加入模糊、透明度與 Alpha 效果

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

若需均勻透明度，請使用 AddAlphaModulateFixedEffect。它會乘以每個現有 Alpha 值，使部分透明像素保持比例差異。AddAlphaReplaceEffect 則會將所有像素指派同一 Alpha 值。AddAlphaBiLevelEffect 會根據閾值將 Alpha 轉為兩個層級。

#include <DOM/Effects/IAlphaBiLevel.h>
#include <DOM/Effects/IAlphaModulateFixed.h>
#include <DOM/Effects/IBlur.h>
#include <DOM/Effects/IImageTransformOperationCollection.h>
#include <DOM/IImageCollection.h>
#include <DOM/IPictureFillFormat.h>
#include <DOM/IPictureFrame.h>
#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/ISlidesPicture.h>
#include <DOM/Presentation.h>
#include <DOM/ShapeType.h>
#include <Export/SaveFormat.h>
#include <system/io/file.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;
using namespace System::IO;

auto presentation = MakeObject<Presentation>();
auto slide = presentation->get_Slide(0);

auto imageData = File::ReadAllBytes(u"photo.png");
auto image = presentation->get_Images()->AddImage(imageData);

auto blurredFrame = slide->get_Shapes()->AddPictureFrame(ShapeType::Rectangle, 20.0f, 20.0f, 200.0f, 140.0f, image);
auto blur = blurredFrame->get_PictureFormat()->get_Picture()->get_ImageTransform()->AddBlurEffect(4.5, true);
blur->set_Radius(5.0);

auto transparentFrame = slide->get_Shapes()->AddPictureFrame(ShapeType::Rectangle, 240.0f, 20.0f, 200.0f, 140.0f, image);
auto alphaModulate = transparentFrame->get_PictureFormat()->get_Picture()->get_ImageTransform()->AddAlphaModulateFixedEffect(65.0f);
alphaModulate->set_Amount(60.0f);

auto uniformAlphaFrame = slide->get_Shapes()->AddPictureFrame(ShapeType::Rectangle, 20.0f, 180.0f, 200.0f, 140.0f, image);
uniformAlphaFrame->get_PictureFormat()->get_Picture()->get_ImageTransform()->AddAlphaReplaceEffect(55.0f);

auto binaryAlphaFrame = slide->get_Shapes()->AddPictureFrame(ShapeType::Rectangle, 240.0f, 180.0f, 200.0f, 140.0f, image);
auto binaryAlphaTransform = binaryAlphaFrame->get_PictureFormat()->get_Picture()->get_ImageTransform();
auto alphaBiLevel = binaryAlphaTransform->AddAlphaBiLevelEffect(50.0f);
alphaBiLevel->set_Threshold(45.0f);
binaryAlphaTransform->AddAlphaInverseEffect();

presentation->Save(u"blur-and-alpha-effects.pptx", SaveFormat::Pptx);
presentation->Dispose();

其他無參數的 Alpha 作業還包括 AddAlphaCeilingEffect，會使所有非零 Alpha 變為完全不透明；AddAlphaFloorEffect，會使低於 100% 的 Alpha 完全透明；以及 AddAlphaInverseEffect，會將 Alpha 變為 100% - alpha。

建立有序的效果鏈

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

例如，先執行灰階再執行色調會先移除色彩資訊，再為亮度結果重新著色。先執行色調再執行灰階則會再次去除色調。類似地，Alpha 替換可以覆蓋先前作業計算出的 Alpha，而 Alpha 調變則會保留其相對差異。

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

#include <DOM/Effects/IAlphaModulateFixed.h>
#include <DOM/Effects/IBlur.h>
#include <DOM/Effects/IGrayScale.h>
#include <DOM/Effects/IImageTransformOperationCollection.h>
#include <DOM/Effects/ITint.h>
#include <DOM/IImageCollection.h>
#include <DOM/IPictureFillFormat.h>
#include <DOM/IPictureFrame.h>
#include <DOM/IShape.h>
#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/ISlidesPicture.h>
#include <DOM/Presentation.h>
#include <DOM/ShapeType.h>
#include <IImage.h>
#include <ImageFormat.h>
#include <Export/SaveFormat.h>
#include <system/console.h>
#include <system/io/file.h>
#include <system/object_ext.h>
#include <system/smart_ptr.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Effects;
using namespace Aspose::Slides::Export;
using namespace System;
using namespace System::IO;

auto presentation = MakeObject<Presentation>();
auto slide = presentation->get_Slide(0);
auto imageData = File::ReadAllBytes(u"photo.png");
auto image = presentation->get_Images()->AddImage(imageData);
auto pictureFrame = slide->get_Shapes()->AddPictureFrame(ShapeType::Rectangle, 50.0f, 50.0f, 400.0f, 260.0f, image);

auto imageTransform = pictureFrame->get_PictureFormat()->get_Picture()->get_ImageTransform();
imageTransform->AddGrayScaleEffect();
imageTransform->AddTintEffect(220.0f, 25.0f);
imageTransform->AddBlurEffect(2.5, false);
imageTransform->AddAlphaModulateFixedEffect(80.0f);

presentation->Save(u"image-transform-chain.pptx", SaveFormat::Pptx);
presentation->Dispose();

auto reopenedPresentation = MakeObject<Presentation>(u"image-transform-chain.pptx");
auto reopenedShape = reopenedPresentation->get_Slide(0)->get_Shape(0);

if (ObjectExt::Is<IPictureFrame>(reopenedShape))
{
    auto reopenedFrame = ExplicitCast<IPictureFrame>(reopenedShape);
    auto reopenedTransform = reopenedFrame->get_PictureFormat()->get_Picture()->get_ImageTransform();
    auto orderIsPreserved = reopenedTransform->get_Count() == 4 && 
            ObjectExt::Is<IGrayScale>(reopenedTransform->idx_get(0)) && 
            ObjectExt::Is<ITint>(reopenedTransform->idx_get(1)) && 
            ObjectExt::Is<IBlur>(reopenedTransform->idx_get(2)) && 
            ObjectExt::Is<IAlphaModulateFixed>(reopenedTransform->idx_get(3));
    Console::WriteLine(orderIsPreserved ? u"The effect chain was preserved." : u"The effect chain changed during the round trip.");

    auto renderedSlide = reopenedPresentation->get_Slide(0)->GetImage();
    renderedSlide->Save(u"reopened-effect-chain.png", ImageFormat::Png);
}
else
{
    Console::WriteLine(u"The reopened shape is not a picture frame.");
}

reopenedPresentation->Dispose();

此集合不會施加相容性矩陣限制顏色、Alpha 與模糊作業必須分別在不同鏈中。它們可以組合使用，但組合未必有意義。固定顏色替換會移除先前顏色效果產生的 RGB 變化；灰階於雙調之後會移除兩個選定顏色；Alpha ceiling、floor、replace 或 bi‑level 作業則可能丟棄先前產生的 Alpha 細節。請依據期望的像素處理順序建立鏈，而非將其視為無序的格式旗標。

檢查可編輯與有效值

可編輯的作業即存於 ISlidesPicture::get_ImageTransform 中的物件。依效果不同，可能直接公開可寫成員。例如，IBlur 公开 set_Radius 與 set_Grow，IAlphaModulateFixed 公开 set_Amount，IAlphaBiLevel 公开 set_Threshold。像 IDuotone 這類顏色效果則會公開可變的 IColorFormat 物件。

某些作業介面（包括 IBrightnessContrast、IHSL、ITint、IAlphaReplace）不會將建立時的標量公開為可寫屬性。若需變更這些設定，必須先移除該作業，再在所需位置加入新的取代作業。

GetEffective() 回傳的有效資料是計算後的唯讀值。它對解析主題相關顏色與取得渲染器使用的正規化值很有幫助，但並非另一個可編輯的表面。以下範例列舉鏈並檢查多個常用作業的有效值：

#include <DOM/Effects/IAlphaModulateFixed.h>
#include <DOM/Effects/IAlphaModulateFixedEffectiveData.h>
#include <DOM/Effects/IBlur.h>
#include <DOM/Effects/IBlurEffectiveData.h>
#include <DOM/Effects/IBrightnessContrast.h>
#include <DOM/Effects/IBrightnessContrastEffectiveData.h>
#include <DOM/Effects/IDuotone.h>
#include <DOM/Effects/IDuotoneEffectiveData.h>
#include <DOM/Effects/IImageTransformOperationCollection.h>
#include <DOM/Effects/ILuminance.h>
#include <DOM/Effects/ILuminanceEffectiveData.h>
#include <DOM/IPictureFillFormat.h>
#include <DOM/IPictureFrame.h>
#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/ISlidesPicture.h>
#include <DOM/Presentation.h>
#include <system/console.h>
#include <system/object_ext.h>
#include <system/smart_ptr.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Effects;
using namespace System;

auto presentation = MakeObject<Presentation>(u"image-transform-chain.pptx");
auto slide = presentation->get_Slide(0);
SharedPtr<IPictureFrame> pictureFrame;

for (auto&& shape : slide->get_Shapes())
{
    if (ObjectExt::Is<IPictureFrame>(shape))
    {
        pictureFrame = ExplicitCast<IPictureFrame>(shape);
        break;
    }
}

if (pictureFrame != nullptr)
{
    auto imageTransform = pictureFrame->get_PictureFormat()->get_Picture()->get_ImageTransform();

    for (auto&& operation : imageTransform)
    {
        if (ObjectExt::Is<IBrightnessContrast>(operation))
        {
            auto brightnessContrast = ExplicitCast<IBrightnessContrast>(operation);
            auto data = brightnessContrast->GetEffective();
            Console::WriteLine(u"Brightness: {0}; contrast: {1}", data->get_Brightness(), data->get_Contrast());
        }
        else if (ObjectExt::Is<ILuminance>(operation))
        {
            auto luminance = ExplicitCast<ILuminance>(operation);
            auto data = luminance->GetEffective();
            Console::WriteLine(u"Brightness: {0}; contrast: {1}", data->get_Brightness(), data->get_Contrast());
        }
        else if (ObjectExt::Is<IDuotone>(operation))
        {
            auto duotone = ExplicitCast<IDuotone>(operation);
            auto data = duotone->GetEffective();
            Console::WriteLine(u"Dark color: {0}; light color: {1}", data->get_Color1(), data->get_Color2());
        }
        else if (ObjectExt::Is<IBlur>(operation))
        {
            auto blur = ExplicitCast<IBlur>(operation);
            auto data = blur->GetEffective();
            Console::WriteLine(u"Blur radius: {0} pt", data->get_Radius());
        }
        else if (ObjectExt::Is<IAlphaModulateFixed>(operation))
        {
            auto alphaModulate = ExplicitCast<IAlphaModulateFixed>(operation);
            auto data = alphaModulate->GetEffective();
            Console::WriteLine(u"Alpha amount: {0}%", data->get_Amount());
        }
    }
}

presentation->Dispose();

無參數的效果（如灰階、Alpha ceiling、Alpha inverse）仍會有有效資料物件，只是沒有可列印的標量設定。它們在集合中的存在與位置即為重要資訊。

移除或清除影像變換

使用 IImageTransformOperationCollection::RemoveAt 依索引移除單一作業。因為移除後索引會改變，請先搜尋目標作業，列舉完畢後再移除。使用 Clear() 可移除整個鏈。

#include <DOM/Effects/IBlur.h>
#include <DOM/Effects/IImageTransformOperationCollection.h>
#include <DOM/IPictureFillFormat.h>
#include <DOM/IPictureFrame.h>
#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/ISlidesPicture.h>
#include <DOM/Presentation.h>
#include <Export/SaveFormat.h>
#include <system/console.h>
#include <system/object_ext.h>
#include <system/smart_ptr.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Effects;
using namespace Aspose::Slides::Export;
using namespace System;

auto presentation = MakeObject<Presentation>(u"image-transform-chain.pptx");
auto slide = presentation->get_Slide(0);
SharedPtr<IPictureFrame> pictureFrame;

for (auto&& shape : slide->get_Shapes())
{
    if (ObjectExt::Is<IPictureFrame>(shape))
    {
        pictureFrame = ExplicitCast<IPictureFrame>(shape);
        break;
    }
}

if (pictureFrame != nullptr)
{
    auto imageTransform = pictureFrame->get_PictureFormat()->get_Picture()->get_ImageTransform();
    auto blurIndex = -1;

    for (auto index = 0; index < imageTransform->get_Count(); ++index)
    {
        if (ObjectExt::Is<IBlur>(imageTransform->idx_get(index)))
        {
            blurIndex = index;
            break;
        }
    }

    if (blurIndex >= 0)
    {
        imageTransform->RemoveAt(blurIndex);
        Console::WriteLine(u"The blur operation was removed.");
    }

    imageTransform->Clear();
    Console::WriteLine(u"Remaining operations: {0}", imageTransform->get_Count());
    presentation->Save(u"image-transforms-cleared.pptx", SaveFormat::Pptx);
}

presentation->Dispose();

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

考慮簡報格式與匯出目標

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

• 標準 DrawingML 作業（如亮度、灰階、雙調、色調、HSL、模糊及常見 Alpha 作業）最有可能在 PPTX 循環後仍然存留。若需保留，務必重新開啟產生的檔案並檢查集合。
• BrightnessContrast 是 Office 2010 的擴充，而非標準 DrawingML 亮度作業。它可用於記憶體中渲染，但在儲存與重新開啟 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 效果模型，而渲染匯出格式僅保留外觀，不會保留可編輯的變換作業。