Beheer afbeeldingsframes in presentaties op Android

Waar deze pagina over gaat

Maak, formatteer, koppel, snijd bij, extraheer en comprimeer afbeeldingsframes in presentaties met Aspose.Slides voor Android via Java.

Overzicht

Een picture frame is een dia‑vorm die een afbeelding weergeeft. In Aspose.Slides zijn de afbeeldingsresource en de vorm die deze weergeeft afzonderlijke objecten: een Presentation bezit ingebedde afbeeldingsresources via zijn IImageCollection, terwijl een IPictureFrame de positie, grootte, lijnopmaak, rotatie, bijsnijden, afbeeldingseffecten en andere instellingen op frame‑niveau regelt.

Deze scheiding is handig wanneer dezelfde afbeelding meer dan eens wordt getoond. Voeg de afbeelding één keer toe aan de presentatie, bewaar de geretourneerde IPPImage, en gebruik die afbeeldingsresource bij het creëren van picture frames.

Picture frames kunnen rasterafbeeldingen zoals PNG of JPEG en vector‑SVG‑afbeeldingen bevatten. Ze kunnen ook verwijzen naar gekoppelde afbeeldingen in plaats van de afbeeldingsbytes in de presentatie op te slaan. De keuze beïnvloedt draagbaarheid, bestandsgrootte, extractie en exportgedrag, dus het is zinvol om vooraf te bepalen hoe de afbeelding moet worden opgeslagen voordat formatteer‑ of optimalisatiestappen worden toegepast.

Een Ingebedde Afbeelding Toevoegen en Formatteren

Voor een ingebedde afbeelding voeg je de afbeeldingsgegevens toe aan de presentatie en maak je een picture frame met IShapeCollection.addPictureFrame. De afbeelding wordt onderdeel van het presentatiedossier, waardoor de presentatie zelf‑voorzienend blijft wanneer deze naar een andere computer wordt verplaatst.

Het volgende voorbeeld voegt een JPEG‑afbeelding toe, maakt een frame met de oorspronkelijke afmetingen van de afbeelding en past lijnopmaak en rotatie toe:

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.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();
}

Het picture frame bepaalt de weergave‑geometrie; het wijzigen van de frame‑grootte verandert de originele pixelafmetingen die in de ingebedde afbeeldingsresource zijn opgeslagen. Dit onderscheid wordt belangrijk bij later bijsnijden of comprimeren van een afbeelding.

Relatieve Schaling Gebruiken

IPictureFrame biedt relatieve breedte‑ en hoogteschaling voor het frame via setRelativeScaleWidth en setRelativeScaleHeight. Een waarde van 1.0 correspondeert met 100 % van de originele afbeeldinggrootte. Relatieve schaal is nuttig wanneer een workflow de verhouding tot de bronafbeelding wil behouden in plaats van de uiteindelijke afmetingen handmatig te berekenen.

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

Relatieve schaal wijzigt de schaalinstellingen van het frame; het resamplet of comprimeert de ingebedde afbeelding niet.

Ingebedde en Gekoppelde Afbeeldingen

Een ingebedde afbeelding slaat afbeeldingsgegevens binnen de presentatie op en is daarom de veiligste keuze voor draagbaarheid en voorspelbare rendering. Een gekoppelde afbeelding slaat een extern pad op via de methode ISlidesPicture.setLinkPathLong in plaats van de afbeeldingsgegevens op dezelfde manier in te sluiten.

Gekoppelde afbeeldingen kunnen de hoeveelheid afbeeldingsdata in de PPTX verminderen, maar ze introduceren een externe afhankelijkheid. Het gekoppelde bestand moet toegankelijk blijven voor de applicatie die de presentatie opent of rendert. Als het pad verandert, het bestand wordt verplaatst of de resource niet beschikbaar is, wordt de gekoppelde afbeelding mogelijk niet zoals verwacht weergegeven. Voor presentaties die per e‑mail moeten worden verzonden, gearchiveerd of gerenderd in geïsoleerde omgevingen, zijn ingebedde afbeeldingen doorgaans betrouwbaarder.

Een Gekoppelde Afbeelding Toevoegen

Het volgende voorbeeld maakt een picture frame aan en wijst het naar een lokaal afbeeldingsbestand. Het behandelt alleen afbeeldingskoppelingen; videokoppelingen vormen een afzonderlijke mediastream en zijn bewust niet gemengd in dit voorbeeld.

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

Gebruik koppelingen wanneer extern bestandbeheer opzettelijk is. Gebruik ze niet enkel als vervanging voor compressie: een kleine PPTX met kapotte afbeeldingsafhankelijkheden is meestal minder bruikbaar dan een grotere zelf‑voorzienende presentatie.

Afbeeldingen Uit Picture Frames Extraheren

Voordat je een afbeelding uit een bestaande presentatie extraheert, controleer je of een vorm daadwerkelijk een IPictureFrame is en of deze een ingebedde afbeelding bevat. Gekoppelde picture frames bevatten mogelijk geen afbeeldingsbytes die op dezelfde manier kunnen worden geëxtraheerd.

Een Rasterafbeelding Extraheren

De moderne afbeelding‑API gebruikt IImage rechtstreeks en vereist niet langer de oudere Java‑afbeeldingswrapper. Het volgende voorbeeld zoekt de eerste ingebedde rasterafbeelding op een dia en slaat deze op als 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();
}

Opslaan via IImage.save converteert de geëxtraheerde afbeelding naar het gevraagde uitvoerformaat. Als je de gecodeerde bytes nodig hebt die in de presentatie zijn opgeslagen in plaats van een geconverteerd rasterbestand, gebruik dan de binaire data van de afbeeldingsresource.

Een SVG‑Afbeelding Extraheren

Voor een SVG‑afbeelding biedt de IPPImage een ISvgImage object. Hiermee kun je de SVG‑data direct ophalen in plaats van de afbeelding eerst te rasteren.

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

Het behouden van SVG‑inhoud als SVG bewaard de vectorbron binnen de presentatie. Rasterexporten zoals PNG of JPEG renderen die vectorinhoud noodzakelijkerwijs naar pixels. PDF‑ of SVG‑dia‑export is eveneens een render‑operatie, dus de geëxporteerde graphics mogen niet worden beschouwd als een bit‑voor‑bit‑kopie van de originele ingebedde SVG; gebruik de embedded ISvgImage.getSvgData data wanneer de oorspronkelijke vectorresource zelf vereist is.

Een Afbeelding Bijsnijden

Bijsnijden verandert welk deel van een afbeelding zichtbaar is binnen het frame. De bijsnijdwaarden op IPictureFillFormat zijn percentages van de bronafbeeldingsafmetingen. Bijsnijden verwijdert niet meteen de verborgen pixels uit de ingebedde afbeelding; het wijzigt alleen het zichtbare gebied.

Het volgende voorbeeld vindt veilig een picture frame en past bijsnijdwaarden toe:

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

Omdat de verborgen afbeeldingsdata nog steeds aanwezig is, kan de bijsnijding later worden aangepast zonder de originele pixels te verliezen. Als bestandsgrootte belangrijker is dan herhaalbaarheid, kunnen de bijgesneden regio’s fysiek worden verwijderd zoals beschreven in de volgende sectie.

Bijsnijde Afbeeldingsdata Verwijderen

IPictureFillFormat.deletePictureCroppedAreas verwijdert afbeeldingsdata buiten de huidige bijsnijd‑rechthoek en retourneert de resulterende afbeeldingsresource. Dit kan de bestandsgrootte verkleinen, maar het is een destructieve optimalisatie: nadat de presentatie is opgeslagen, zijn de verwijderde pixels niet meer beschikbaar voor een latere on‑crop‑bewerking.

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

De methode kan een nieuwe afbeeldingsresource aan de presentatie toevoegen. Als de originele afbeelding ook door andere picture frames wordt gebruikt, hebben die frames nog steeds hun bestaande resource nodig, waardoor het verwijderen van bijgesneden gebieden niet per se het totaal aantal afbeeldingen vermindert. Het bijsnijden van WMF‑ of EMF‑content met deze methode rastert het bijgesneden resultaat naar PNG.

Rasterafbeeldingen Comprimeren

IPictureFillFormat.compressImage verlaagt de resolutie van rasterafbeeldingen ten opzichte van de grootte waarin de afbeelding wordt weergegeven. Het kan tevens bijgesneden regio’s in dezelfde bewerking verwijderen. De methode retourneert true wanneer de afbeelding is verkleind of bijgesneden en false wanneer er geen wijziging nodig was.

Gebruik een vooraf gedefinieerde PicturesCompression waarde wanneer een standaard doelresolutie voldoende is:

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

Een aangepaste positieve DPI‑waarde kan worden doorgegeven in plaats van een vooraf gedefinieerde waarde wanneer een specifiek doel vereist is.

Compressie is bedoeld voor rasterafbeeldingen. SVG‑ en metafile‑content wordt niet gereduceerd door deze raster‑compressieworkflow. Houd er bovendien rekening mee dat een lagere resolutie en verwijderde bijgesneden regio’s niet kunnen worden hersteld uit de geoptimaliseerde presentatie. Kies een doelresolutie op basis van de grootste grootte waarin de afbeelding werkelijk wordt bekeken of geëxporteerd, in plaats van globaal de laagste DPI toe te passen.

Beheer van Afbeeldingstransformatie‑Effecten

Voor een volledige workflow met helderheid, contrast, kleuraanpassingen, vervaging, alfa‑effecten, geordende ketens, inspectie, verwijdering en round‑trip‑verificatie, zie Image Transform Effects.

Picture Frame‑Geometrie Vergrendelen

De instellingen van IPictureFrameLock bepalen welke bewerkingsacties voor een picture frame uitgeschakeld zijn. Bijvoorbeeld, setAspectRatioLocked behoudt de verhoudingen van de vorm tijdens het schalen.

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

De vergrendeling geldt voor de picture‑frame‑vorm. Het dwingt de bronafbeelding niet tot resampling of permanente wijziging naar dezelfde beeldverhouding.

De StretchOffset‑Waarden Aanpassen

Wanneer de picture‑vulmodus stretch is, definiëren de stretch‑offset‑waarden op IPictureFillFormat het vul‑rechthoek ten opzichte van de begrenzende doos van het picture frame. Positieve percentages creëren een inset vanaf een rand, terwijl negatieve percentages een outset vormen.

Dit verschilt van bijsnijden. Bijsnijdwaarden bepalen welk deel van de bronafbeelding zichtbaar is; stretch‑offsets veranderen het rechthoek waarin de zichtbare picture‑vulling wordt uitgerekt.

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

Gebruik stretch‑offsets voor vul‑plaatsing. Gebruik bijsnijd‑eigenschappen wanneer het doel is om randen van de bronafbeelding te verbergen.

Opslag, Bestandsgrootte en Export‑Overwegingen

De belangrijkste afwegingen worden eenvoudiger te beheren wanneer beeldopslag en picture‑frame‑formattering apart worden behandeld:

Ingebedde afbeeldingen maken de presentatie zelf‑voorzienend en zijn het meest betrouwbaar voor delen en server‑side rendering, maar grote rasterafbeeldingen vergroten de PPTX‑grootte en het geheugenverbruik.
Gekoppelde afbeeldingen kunnen het pakket kleiner houden, maar de presentatie is dan afhankelijk van externe bestanden die op de opgeslagen paden of locaties beschikbaar blijven.
Bijsnijden is aanvankelijk niet‑destructief. De verborgen pixels blijven ingebed tot bijgesneden gebieden expliciet worden verwijderd of tijdens compressie.
Compressie kan de bestandsgrootte aanzienlijk verkleinen voor te grote rasterafbeeldingen, maar het schaft in op resolutie van de bron. Het moet worden toegepast nadat de uiteindelijke weergavegrootte op de dia bekend is.
SVG‑afbeeldingen moeten als SVG blijven wanneer vectorbehoud belangrijk is. Extraheer de ingebedde SVG direct wanneer je de vectorresource zelf nodig hebt. Raster‑dia‑exports converteren altijd de gerenderde dia naar pixels.
Herhaalde afbeeldingen moeten een bestaande IPPImage resource hergebruiken wanneer mogelijk in plaats van steeds opnieuw hetzelfde bestand in de presentatieworkflow te laden.

Voor grote presentaties is beeldoptimalisatie meestal het meest effectief wanneer selectief wordt toegepast: behoud logo’s en diagrammen als vectorcontent, comprimeer foto’s volgens hun werkelijke weergavegrootte, verwijder bijgesneden pixels alleen wanneer latere bewerking niet vereist is, en vermijd externe koppelingen tenzij afhankelijkheidsbeheer deel uitmaakt van het implementatie‑design.

FAQ

Wat is het verschil tussen een picture frame en een afbeeldingsresource?

Een IPPImage vertegenwoordigt een afbeeldingsresource die aan de presentatie is gekoppeld. Een IPictureFrame is een vorm op een dia die een afbeelding weergeeft en frame‑specifieke geometrie en opmaak opslaat, zoals grootte, rotatie, bijsnijdwaarden, effecten en vergrendelingen.

Moet ik afbeeldingen embedden of koppelen?

Embed afbeeldingen wanneer de presentatie draagbaar, gearchiveerd of gerenderd moet kunnen worden zonder toegang tot externe bronnen. Koppel afbeeldingen alleen wanneer het opzettelijk is om afbeeldingsbestanden buiten de PPTX te houden en de externe locaties betrouwbaar beheerd kunnen worden.

Vermindert bijsnijden de PPTX‑bestandsgrootte?

Niet op zichzelf. Normale bijsnijdinstellingen verbergen delen van de bronafbeelding maar behouden de onderliggende pixels. Gebruik IPictureFillFormat.deletePictureCroppedAreas of afbeeldingcompressie met verwijdering van bijgesneden gebieden wanneer die pixels permanent mogen verdwijnen.

Kan ik de beeldkwaliteit herstellen na compressie?

Nee. Compressie kan de opgeslagen rasterresolutie verlagen, en het verwijderen van bijgesneden regio’s gooit afbeeldingsdata weg. Bewaar de originele bronafbeelding buiten de presentatie als later bewerken met hoge resolutie vereist kan zijn.

Hoe moeten SVG‑afbeeldingen worden behandeld?

Behoud SVG‑content als SVG wanneer vectorfidelity van belang is. De ingebedde ISvgImage kan direct worden geëxtraheerd. Het renderen van een dia naar een rasterformaat zoals PNG of JPEG rastert de SVG als onderdeel van de dia‑afbeelding.

Hoe kan ik onveilige casts vermijden bij het lezen van bestaande dia’s?

Controleer het vormtype voordat je picture‑frame‑specifieke leden gebruikt. Een instanceof‑controle tegen IPictureFrame voorkomt ongeldige casts en stelt de code in staat om dia’s die geen picture frames bevatten adequaat af te handelen.

Beheer afbeeldingstransformatie‑effecten in presentaties op Android