Prezentációs diák SVG képekként Androidon

Áttekintés

Az SVG egy méretezhető XML-alapú képfájl-formátum, amely jól működik webes kiadványokhoz, diavetítőkhez, akadálymentesítési munkafolyamatokhoz és automatizált utófeldolgozáshoz. Az Aspose.Slides for Android Java‑on keresztül minden diát külön SVG fájlba exportál, és lehetővé teszi a szöveg, betűtípusok, képek és SVG elemek írásának szabályozását.

Használja a SVGOptions elemet, ha az exportált SVG‑nek kompakt, a böngészők között kiszámítható vagy interaktív használatra késznek kell lennie.

Dia exportálása SVG‑ként

Hozzon létre egy Presentation objektumot, válasszon ki egy diát, és írja ki egy adatfolyamba az ISlide.writeAsSvg segítségével. Az alábbi példa a prezentáció minden diáját külön SVG fájlba exportálja.

Presentation presentation = new Presentation("presentation.pptx");
try {
    for (ISlide slide : presentation.getSlides()) {
        String outputFileName = String.format("slide-%d.svg", slide.getSlideNumber());

        try (FileOutputStream svgStream = new FileOutputStream(outputFileName)) {
            slide.writeAsSvg(svgStream);
        }
    }
} finally {
    presentation.dispose();
}

A fájlnév a ISlide.getSlideNumber segítségével kerül meghatározásra a ciklus indexe helyett. Egy adott alakzatot is exportálhat a IShape.writeAsSvg metódussal, ha egy diavetítő vagy weboldal csak azt az alakzatot igényli.

SVG kimenet konfigurálása

SVGOptions szabályozza az SVG megjelenítését. Szövegdobozok esetén a SVGOptions.setUseFrameSize a szövegdobozt a renderelési területbe veszi bele, míg a SVGOptions.setUseFrameRotation meghatározza, hogy a doboz forgatása alkalmazásra kerül-e. Az SVGOptions.setDisableFontLigatures beállítást true‑ra állítsa, ha a szöveget ligatúrák nélkül kell megjeleníteni.

Presentation presentation = new Presentation("presentation.pptx");
try {
    SVGOptions svgOptions = new SVGOptions();
    svgOptions.setDisableFontLigatures(true);
    svgOptions.setUseFrameSize(true);
    svgOptions.setUseFrameRotation(false);

    ISlide slide = presentation.getSlides().get_Item(0);
    try (FileOutputStream svgStream = new FileOutputStream("slide-with-custom-options.svg")) {
        slide.writeAsSvg(svgStream, svgOptions);
    }
} finally {
    presentation.dispose();
}

Szöveg és betűtípusok vezérlése

SVG‑képbe exportáláskor szabályozhatja, hogy a szöveg szövegként maradjon vagy vektorgrafikává alakuljon, valamint hogy a külső betűtípusok hogyan legyenek felhasználva vagy hivatkozva. Az alábbi beállítások segítenek egyensúlyt teremteni a vizuális konzisztencia, a szövegkiválasztás és a betűtípus-függőségek között az exportált SVG‑ben.

Az összes szöveg vektorizálása

Állítsa a SVGOptions.setVectorizeText értékét true‑ra, hogy a diák összes szövege vektorgrafikaként kerüljön írásra. Ez kiküszöböli a betűtípus-függőségeket, és a vizuális eredményt konzisztenssé teszi a böngészők között, de a szöveg már nem választható vagy kereshető SVG‑szövegként.

Presentation presentation = new Presentation("presentation.pptx");
try {
    SVGOptions svgOptions = new SVGOptions();
    svgOptions.setVectorizeText(true);

    ISlide slide = presentation.getSlides().get_Item(0);
    try (FileOutputStream svgStream = new FileOutputStream("slide-with-vectorized-text.svg")) {
        slide.writeAsSvg(svgStream, svgOptions);
    }
} finally {
    presentation.dispose();
}

Válassza ki, hogyan kezelje a külső betűtípusokat

A SVGOptions.setExternalFontsHandling egy SvgExternalFontsHandling értéket használ a külső betöltésű betűtípusokhoz. Válassza a SvgExternalFontsHandling.AddLinksToFontFiles lehetőséget, ha külön betűtípusfájlokra szeretne hivatkozni, a SvgExternalFontsHandling.Embed lehetőséget, ha a betűtípusadatot az SVG‑be szeretné beágyazni, vagy a SvgExternalFontsHandling.Vectorize lehetőséget, ha csak a külső betűtípusokat használó szöveget szeretné grafikaként megjeleníteni. A betűtípusok beágyazása előtt ellenőrizze a licencelést.

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

    SVGOptions linkedFontsOptions = new SVGOptions();
    linkedFontsOptions.setExternalFontsHandling(SvgExternalFontsHandling.AddLinksToFontFiles);
    try (FileOutputStream linkedFontsStream = new FileOutputStream("slide-with-font-links.svg")) {
        slide.writeAsSvg(linkedFontsStream, linkedFontsOptions);
    }

    SVGOptions embeddedFontsOptions = new SVGOptions();
    embeddedFontsOptions.setExternalFontsHandling(SvgExternalFontsHandling.Embed);
    try (FileOutputStream embeddedFontsStream = new FileOutputStream("slide-with-embedded-fonts.svg")) {
        slide.writeAsSvg(embeddedFontsStream, embeddedFontsOptions);
    }

    SVGOptions vectorizedExternalFontsOptions = new SVGOptions();
    vectorizedExternalFontsOptions.setExternalFontsHandling(SvgExternalFontsHandling.Vectorize);
    try (FileOutputStream vectorizedExternalFontsStream = new FileOutputStream("slide-with-vectorized-external-fonts.svg")) {
        slide.writeAsSvg(vectorizedExternalFontsStream, vectorizedExternalFontsOptions);
    }
} finally {
    presentation.dispose();
}

Beágyazott képek méretének csökkentése

Használja a SVGOptions.setPicturesCompression beállítást a beágyazott képek felbontásának csökkentésére, a SVGOptions.setDeletePicturesCroppedAreas beállítást a levágott forrásterületek kihagyására, és a SVGOptions.setJpegQuality beállítást a JPEG kódolás minőségének szabályozására. Ezek a beállítások a fájlméretet csökkentik a kép pontosságának vagy a megőrzött képadatok árán.

Presentation presentation = new Presentation("presentation.pptx");
try {
    SVGOptions svgOptions = new SVGOptions();
    svgOptions.setPicturesCompression(PicturesCompression.Dpi150);
    svgOptions.setDeletePicturesCroppedAreas(true);
    svgOptions.setJpegQuality(80);

    ISlide slide = presentation.getSlides().get_Item(0);
    try (FileOutputStream svgStream = new FileOutputStream("compressed-slide.svg")) {
        slide.writeAsSvg(svgStream, svgOptions);
    }
} finally {
    presentation.dispose();
}

Metafájl raszterizálási felbontásának szabályozása

A SVGOptions.setMetafileRasterizationDpi beállítás meghatározza az alacsonyabb felbontási határt a metafájlok SVG exportálás közbeni raszterizálásához. Használja részletesség és fájlméret egyensúlyozására, amikor EMF vagy WMF képet raszterizál. Nem definiál globális DPI‑t az SVG‑nek, és nem kényszeríti minden dián lévő elemet raszteres képpé konvertálni.

Letöltse a metafile-rasterization.pptx fájlt, amely egy EMF képet tartalmaz szorosan elhelyezkedő átlós vonalakkal. Az alábbi példa az első diáját három raszterizálási felbontásban exportálja a ISlide.writeAsSvg segítségével. Minden egyéb exportbeállítás változatlan, hogy az eredményeket össze lehessen hasonlítani.

import com.aspose.slides.PicturesCompression;
import com.aspose.slides.Presentation;
import com.aspose.slides.SVGOptions;
import java.io.FileOutputStream;

Presentation presentation = new Presentation("metafile-rasterization.pptx");
try {
    for (int dpi : new int[] { 72, 150, 300 }) {
        SVGOptions svgOptions = new SVGOptions();
        svgOptions.setMetafileRasterizationDpi(dpi);
        svgOptions.setPicturesCompression(PicturesCompression.Dpi330);
        svgOptions.setJpegQuality(90);

        String outputFileName = String.format("slide-%d.svg", dpi);
        try (FileOutputStream svgStream = new FileOutputStream(outputFileName)) {
            presentation.getSlides().get_Item(0).writeAsSvg(svgStream, svgOptions);
        }
    }
} finally {
    presentation.dispose();
}

A kimenetben az EMF minden SVG-ben egy beágyazott PNG‑vé vált. Az alábbi mérések a mellékelt prezentációra vonatkoznak; nem általános képlet a DPI pixelméretekre való átváltásához.

Metafájl raszterizálási DPI Beágyazott PNG méretei SVG fájlméret (bájt)
72 1196 × 596 170,221
150 2492 × 1242 423,149
300 4983 × 2483 1,027,169

Az alábbi összehasonlítás ugyanazt a beágyazott raszter területet mutatja ugyanakkora nagyított megjelenítési méretben. A diagonális vonalak 72 DPI‑nél látható pixelesedést, magasabb felbontásoknál pedig simább éleket mutatnak, miközben az SVG fájl mérete nő. Az érték növelése nem feltétlenül javít minden részletet vagy változtat minden exportált képet.

Nagyított diagonális vonal részlet 72, 150 és 300 DPI‑nél

SVGOptions.setPicturesCompression szabályozza a kép felbontáscsökkenést, és elfedheti a metafájl raszterizálási felbontás változtatásának hatását. A SVGOptions.setJpegQuality a JPEG kódolás minőségét szabályozza, nem a metafájl raszterizálási felbontását.

Stabil azonosítók hozzárendelése alakzatokhoz és szöveghez

Használja az ISvgShapeFormattingController elemet, hogy minden SVG alakzatra beállítsa az ISvgShape.setId értékét. A szöveg tspan elemeire is az ISvgTSpan.setId értékek beállításához valósítsa meg az ISvgShapeAndTextFormattingController-t. Bármelyik vezérlőt hozzárendelheti a SVGOptions.setShapeFormattingController segítségével.

Az alábbi vezérlő a IShape.getOfficeInteropShapeId metódust használja, amely az alakzat élettartama alatt stabil, valamint egy ismételhető számlálót a szövegspánkokhoz. Ez a generált azonosítókat megfelelővé teszi egy változatlan prezentáció utófeldolgozásához.

class StableSvgIdController implements ISvgShapeAndTextFormattingController {
    private String currentShapeId = "";
    private int textSpanIndex;

    public void formatShape(ISvgShape svgShape, IShape shape) {
        currentShapeId = String.format("shape-%d", shape.getOfficeInteropShapeId());
        textSpanIndex = 0;
        svgShape.setId(currentShapeId);
    }

    public void formatText(ISvgTSpan svgTSpan, IPortion portion, ITextFrame textFrame) {
        svgTSpan.setId(String.format("%s-text-%d", currentShapeId, textSpanIndex++));
    }
}

Presentation presentation = new Presentation("presentation.pptx");
try {
    SVGOptions svgOptions = new SVGOptions();
    svgOptions.setShapeFormattingController(new StableSvgIdController());

    ISlide slide = presentation.getSlides().get_Item(0);
    try (FileOutputStream svgStream = new FileOutputStream("slide-with-stable-ids.svg")) {
        slide.writeAsSvg(svgStream, svgOptions);
    }
} finally {
    presentation.dispose();
}

SVG eseménykezelők hozzáadása

Egy ISvgShapeFormattingController-ben hívja meg az ISvgShape.setEventHandler metódust egy SvgEvent értékkel, hogy JavaScript eseménykezelőt adjon az exportált alakzathoz. A vezérlőt a SVGOptions.setShapeFormattingController segítségével rendelje hozzá, és definiálja a JavaScript függvényt az eredményt tartalmazó oldalban vagy SVG-dokumentumban.

class SvgEventController implements ISvgShapeFormattingController {
    public void formatShape(ISvgShape svgShape, IShape shape) {
        if ("ActionButton".equals(shape.getName())) {
            svgShape.setId("action-button");
            svgShape.setEventHandler(SvgEvent.OnClick, "handleShapeClick(event)");
        }
    }
}

Presentation presentation = new Presentation("presentation.pptx");
try {
    SVGOptions svgOptions = new SVGOptions();
    svgOptions.setShapeFormattingController(new SvgEventController());

    ISlide slide = presentation.getSlides().get_Item(0);
    try (FileOutputStream svgStream = new FileOutputStream("interactive-slide.svg")) {
        slide.writeAsSvg(svgStream, svgOptions);
    }
} finally {
    presentation.dispose();
}

A fogadó oldal definiálhatja a kezelő által hivatkozott JavaScript függvényt. Az azonosítók és eseménykezelők hozzárendelése lehetővé teszi a diavetítőket, akadálymentesítési fejlesztéseket és más interaktív SVG munkafolyamatokat.

GYIK

Mikor kell a SVGOptions.setVectorizeText metódust használni a SvgExternalFontsHandling.Vectorize helyett?

Használja a SVGOptions.setVectorizeText metódust, ha az összes szöveget a betűtípusoktól függetlennek kell lennie. Használja a SvgExternalFontsHandling.Vectorize metódust, ha csak a külső betűtípusokat használó szöveget kell grafikává konvertálni.

Mi a legjobb módja egy SVG méretének csökkentésére?

Kezdje a beágyazott képek tömörítésével, a levágott képterületek törlésével, és a kapcsolt betűtípusfájlok kiválasztásával, ha a célkörnyezet képes kiszolgálni őket. Tesztelje az eredményt, mivel az alacsonyabb képfelbontás, a gyengébb JPEG‑minőség és a vektorizált szöveg mind más‑más minőség‑ és méretkompromisszumokat jelent.

Módosíthatom-e az exportált SVG elemeket az export után?

Igen. Rendeljen azonosítókat egy formázó vezérlő segítségével, majd válassza ki a megfelelő SVG elemeket az utófeldolgozó eszközében vagy böngésző‑szkriptjében.