Rendera presentationsbilder som SVG-bilder på Android
Översikt
SVG är ett skalbart XML-baserat bildformat som fungerar bra för webbpublicering, bildspelsvisare, tillgänglighetsarbetsflöden och automatisk efterbehandling. Aspose.Slides för Android via Java exporterar varje bild till en separat SVG-fil och låter dig kontrollera hur text, typsnitt, bilder och SVG-element skrivs.
Använd SVGOptions när den exporterade SVG-filen måste vara kompakt, förutsägbar över webbläsare eller klar för interaktiv användning.
Exportera en bild som SVG
Skapa en Presentation, välj en bild och skriv den till en ström med ISlide.writeAsSvg. Följande exempel exporterar varje bild i en presentation som en separat SVG-fil.
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();
}
Filnamnet använder ISlide.getSlideNumber snarare än loopindex. Du kan också exportera en enskild form med IShape.writeAsSvg när en bildvisare eller webbsida bara behöver den formen.
Konfigurera SVG-utdata
SVGOptions styr SVG-renderingen. För textram, SVGOptions.setUseFrameSize inkluderar textramen i renderingsområdet, och SVGOptions.setUseFrameRotation bestämmer om ramrotationen tillämpas. Ställ in SVGOptions.setDisableFontLigatures på true när text måste renderas utan ligaturer.
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();
}
Kontrollera beskärning av linjeändar vid pilhuvuden
SVG 1.1 har ingen markeringsinsettingsfunktion för att ange var en linje ska sluta under ett pilhuvud. Som standard förkortar Aspose.Slides den exporterade linjen så att dess streck inte sticker ut genom markören. Anropa SVGOptions.setDisableLineEndCropping med true för att rita strecket hela vägen till linjens ursprungliga slutpunkt. Denna inställning påverkar endast SVG-utdata. Linjen behåller sin position och längd på bilden.
Exempelvis ritas triangel- och diamantpilhuvuden på linjer 2 respektive 10 punkter breda. Den exporterar samma bild två gånger, och ändrar endast beskärningsalternativet.
import com.aspose.slides.*;
import android.graphics.Color;
import java.io.FileOutputStream;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
int y = 40;
for (byte style : new byte[] { LineArrowheadStyle.Triangle, LineArrowheadStyle.Diamond }) {
for (int width : new int[] { 2, 10 }) {
IAutoShape line = slide.getShapes().addAutoShape(ShapeType.Line, 40, y, 200, 0);
ILineFormat format = line.getLineFormat();
format.getFillFormat().setFillType(FillType.Solid);
format.getFillFormat().getSolidFillColor().setColor(Color.rgb(0, 0, 139));
format.setWidth(width);
format.setEndArrowheadStyle(style);
y += 50;
}
}
SVGOptions options = new SVGOptions();
options.setDisableLineEndCropping(false);
try (FileOutputStream cropped = new FileOutputStream("cropped.svg")) {
slide.writeAsSvg(cropped, options);
}
options.setDisableLineEndCropping(true);
try (FileOutputStream uncropped = new FileOutputStream("uncropped.svg")) {
slide.writeAsSvg(uncropped, options);
}
} finally {
presentation.dispose();
}
Jämförelsen visar det triangulära pilhuvudet på 10-punktslinjen. Med beskärning aktiverad är spetsen skarp. Med beskärning inaktiverad sticker strecket ut genom de sneda sidorna på markören och lämnar ett plant slut.

I de andra linjerna i exemplet är det utskjutande strecket mindre synligt på 2-punkts triangeln. Den fyllda diamanten täcker streckets slut på båda breddarna.
Kontrollera text och typsnitt
När du exporterar bilder till SVG kan du kontrollera om text förblir som text eller konverteras till vektorgrafik, och hur externa typsnitt inkluderas eller refereras. Följande alternativ hjälper dig att balansera visuell konsistens, textval och typsnittsbetingelser i den exporterade SVG:n.
Vektorisera all text
Ställ in SVGOptions.setVectorizeText på true för att skriva all bildtext som vektorgrafik. Detta eliminerar typsnittsbetingelser och gör det visuella resultatet mer konsistent över webbläsare, men texten kan inte längre väljas eller sökas som SVG-text.
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älj hur externa typsnitt hanteras
SVGOptions.setExternalFontsHandling använder ett SvgExternalFontsHandling‑värde för typsnitt som laddas externt. Välj SvgExternalFontsHandling.AddLinksToFontFiles för att referera till separata typsnittsfiler, SvgExternalFontsHandling.Embed för att inkludera typsnittsdata i SVG:n, eller SvgExternalFontsHandling.Vectorize för att rendera endast text som använder externa typsnitt som grafik. Verifiera typsnittslicenser innan du bäddar in typsnitt.
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();
}
Minska inbäddad bildstorlek
Använd SVGOptions.setPicturesCompression för att minska upplösningen på inbäddade bilder, SVGOptions.setDeletePicturesCroppedAreas för att utelämna beskurna källområden, och SVGOptions.setJpegQuality för att kontrollera JPEG‑kodningskvaliteten. Dessa inställningar minskar filstorleken på bekostnad av bildkvalitet eller bevarade bilddata.
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();
}
Kontrollera rasteriseringsupplösning för metafiler
SVGOptions.setMetafileRasterizationDpi anger den lägre upplösningsgränsen för rasterisering av metafiler under SVG-export. Använd den för att balansera detaljer och filstorlek när en EMF‑ eller WMF‑bild rasteriseras. Den definierar inte ett globalt DPI för SVG:n eller tvingar varje objekt på bilden att bli en rasterbild.
Ladda ner metafile-rasterization.pptx, som innehåller en EMF‑bild med tätt placerade diagonala linjer. Följande exempel exporterar dess första bild i tre rasteriseringsupplösningar via ISlide.writeAsSvg. Alla andra exportinställningar förblir identiska så att resultaten kan jämföras.
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();
}
I utdata blev EMF en inbäddad PNG i varje SVG. Följande mått gäller den medföljande presentationen; de är inte en generell formel för att omvandla DPI till pixeldimensioner.
| Metafil rasteriserings‑DPI | Inbäddade PNG-dimensioner | SVG‑filstorlek (byte) |
|---|---|---|
| 72 | 1196 × 596 | 170,221 |
| 150 | 2492 × 1242 | 423,149 |
| 300 | 4983 × 2483 | 1,027,169 |
Jämförelsen nedan visar samma område av den inbäddade rastern på samma förstora visningsstorlek. De diagonala linjerna visar synlig pixellering vid 72 DPI och mjukare kanter vid högre upplösningar, medan SVG-filen växer. Att öka värdet förbättrar inte nödvändigtvis varje detalj eller ändrar varje exporterad bild.

SVGOptions.setPicturesCompression styr bildupplösningsreducering och kan maskera effekten av att ändra metafilens rasteriseringsupplösning. SVGOptions.setJpegQuality styr JPEG‑kodningskvalitet, inte metafilens rasteriseringsupplösning.
Tilldela stabila ID till former och text
Använd ISvgShapeFormattingController för att sätta ISvgShape.setId för varje SVG-form. För att också sätta ISvgTSpan.setId‑värden på text‑tspan‑element, implementera ISvgShapeAndTextFormattingController. Tilldela någon av kontrollerna med SVGOptions.setShapeFormattingController.
Följande kontroller använder IShape.getOfficeInteropShapeId, vilket är stabilt för formens livstid, och en upprepningsbar räknare för dess text‑spans. Detta gör de genererade ID:n lämpliga för efterbehandling av en oförändrad presentation.
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();
}
Lägg till SVG‑händelsehanterare
I en ISvgShapeFormattingController, anropa ISvgShape.setEventHandler med ett SvgEvent‑värde för att lägga till en JavaScript‑händelsehanterare till en exporterad form. Tilldela kontrollern med SVGOptions.setShapeFormattingController och definiera JavaScript‑funktionen på sidan eller i SVG‑dokumentet som innehåller resultatet.
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();
}
Värdsidan kan definiera JavaScript‑funktionen som refereras av hanteraren. Tilldelning av ID:n och händelsehanterare möjliggör bildvisare, tillgänglighetsförbättringar och andra interaktiva SVG‑arbetsflöden.
Vanliga frågor
När bör jag använda SVGOptions.setVectorizeText istället för SvgExternalFontsHandling.Vectorize?
Använd SVGOptions.setVectorizeText när all text måste vara oberoende av typsnitt. Använd SvgExternalFontsHandling.Vectorize när endast text som använder externa typsnitt ska konverteras till grafik.
Vad är det bästa sättet att göra en SVG mindre?
Börja med att komprimera inbäddade bilder, ta bort beskurna bildområden och välja länkade typsnittsfiler när målmiljön kan leverera dem. Testa resultatet eftersom lägre bildupplösning, lägre JPEG‑kvalitet och vektoriserad text alla har olika kvalitets‑ och storleksavvägningar.
Kan jag modifiera exporterade SVG‑element efter export?
Ja. Tilldela ID:n via en formateringskontroller och välj sedan de matchande SVG‑elementen i ditt efterbearbetningsverktyg eller browserskript.