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가 파일을 열 때 무효 데이터를 정규화, 생략 또는 거부할 수 있습니다.

작업	매개변수	유효 범위 및 단위
AddBrightnessContrastEffect	`brightness`, `contrast`	`-100`에서 `100`까지, 백분율; `0`은 해당 구성 요소를 변경하지 않음.
AddGrayScaleEffect	없음	숫자 매개변수 없음. 알파는 변경되지 않음.
AddDuotoneEffect	`Color1`, `Color2`	어두운 픽셀과 밝은 픽셀을 위한 두 색상. `System::Drawing::Color`의 RGB 및 알파 채널은 `0`에서 `255`까지 사용.
AddTintEffect	`hue`, `amount`	색조는 `0`(포함)부터 `360`(제외)까지, 단위는 도; 양은 `-100`에서 `100`까지, 백분율.
AddHSLEffect	`hue`, `saturation`, `luminance`	색조는 `0`(포함)부터 `360`(제외)까지, 단위는 도; 채도와 명도는 `-100`에서 `100`까지, 백분율.
AddColorReplaceEffect	`Color`	대체 색상은 채널 값을 `0`~`255` 사용합니다. 기존 알파 값은 변경되지 않음.
AddBlurEffect	`radius`, `grow`	반경은 음수가 아니며 포인트 단위로 측정됩니다; `grow`는 흐려진 내용이 원본 경계 밖으로 확장될 수 있는지 제어합니다.
AddAlphaModulateFixedEffect	`amount`	음수가 아닌 백분율. 일반 불투명도 스케일링에는 `0`~`100`을 사용: `0`은 완전 투명, `100`은 기존 알파를 유지.
AddAlphaReplaceEffect	`alpha`	`0`~`100`, 백분율 불투명도.
AddAlphaBiLevelEffect	`threshold`	`0`~`100`, 백분율 알파 임계값. 임계값 이하 값은 투명해지고, 임계값 이상 값은 불투명해짐.

고정 알파 변조의 경우 투명도와 불투명도는 보완 관계에 있습니다. 예를 들어 35% 투명도는 알파 변조 값 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는 알파를 보존하면서 모든 픽셀 색상을 고정 색상으로 교체합니다. 이는 하나의 원본 색을 다른 색으로 매핑하고 두 색 형식을 모두 노출하는 AddColorChangeEffect와 다릅니다.

블러, 투명도 및 알파 효과 추가

AddBlurEffect는 알파를 포함한 모든 색 채널에 영향을 줍니다. 흐려진 가장자리가 원본 그림 경계를 넘어설 수 있는 경우 grow를 true로 설정하십시오.

균일한 투명도를 위해서는 AddAlphaModulateFixedEffect를 사용합니다. 이는 기존 알파 값을 모두 곱하므로 부분 투명 픽셀은 비례적으로 차이를 유지합니다. AddAlphaReplaceEffect는 모든 픽셀에 단일 알파 값을 할당하고, AddAlphaBiLevelEffect는 임계값을 기준으로 알파를 두 수준으로 변환합니다.

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

파라미터가 없는 다른 알파 작업으로는 AddAlphaCeilingEffect가 있으며, 이는 모든 비영 알파를 완전 불투명하게 만들고, AddAlphaFloorEffect는 100% 이하 알파를 완전 투명하게 만들며, AddAlphaInverseEffect는 알파를 100% - alpha 로 바꿉니다.

순서가 지정된 효과 체인 구축

모든 Add...Effect 메서드는 새 작업을 컬렉션 끝에 추가합니다. 렌더러는 컬렉션을 순서가 지정된 파이프라인으로 사용합니다: 작업 0의 출력이 작업 1의 입력이 되고, 이와 같이 진행됩니다. 따라서 동일한 작업이라도 순서를 바꾸면 다른 이미지가 생성될 수 있습니다.

예를 들어, 그레이스케일 후 틴트를 적용하면 먼저 색 정보를 제거하고 그 다음에 명도 결과를 다시 색칠합니다. 틴트 후 그레이스케일을 적용하면 틴트가 다시 사라집니다. 마찬가지로 알파 교체는 이전 작업에서 계산된 알파 값을 덮어쓸 수 있으며, 알파 변조는 상대적인 차이를 유지합니다.

다음 예제는 네 개 작업으로 구성된 체인을 만들고, 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();

컬렉션은 색상, 알파 및 블러 작업을 별도 체인으로 제한하는 호환성 매트릭스를 강제하지 않습니다. 이들 작업을 조합할 수 있지만 조합이 항상 유용한 것은 아닙니다. 고정 색상 교체는 이전 색상 효과가 만든 RGB 변화를 제거하고, 듀오톤 후 그레이스케일은 두 선택 색을 모두 없앱니다; 알파 천장, 바닥, 교체 또는 바이레벨 작업은 이전에 만든 알파 세부 정보를 삭제할 수 있습니다. 원하는 픽셀 처리 순서에 따라 체인을 구성하고, 항목을 무순서 서식 플래그처럼 취급하지 마십시오.

편집 가능한 값 및 유효값 검사

편집 가능한 작업은 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();

그레이스케일, 알파 천장, 알파 역전과 같은 파라미터가 없는 효과도 유효 데이터 객체를 가지고 있지만 출력할 스칼라 설정이 없습니다. 컬렉션 내 존재 여부와 위치가 중요한 정보입니다.

이미지 변환 제거 또는 초기화

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에서도 모든 작업이 동일한 이식성을 갖는 것은 아닙니다:

명도, 그레이스케일, 듀오톤, 틴트, HSL, 블러 및 일반 알파 작업과 같은 표준 DrawingML 작업은 PPTX 왕복 후에도 살아남을 가능성이 가장 높습니다. 보존이 요구될 경우 생성된 파일을 항상 재열어 컬렉션을 확인하십시오.
BrightnessContrast는 표준 DrawingML 명도 작업이 아닌 Office 2010 확장입니다. 메모리 내 렌더링에는 사용할 수 있지만, 저장 후 PPTX를 다시 열 때 편집 가능한 IBrightnessContrast 형태로 유지된다는 보장은 없습니다. 지속적인 밝기·대비 조정에는 AddLuminanceEffect를 권장합니다.
이진 PPT 형식은 전체 DrawingML 효과 모델보다 오래되었습니다. PPT로 저장하면 지원되지 않는 작업이 생략되거나 체인이 지원되는 부분 집합으로 축소되거나 근사화될 수 있습니다. 복잡한 편집 체인의 검증 형식으로 PPT를 사용하지 마십시오.
PNG, JPEG, TIFF, PDF, SVG, HTML 등 시각적 출력으로 렌더링하면 지원되는 체인을 외형에 적용합니다. 이러한 출력에는 편집 가능한 IImageTransformOperationCollection이 포함되지 않으며, 래스터 형식은 결과를 픽셀로 평탄화하고 문서 또는 벡터 내보내기는 자체 렌더링 표현을 저장합니다.
효과는 연결된 이미지를 자체 포함형으로 만들지 않습니다. 연결된 그림을 렌더링하려면 프레젠테이션 로드 시 연결된 리소스가 여전히 사용 가능해야 합니다.

여러 알파 또는 색상 양자화 작업을 결합할 경우 가장자리 사례를 다르게 렌더링할 수 있는 프레젠테이션 소비자가 있습니다. 중요한 출력물의 경우 편집 가능한 왕복과 최종 내보내기 형식을 모두 동일한 Aspose.Slides 버전으로 테스트하십시오.

FAQ

이미지 변환 효과가 임베디드 이미지 데이터를 수정합니까?

아닙니다. 작업은 그림 채우기가 사용하는 ISlidesPicture에 속합니다. 기본 IPPImage 바이트는 변경되지 않습니다.

같은 이미지를 재사용하는 두 그림 프레임이 효과를 공유합니까?

아닙니다. IPPImage를 재사용하면 이미지 데이터 중복을 방지하지만 각 그림 프레임은 일반적으로 별도의 ISlidesPicture와 이미지 변환 컬렉션을 가집니다.

색상, 블러 및 알파 효과를 결합할 수 있습니까?

예. 컬렉션은 하나의 순서가 지정된 체인으로 이들을 허용합니다. 각각의 작업이 이전 작업의 출력에 어떻게 영향을 미치는지 고려하십시오. 교체 및 임계값 작업은 이전 색상이나 알파 세부 정보를 삭제할 수 있습니다.

유효값이 읽기 전용인 이유는 무엇입니까?

유효 데이터는 렌더링에 사용되는 계산된 값(해결된 색상 포함)을 나타냅니다. 쓰기 가능한 멤버가 있는 경우 변환 컬렉션에 저장된 작업을 편집하고, 그렇지 않으면 작업을 제거하고 새 생성 매개변수로 교체하십시오.

어떤 형식이 변환 체인을 보존하기에 가장 적합합니까?

PPTX를 사용하고 파일을 재열어 확인하십시오. 레거시 PPT는 전체 DrawingML 효과 모델을 표현할 수 없으며, 렌더링 내보내기 형식은 외형을 보존하지만 편집 가능한 변환 작업을 포함하지 않습니다.

프레젠테이션에서 C++을 사용한 오디오 관리