Správa rámců obrázků v prezentacích pomocí Javy

O čem je tato stránka

Vytvářejte, formátujte, propojujte, ořezávejte, extrahujte a komprimujte rámy obrázků v prezentacích pomocí Aspose.Slides pro Javu.

Přehled

Rámeček obrázku je tvar snímku, který zobrazuje obrázek. V Aspose.Slides jsou zdroj obrázku a tvar, který jej zobrazuje, samostatné objekty: Presentation vlastní vložené zdroje obrázků prostřednictvím svého IImageCollection, zatímco IPictureFrame řídí pozici, velikost, formátování čáry, otáčení, ořez, efekty obrázku a další nastavení na úrovni rámce.

Toto oddělení je užitečné, když je stejný obrázek zobrazen vícekrát. Přidejte obrázek do prezentace jednou, uložte vrácený IPPImage, a použijte tento zdroj obrázku při vytváření rámců obrázků.

Rámečky obrázků mohou obsahovat rastrové obrázky jako PNG nebo JPEG a vektorové obrázky SVG. Mohou také odkazovat na propojené obrázky namísto ukládání bajtů obrázku do prezentace. Volba ovlivňuje přenositelnost, velikost souboru, extrakci a chování při exportu, takže je užitečné rozhodnout, jak má být obrázek uložen, ještě před aplikací formátování nebo optimalizace.

Přidání a formátování vloženého obrázku

U vloženého obrázku přidejte data obrázku do prezentace a vytvořte rámec obrázku pomocí IShapeCollection.addPictureFrame. Obrázek se stane součástí balíčku prezentace, takže prezentace zůstane samostatná i po přesunu na jiný počítač.

Následující příklad přidá JPEG obrázek, vytvoří rámec v přirozených rozměrech obrázku a aplikuje formátování čáry a otočení:

import com.aspose.slides.*;
import java.awt.Color;

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

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

    IPictureFrame pictureFrame = slide.getShapes().addPictureFrame(ShapeType.Rectangle, 50, 100, image.getWidth(), image.getHeight(), image);
    pictureFrame.getLineFormat().getFillFormat().setFillType(FillType.Solid);
    pictureFrame.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE);
    pictureFrame.getLineFormat().setWidth(3);
    pictureFrame.setRotation(15);

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

Rámeček obrázku řídí zobrazovanou geometrii; změna velikosti rámce nemění původní rozlišení pixelů uložených ve vloženém zdroji obrázku. Tento rozdíl je důležitý při pozdějším ořezu nebo kompresi obrázku.

Použití relativního měřítka

IPictureFrame poskytuje relativní škálování šířky a výšky rámce pomocí setRelativeScaleWidth a setRelativeScaleHeight. Hodnota 1.0 odpovídá 100 % původní velikosti obrázku. Relativní měřítko je užitečné, když workflow potřebuje zachovat vztah k velikosti zdrojového obrázku místo ručního výpočtu konečných rozměrů.

import com.aspose.slides.*;

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

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

    IPictureFrame pictureFrame = slide.getShapes().addPictureFrame(ShapeType.Rectangle, 50, 50, 100, 100, image);
    pictureFrame.setRelativeScaleWidth(1.35f);
    pictureFrame.setRelativeScaleHeight(0.8f);

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

Relativní měřítko mění nastavení měřítka rámce; neprovádí přeškálování ani kompresi vloženého obrázku.

Vložené a propojené obrázky

Vložený obrázek ukládá data obrázku uvnitř prezentace a je proto nejn bezpečnější volbou pro přenositelnost a předvídatelné vykreslování. Propojený obrázek ukládá externí umístění pomocí metody ISlidesPicture.setLinkPathLong místo vkládání dat obrázku stejným způsobem.

Propojené obrázky mohou snížit množství dat uložených v PPTX, ale zavádějí externí závislost. Propojený soubor musí zůstat dostupný aplikaci, která prezentaci otevírá nebo vykresluje. Pokud se cesta změní, soubor se přesune nebo zdroj nebude dostupný, může se propojený obrázek nezobrazit podle očekávání. Pro prezentace, které musí být posílány e‑mailem, archivovány nebo vykreslovány v izolovaných prostředích, jsou vložené obrázky obvykle spolehlivější.

Přidání propojeného obrázku

Následující příklad vytvoří rámec obrázku a ukáže jej na lokální soubor obrázku. Zabývá se pouze propojením obrázku; propojení videa je samostatný mediální workflow a je úmyslně odděleno od tohoto příkladu.

import com.aspose.slides.*;
import java.io.File;

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

    IPictureFrame pictureFrame = slide.getShapes().addPictureFrame(ShapeType.Rectangle, 50, 50, 320, 180, null);
    File linkedImageFile = new File("linked-image.jpg");
    String linkPath = linkedImageFile.getAbsolutePath();
    pictureFrame.getPictureFormat().getPicture().setLinkPathLong(linkPath);

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

Používejte odkazy, když je správa externích souborů záměrná. Nepoužívejte je jen jako náhradu za kompresi: malý PPTX s poškozenými závislostmi na obrázcích je obvykle méně užitečný než větší samostatná prezentace.

Extrahování obrázků z rámců obrázků

Před extrahováním obrázku z existující prezentace ověřte, že tvar je skutečně IPictureFrame a že obsahuje vložený obrázek. Propojené rámce obrázků nemusí obsahovat bajty obrázku, které lze extrahovat stejným způsobem.

Extrahování rastrového obrázku

Moderní API pro obrázky používá přímo IImage a nevyžaduje starší Java wrapper. Následující příklad najde první vložený rastrový obrázek na snímku a uloží jej jako PNG:

import com.aspose.slides.*;

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

    for (IShape shape : slide.getShapes()) {
        if (!(shape instanceof IPictureFrame)) {
            continue;
        }

        IPictureFrame pictureFrame = (IPictureFrame) shape;
        IPPImage embeddedImage = pictureFrame.getPictureFormat().getPicture().getImage();
        if (embeddedImage == null || embeddedImage.getSvgImage() != null) {
            continue;
        }

        IImage rasterImage = embeddedImage.getImage();
        try {
            rasterImage.save("extracted-image.png", ImageFormat.Png);
        } finally {
            rasterImage.dispose();
        }
        break;
    }
} finally {
    presentation.dispose();
}

Ukládání pomocí IImage.save převádí extrahovaný obrázek do požadovaného výstupního formátu. Pokud potřebujete zakódované bajty uložené v prezentaci místo převedeného rastrového souboru, použijte binární data zdroje obrázku.

Extrahování SVG obrázku

Pro SVG obrázek IPPImage poskytuje objekt ISvgImage. Ten vám umožní získat SVG data přímo místo rasterizace obrázku nejprve.

import com.aspose.slides.*;
import java.io.FileOutputStream;
import java.io.IOException;

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

    for (IShape shape : slide.getShapes()) {
        if (!(shape instanceof IPictureFrame)) {
            continue;
        }

        IPictureFrame pictureFrame = (IPictureFrame) shape;
        IPPImage embeddedImage = pictureFrame.getPictureFormat().getPicture().getImage();
        ISvgImage svgImage = embeddedImage != null ? embeddedImage.getSvgImage() : null;
        if (svgImage == null) {
            continue;
        }

        byte[] svgData = svgImage.getSvgData();
        FileOutputStream outputStream = new FileOutputStream("extracted-image.svg");
        try {
            outputStream.write(svgData);
        } finally {
            outputStream.close();
        }
        break;
    }
} finally {
    presentation.dispose();
}

Uchování SVG obsahu jako SVG zachovává vektorový zdroj uvnitř prezentace. Rasterové exporty jako PNG nebo JPEG nutně převádějí tento vektorový obsah na pixely. Export snímku do PDF nebo SVG je také operace renderování, takže exportovaná grafika by neměla být považována za bit‑po‑bitovou kopii původního vloženého SVG; použijte data ISvgImage.getSvgData vloženého SVG, pokud je vyžadován samotný vektorový zdroj.

Ořez obrázku

Ořez mění, která část obrázku je viditelná uvnitř rámce. Hodnoty ořezu na IPictureFillFormat jsou procenta rozměrů zdrojového obrázku. Ořez zpočátku neodstraňuje skryté pixely ze vloženého obrázku; pouze mění viditelný region.

Následující příklad bezpečně najde rámec obrázku a aplikuje hodnoty ořezu:

import com.aspose.slides.*;

Presentation presentation = new Presentation("sample.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IPictureFrame pictureFrame = null;

    for (IShape shape : slide.getShapes()) {
        if (shape instanceof IPictureFrame) {
            pictureFrame = (IPictureFrame) shape;
            break;
        }
    }

    if (pictureFrame != null) {
        pictureFrame.getPictureFormat().setCropLeft(23.6f);
        pictureFrame.getPictureFormat().setCropRight(21.5f);
        pictureFrame.getPictureFormat().setCropTop(3f);
        pictureFrame.getPictureFormat().setCropBottom(31f);
        presentation.save("cropped-image.pptx", SaveFormat.Pptx);
    }
} finally {
    presentation.dispose();
}

Protože skrytá data obrázku jsou stále přítomna, lze ořez později změnit bez ztráty původních pixelů. Pokud je velikost souboru důležitější než reverzibilita, lze ořezané oblasti fyzicky odstranit, jak je popsáno v další sekci.

Odstranění ořezaných dat obrázku

IPictureFillFormat.deletePictureCroppedAreas odstraňuje data obrázku mimo aktuální ořezový obdélník a vrací výsledný zdroj obrázku. To může snížit velikost souboru, ale jedná se o destruktivní optimalizaci: po uložení prezentace již odstraněné pixely nejsou k dispozici pro pozdější operaci odříznutí.

import com.aspose.slides.*;

Presentation presentation = new Presentation("cropped-image.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IPictureFrame pictureFrame = null;

    for (IShape shape : slide.getShapes()) {
        if (shape instanceof IPictureFrame) {
            pictureFrame = (IPictureFrame) shape;
            break;
        }
    }

    if (pictureFrame != null) {
        IPPImage croppedImage = pictureFrame.getPictureFormat().deletePictureCroppedAreas();
        if (croppedImage != null) {
            presentation.save("cropped-data-removed.pptx", SaveFormat.Pptx);
        }
    }
} finally {
    presentation.dispose();
}

Metoda může do prezentace přidat nový zdroj obrázku. Pokud je původní obrázek také používán dalšími rámečky, tyto rámce stále potřebují svůj existující zdroj, takže smazání ořezaných oblastí nutně nesnižuje celkový počet obrázků. Ořez WMF nebo EMF pomocí této metody rasterizuje ořezaný výsledek do PNG.

Komprese rastrových obrázků

IPictureFillFormat.compressImage snižuje rozlišení rastrového obrázku relativně k velikosti, v níž je obrázek zobrazen. Může také během stejné operace odstranit ořezané oblasti. Metoda vrací true, když byl obrázek změněn velikostí nebo oříznut, a false, když nebyla nutná žádná změna.

Použijte předdefinovanou hodnotu PicturesCompression, když stačí standardní cílové rozlišení:

import com.aspose.slides.*;

Presentation presentation = new Presentation("sample.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IPictureFrame pictureFrame = null;

    for (IShape shape : slide.getShapes()) {
        if (shape instanceof IPictureFrame) {
            pictureFrame = (IPictureFrame) shape;
            break;
        }
    }

    if (pictureFrame != null) {
        boolean compressed = pictureFrame.getPictureFormat().compressImage(true, PicturesCompression.Dpi150);
        System.out.println(compressed ? "The image was compressed." : "No compression was necessary.");
        presentation.save("compressed-image.pptx", SaveFormat.Pptx);
    }
} finally {
    presentation.dispose();
}

Místo předdefinované hodnoty lze předat vlastní kladnou hodnotu DPI, pokud je požadován specifický cíl.

Kompresi je určena pro rastrové obrázky. SVG a metafily nejsou tímto rasterovým kompresním workflow zmenšeny. Také si pamatujte, že nižší rozlišení a smazané ořezané oblasti nelze z optimalizované prezentace obnovit. Zvolte cílové rozlišení na základě největší velikosti, při které bude obrázek skutečně zobrazován nebo exportován, místo aby se globálně aplikovalo nejnižší DPI.

Správa efektů transformace obrázku

Kompletní workflow zahrnující jas, kontrast, barevné transformace, rozmazání, alfa‑efekty, řetězce, inspekci, odstranění a verifikaci na zpětnou cestu najdete v Image Transform Effects.

Uzamčení geometrie rámce obrázku

Nastavení IPictureFrameLock řídí, které editační operace jsou pro rámec obrázku zakázány. Například setAspectRatioLocked zachovává proporce tvaru během změny velikosti.

import com.aspose.slides.*;

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

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

    IPictureFrame pictureFrame = slide.getShapes().addPictureFrame(ShapeType.Rectangle, 50, 100, image.getWidth(), image.getHeight(), image);
    pictureFrame.getPictureFrameLock().setAspectRatioLocked(true);

    presentation.save("locked-picture-frame.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Uzamčení platí pro tvar rámce obrázku. Nenutí zdrojový obrázek k přeškálování nebo trvalé změně poměru stran.

Úprava hodnot StretchOffset

Když je režim výplně obrázku nastaven na roztažení, hodnoty stretch‑offset na IPictureFillFormat definují výplňový obdélník relativně k omezujícímu rámečku rámce obrázku. Kladná procenta vytvářejí odsazení od okraje, záporná procenta pak vyčlenění.

Jedná se o něco jiného než ořez. Hodnoty ořezu vybírají, která část zdrojového obrázku je viditelná; stretch‑offsety mění obdélník, do kterého je viditelná výplň obrázku natáhnuta.

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, 10, 10, 400, 300, image);
    pictureFrame.getPictureFormat().setPictureFillMode(PictureFillMode.Stretch);
    pictureFrame.getPictureFormat().setStretchOffsetLeft(12f);
    pictureFrame.getPictureFormat().setStretchOffsetRight(12f);
    pictureFrame.getPictureFormat().setStretchOffsetTop(8f);
    pictureFrame.getPictureFormat().setStretchOffsetBottom(8f);

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

Používejte stretch‑offsety pro umístění výplně. Používejte vlastnosti ořezu, když cílem je skrýt okraje zdrojového obrázku.

Úložiště, velikost souboru a úvahy o exportu

Hlavní kompromisy jsou snáze říditelné, když je ukládání obrázků a formátování rámců odděleno:

Vložené obrázky činí prezentaci samostatnou a jsou nejspolehlivější pro sdílení a server‑side renderování, ale velké rastrové obrázky zvětšují velikost PPTX a spotřebu paměti.
Propojené obrázky mohou balíček zmenšit, ale prezentace závisí na tom, že externí soubory zůstanou dostupné na uložených cestách nebo umístěních.
Ořez je zpočátku ne‑destruktivní. Skryté pixely zůstávají vložené, dokud nejsou ořezané oblasti výslovně smazány nebo odstraněny během komprese.
Kompresi může podstatně zmenšit velikost souboru u nadměrných rastrových obrázků, ale snižuje původní rozlišení. Použijte ji po určení zamýšlené velikosti na snímku.
SVG obrázky by měly zůstat jako SVG, když je důležitá zachování vektoru. Extrahujte vložený SVG přímo, pokud potřebujete samotný vektorový zdroj. Rasterové exporty snímků vždy převádějí vykreslený snímek na pixely.
Opakované obrázky by měly znovu použít existující zdroj IPPImage, pokud je to možné, místo opakovaného načítání stejného souboru do workflow prezentace.

Pro velké prezentace je optimalizace obrázků obvykle nejúčinnější, když je prováděna selektivně: loga a diagramy ponechte jako vektorový obsah, komprimujte fotografie podle skutečné zobrazovací velikosti, odstraňujte ořezané pixely jen když úpravy nejsou vyžadovány, a vyhýbejte se externím odkazům, pokud není správa závislostí součástí nasazovacího designu.

Často kladené otázky

Jaký je rozdíl mezi rámcem obrázku a zdrojem obrázku?

IPPImage představuje zdroj obrázku spojený s prezentací. IPictureFrame je tvar na snímku, který zobrazuje obrázek a ukládá geometrické a formátovací informace na úrovni rámce, jako jsou velikost, otáčení, hodnoty ořezu, efekty a uzamčení.

Mám vložit nebo propojit obrázky?

Vkládejte obrázky, když musí být prezentace přenosná, archivována nebo vykreslena bez přístupu k externím zdrojům. Propojujte obrázky jen když je úmyslné mít soubory mimo PPTX a externí umístění lze spolehlivě udržovat.

Snižuje ořez velikost souboru PPTX?

Ne samostatně. Normální nastavení ořezu skryje části zdrojového obrázku, ale ponechává podkladové pixely. Použijte IPictureFillFormat.deletePictureCroppedAreas nebo kompresi s odstraněním ořezaných oblastí, když lze tyto pixely trvale odstranit.

Mohu obnovit kvalitu obrázku po kompresi?

Ne. Komprese může snížit uložené rastrové rozlišení a odstranění ořezaných oblastí ztrácí data obrázku. Uchovejte originální zdrojový obrázek mimo prezentaci, pokud může být později potřeba úprava v plné kvalitě.

Jak by se měly zacházet s SVG obrázky?

Uchovávejte SVG obsah jako SVG, když záleží na vektorové věrnosti. Vložený ISvgImage lze extrahovat přímo. Renderování snímku do rastrového formátu jako PNG nebo JPEG rasterizuje SVG jako součást obrázku snímku.

Jak se vyhnout nebezpečným přetypováním při čtení existujících snímků?

Před použitím členů specifických pro rámec obrázku zkontrolujte typ tvaru. Kontrola instanceof vůči IPictureFrame zabraňuje neplatným přetypováním a umožňuje kódu zpracovat snímky, které neobsahují rámce obrázků.

Správa efektů transformace obrázku v prezentacích s Java