# Zarządzanie efektami transformacji obrazu w prezentacjach na Androidzie > Stosuj, łącz, przeglądaj, usuwaj i weryfikuj efekty transformacji obrazu dla ramek obrazu przy użyciu Aspose.Slides dla Androida w języku Java. Source: https://docs.aspose.com/slides/pl/androidjava/image-transform-effects/ Updated: 2026-08-25 ## **Przegląd** Aspose.Slides reprezentuje korekty obrazu jako uporządkowaną kolekcję operacji transformacji obrazu. Dla ramki obrazu rozpocznij od [ISlidesPicture](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/islidespicture/) i uzyskaj dostęp do [ISlidesPicture.getImageTransform](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/islidespicture/#getImageTransform--). Zwrócona [IImageTransformOperationCollection](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/iimagetransformoperationcollection/) pozwala na dołączanie, enumerowanie, przeglądanie, usuwanie i czyszczenie efektów bez przepisywania pierwotnych bajtów obrazu. Ten artykuł przedstawia kompletny przepływ pracy dla jasności i kontrastu, transformacji kolorów, rozmycia, przezroczystości, łańcuchów efektów w kolejności, wartości efektywnych, usuwania oraz weryfikacji rund‑trip w formacie PPTX. ## **Zrozumienie własności efektu i ponownego użycia obrazu** Zasób obrazu i obraz wyświetlany w ramce to różne obiekty: - [IPPImage](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/ippimage/) przechowuje lub odwołuje się do danych źródłowych obrazu będących własnością prezentacji. - [ISlidesPicture](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/islidespicture/) należy do wypełnienia obrazu i odwołuje się do zasobu obrazu, jednocześnie przechowując kolekcję transformacji obrazu. - [IPictureFrame](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/ipictureframe/) jest kształtem slajdu, który posiada odpowiednie wypełnienie obrazu, geometrię, ustawienia przycięcia i inne formatowanie na poziomie ramki. W związku z tym operacje transformacji obrazu nie modyfikują bajtów w [IPPImage](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/ippimage/). Gdy ten sam `IPPImage` zostanie przekazany do [IShapeCollection.addPictureFrame](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/ishapecollection/#addPictureFrame-int-float-float-float-float-com.aspose.slides.IPPImage-) więcej niż raz, każda nowa ramka obrazu otrzymuje własny `ISlidesPicture` i własną kolekcję transformacji. Zastosowanie odcieni szarości do jednej ramki nie sprawia, że pozostałe ramki stają się szare, mimo że wszystkie korzystają z tego samego wbudowanego zasobu obrazu. Ten sam model `ISlidesPicture.getImageTransform` jest również używany przez inne wypełnienia obrazów, takie jak kształt lub tło slajdu. Przykłady poniżej koncentrują się na ramkach obrazu. ## **Używaj prawidłowych zakresów parametrów i jednostek** Prezentowane metody używają następujących zakresów semantycznych i jednostek. Trzymaj się tych wartości, nawet jeśli konkretna wersja biblioteki nie odrzuca od razu każdego nieprawidłowego parametru; format docelowej prezentacji może normalizować, pomijać lub odrzucać nieprawidłowe dane podczas zapisu lub otwierania pliku w programie PowerPoint. | Operacja | Parametry | Zakres i jednostka | |---|---|---| | [addBrightnessContrastEffect](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/iimagetransformoperationcollection/#addBrightnessContrastEffect-float-float-) | `brightness`, `contrast` | `-100` do `100`, procent; `0` pozostawia element niezmieniony. | | [addGrayScaleEffect](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/iimagetransformoperationcollection/#addGrayScaleEffect--) | Brak | Brak parametrów numerycznych. Alfa pozostaje niezmieniona. | | [addDuotoneEffect](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/iimagetransformoperationcollection/#addDuotoneEffect--) | `color1`, `color2` | Dwa kolory dla ciemnych i jasnych pikseli. Wartości kanałów RGB i alfa używane przez `android.graphics.Color` mieszczą się w przedziale od `0` do `255`. | | [addTintEffect](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/iimagetransformoperationcollection/#addTintEffect-float-float-) | `hue`, `amount` | `hue` od `0` (włącznie) do `360` (wyłącznie) stopni; `amount` od `-100` do `100`, procent. | | [addHSLEffect](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/iimagetransformoperationcollection/#addHSLEffect-float-float-float-) | `hue`, `saturation`, `luminance` | `hue` od `0` (włącznie) do `360` (wyłącznie) stopni; `saturation` i `luminance` od `-100` do `100`, procent. | | [addColorReplaceEffect](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/iimagetransformoperationcollection/#addColorReplaceEffect--) | `color` | Kolor zastąpienia używa wartości kanałów od `0` do `255`. Istniejące wartości alfa pozostają niezmienione. | | [addBlurEffect](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/iimagetransformoperationcollection/#addBlurEffect-double-boolean-) | `radius`, `grow` | `radius` jest nieujemny i mierzony w punktach; `grow` jest wartością logiczną określającą, czy rozmyta treść może wyjść poza pierwotne granice. | | [addAlphaModulateFixedEffect](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/iimagetransformoperationcollection/#addAlphaModulateFixedEffect-float-) | `amount` | Nieujemny procent. Użyj `0`‑`100` do typowego skalowania nieprzezroczystości: `0` to całkowita przezroczystość, `100` zachowuje istniejącą alfę. | | [addAlphaReplaceEffect](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/iimagetransformoperationcollection/#addAlphaReplaceEffect-float-) | `alpha` | `0`‑`100`, procent nieprzezroczystości. | | [addAlphaBiLevelEffect](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/iimagetransformoperationcollection/#addAlphaBiLevelEffect-float-) | `threshold` | `0`‑`100`, procentowy próg alfa. Wartości poniżej progu stają się przezroczyste; wartości równe lub powyżej progu stają się nieprzezroczyste. | Dla stałej modulacji alfa, przezroczystość i nieprzezroczystość są komplementarne. Przykładowo, 35 % przezroczystości odpowiada wartości modulacji alfa 65 %. ## **Zastosowanie jasności i kontrastu** [IImageTransformOperationCollection.addBrightnessContrastEffect](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/iimagetransformoperationcollection/#addBrightnessContrastEffect-float-float-) zwraca operację [IBrightnessContrast](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/ibrightnesscontrast/). Jej skalarne ustawienia są podawane w momencie tworzenia operacji. [IBrightnessContrast.getEffective](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/ibrightnesscontrast/#getEffective--) zwraca wyliczone wartości tylko do odczytu, które można przeglądać lub logować. Poniższy przykład zwiększa jasność o 15 % i kontrast o 20 %, a następnie renderuje podgląd bez modyfikacji wbudowanego obrazu: ```java 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](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/brightnesscontrast/) jest rozszerzeniem efektu obrazu Office 2010 i jest mniej przenośny niż standardowy efekt luminancji DrawingML. Gdy jasność i kontrast muszą pozostać edytowalne po rundzie PPTX, użyj [IImageTransformOperationCollection.addLuminanceEffect](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/iimagetransformoperationcollection/#addLuminanceEffect-float-float-) i zweryfikuj rezultat po ponownym otwarciu pliku. Sekcja ograniczeń formatów wyjaśnia tę różnicę bardziej szczegółowo. ## **Zastosowanie transformacji kolorów** Efekty kolorystyczne mogą być stosowane niezależnie do różnych ramek obrazu, które korzystają z jednego zasobu obrazu. Poniższy przykład tworzy pięć ramek i aplikuje kolejno odcienie szarości, duoton, odcień, regulację HSL oraz zamianę koloru. [IDuotone](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/iduotone/) zawiera dwa niezależnie edytowalne parametry koloru: `color1` przypisuje ciemnym pikselom, a `color2` jasnym pikselom. To sprawia, że jest to użyteczny przykład efektu o bardziej złożonych ustawieniach niż pojedyncza wartość skalarna. ```java 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](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/iimagetransformoperationcollection/#addColorReplaceEffect--) zamienia każdy piksel na jeden stały kolor, zachowując alfę. Różni się od [addColorChangeEffect](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/iimagetransformoperationcollection/#addColorChangeEffect--), który mapuje jeden kolor źródłowy na inny i udostępnia formaty zarówno koloru źródłowego, jak i docelowego. ## **Dodawanie rozmycia, przezroczystości i efektów alfa** [addBlurEffect](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/iimagetransformoperationcollection/#addBlurEffect-double-boolean-) wpływa na wszystkie kanały kolorów, w tym alfa. Ustaw `grow` na `true`, gdy rozmyta krawędź może wyjść poza pierwotne granice obrazu. Do jednolitej przezroczystości użyj [addAlphaModulateFixedEffect](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/iimagetransformoperationcollection/#addAlphaModulateFixedEffect-float-). Mnoży on każdą istniejącą wartość alfa, więc częściowo przezroczyste piksele pozostają proporcjonalnie różne. [addAlphaReplaceEffect](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/iimagetransformoperationcollection/#addAlphaReplaceEffect-float-) natomiast przydziela jedną wartość alfa wszystkim pikselom. [addAlphaBiLevelEffect](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/iimagetransformoperationcollection/#addAlphaBiLevelEffect-float-) konwertuje alfa na dwa poziomy w oparciu o podany próg. ```java 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(); } ``` Inne operacje alfa bez parametrów to [addAlphaCeilingEffect](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/iimagetransformoperationcollection/#addAlphaCeilingEffect--), które czyni każdą niezerową alfę w pełni nieprzezroczystą; [addAlphaFloorEffect](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/iimagetransformoperationcollection/#addAlphaFloorEffect--), które czyni każdą alfę poniżej 100 % całkowicie przezroczystą; oraz [addAlphaInverseEffect](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/iimagetransformoperationcollection/#addAlphaInverseEffect--), które zmienia alfę na `100% - alpha`. ## **Budowanie uporządkowanego łańcucha efektów** Każda metoda `add...Effect` dołącza nową operację na końcu kolekcji. Renderer używa kolekcji jako uporządkowanego potoku: wynik operacji 0 staje się wejściem operacji 1 i tak dalej. W konsekwencji te same operacje w innej kolejności mogą dawać inny obraz. Na przykład odcień szarości, a potem odcień najpierw usuwa informacje chromatyczne, a potem barwi wynik luminancji. Odcień po odcieniu szarości usuwa odcień ponownie. Analogicznie, zamiana alfa może nadpisać wartości alfa wyliczone przez wcześniejsze operacje, podczas gdy modulacja alfa zachowuje ich względne różnice. Poniższy przykład buduje łańcuch czterech operacji, zapisuje go jako PPTX, ponownie otwiera prezentację, sprawdza zarówno typy operacji, jak i ich kolejność, a następnie renderuje ponownie otwarty wynik: ```java 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(); } ``` Kolekcja nie narzuca matrycy kompatybilności, która ograniczałaby operacje koloru, alfa i rozmycia do osobnych łańcuchów. Mogą być łączone, ale nie zawsze jest to użyteczne. Stała zamiana koloru usuwa wariacje RGB stworzone przez wcześniejsze efekty kolorystyczne; odcień szarości po duotonie usuwa dwa wybrane kolory; a operacje alfa typu ceiling, floor, replace lub bi‑level mogą odrzucić szczegóły alfa stworzone wcześniej. Buduj łańcuch zgodnie z pożądaną kolejnością przetwarzania pikseli, a nie traktuj elementów jako nieuporządkowane flagi formatowania. ## **Przeglądanie wartości edytowalnych i efektywnych** Operacja edytowalna to obiekt przechowywany w `ISlidesPicture.getImageTransform`. W zależności od efektu może udostępniać zapisywalne pola bezpośrednio. Przykładowo, [IBlur](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/iblur/) udostępnia zapisywalne wartości `radius` i `grow`, [IAlphaModulateFixed](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/ialphamodulatefixed/) udostępnia zapisywalny `amount`, a [IAlphaBiLevel](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/ialphabilevel/) udostępnia zapisywalny `threshold`. Efekty kolorystyczne takie jak [IDuotone](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/iduotone/) udostępniają zmienne obiekty [IColorFormat](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/icolorformat/). Niektóre interfejsy operacji, w tym [IBrightnessContrast](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/ibrightnesscontrast/), [IHSL](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/ihsl/), [ITint](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/itint/) i [IAlphaReplace](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/ialphareplace/), nie udostępniają swoich skalarnych parametrów tworzenia jako zapisywalnych właściwości. Aby zmienić te ustawienia, usuń operację i dodaj nową w wymaganej pozycji. Dane efektywne zwracane przez `getEffective()` są wyliczone i tylko do odczytu. Są przydatne do rozwiązywania kolorów zależnych od motywu oraz odczytywania znormalizowanych wartości używanych przez renderer, ale nie stanowią dodatkowej powierzchni edycji. Poniższy przykład enumeruje łańcuch i przegląda wartości efektywne, gdzie odpowiednie API je udostępnia: ```java 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(); } ``` Efekty bez parametrów, takie jak odcień szarości, alfa ceiling i alfa inverse, również posiadają obiekt danych efektywnych, ale nie mają skalarnych ustawień do wypisania. Ich obecność i pozycja w kolekcji są istotną informacją. ## **Usuwanie lub czyszczenie transformacji obrazu** Użyj [IImageTransformOperationCollection.removeAt](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/iimagetransformoperationcollection/#removeAt-int-) aby usunąć jedną operację po indeksie. Ponieważ indeksy zmieniają się po usunięciu, najpierw znajdź docelowy element, a potem go usuń po enumeracji. Użyj [ImageTransformOperationCollection.clear](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/imagetransformoperationcollection/#clear--) aby usunąć cały łańcuch. ```java 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(); } ``` Usunięcie lub wyczyszczenie transformacji zmienia wyłącznie formatowanie obrazu. Nie usuwa, nie rekompresuje ani nie modyfikuje ponownie używanego zasobu [IPPImage](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/ippimage/). ## **Rozważanie formatów prezentacji i docelowych formatów eksportu** Transformacje obrazu pochodzą z DrawingML, więc PPTX jest preferowanym edytowalnym formatem dla łańcuchów efektów. Nawet w PPTX nie każda operacja ma identyczną przenośność: - Standardowe operacje DrawingML, takie jak luminancja, odcień szarości, duoton, odcień, HSL, rozmycie i typowe operacje alfa, mają największą szansę przetrwania rundy PPTX. Zawsze ponownie otwieraj wygenerowany plik i sprawdzaj kolekcję, gdy zachowanie jest wymogiem. - [BrightnessContrast](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/brightnesscontrast/) jest rozszerzeniem Office 2010, a nie standardową operacją luminancji DrawingML. Może być używany do renderowania w pamięci, ale nie ma gwarancji, że po zapisaniu i ponownym otwarciu PPTX pozostanie edytowalnym [IBrightnessContrast](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/ibrightnesscontrast/). Preferuj [addLuminanceEffect](https://reference.aspose.com/slides/pl/androidjava/com.aspose.slides/iimagetransformoperationcollection/#addLuminanceEffect-float-float-) dla trwałych korekt jasności i kontrastu. - Binarny format PPT powstał przed pełnym modelem efektów DrawingML. Zapis do PPT może pomijać nieobsługiwane operacje, redukować łańcuch do obsługiwanego podzbioru lub przybliżać wygląd. Nie używaj PPT jako formatu weryfikacji dla złożonego edytowalnego łańcucha. - Renderowanie do PNG, JPEG, TIFF, PDF, SVG, HTML lub innych wyjść wizualnych stosuje obsługiwany łańcuch do wyglądu renderowanego. Te wyjścia nie zawierają edytowalnego `IImageTransformOperationCollection`; formaty rastrowe spłaszczają wynik do pikseli, a eksporty dokumentów/wektorów przechowują własną reprezentację renderowania. - Efekty nie czynią połączonego obrazu samodzielnym. Renderowanie połączonego obrazu nadal wymaga dostępności połączonego zasobu w momencie ładowania prezentacji. Różni odbiorcy prezentacji mogą renderować przypadki brzegowe inaczej, szczególnie gdy połączone są wiele operacji alfa lub kwantyzacji kolorów. Dla krytycznych wyjść testuj zarówno edytowalną rundę, jak i finalny format eksportu przy użyciu tej samej wersji Aspose.Slides, której używasz w produkcji. ## **FAQ** **Czy efekty transformacji obrazu modyfikują wbudowane dane obrazu?** Nie. Operacje należą do `ISlidesPicture` używanego w wypełnieniu obrazu. Bajty podstawowego `IPPImage` pozostają niezmienione. **Czy dwie ramki obrazu, które używają tego samego obrazu, będą współdzielić efekty?** Nie. Ponowne użycie `IPPImage` eliminuje duplikację danych obrazu, ale każda ramka obrazu zazwyczaj ma oddzielny `ISlidesPicture` i własną kolekcję transformacji obrazu. **Czy efekty koloru, rozmycia i alfa można łączyć?** Tak. Kolekcja przyjmuje je w jednym uporządkowanym łańcuchu. Rozważ, jak każda operacja wpływa na wynik poprzedniej, ponieważ operacje zamiany i progowe mogą usuwać wcześniej stworzone szczegóły koloru lub alfa. **Dlaczego wartości efektywne są tylko do odczytu?** Dane efektywne reprezentują wyliczone wartości używane do renderowania, w tym rozwiązane kolory. Edytuj operację przechowywaną w kolekcji transformacji, gdzie istnieją zapisywalne pola; w przeciwnym razie usuń ją i dodaj nową z innymi parametrami tworzenia. **Jaki format powinienem wybrać, aby zachować łańcuch transformacji?** Używaj PPTX i weryfikuj plik, ponownie go otwierając. Starszy format PPT nie może przedstawić pełnego modelu efektów DrawingML, a formaty eksportu (PNG, PDF itp.) zachowują jedynie wygląd, a nie edytowalne operacje transformacji.