เรนเดอร์สไลด์การนำเสนอเป็นภาพ SVG ใน Java
ภาพรวม
SVG เป็นรูปแบบภาพที่ขยายได้บนพื้นฐาน XML ซึ่งทำงานได้ดีสำหรับการเผยแพร่บนเว็บ, ตัวดูสไลด์, กระบวนการทำให้เข้าถึงได้, และการประมวลผลหลังอัตโนมัติ. Aspose.Slides ส่งออกแต่ละสไลด์เป็นไฟล์ SVG แยกไฟล์และให้คุณควบคุมวิธีการเขียนข้อความ, ฟอนต์, รูปภาพ, และองค์ประกอบ SVG.
ใช้ SVGOptions เมื่อ SVG ที่ส่งออกต้องมีขนาดกะทัดรัด, คาดเดาได้ในทุกเบราว์เซอร์, หรือพร้อมสำหรับการใช้งานแบบโต้ตอบ.
ส่งออกสไลด์เป็น SVG
สร้าง Presentation, เลือกสไลด์, แล้วเขียนลงในสตรีมด้วย ISlide.writeAsSvg. ตัวอย่างต่อไปนี้ส่งออกทุกสไลด์ในงานนำเสนอเป็นไฟล์ SVG แยกไฟล์.
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();
}
ชื่อไฟล์ใช้ ISlide.getSlideNumber แทนการใช้ดัชนีของลูป. คุณยังสามารถส่งออกรูปร่างเดี่ยวด้วย IShape.writeAsSvg เมื่อผู้ดูสไลด์หรือหน้าเว็บต้องการเพียงรูปร่างนั้น.
กำหนดค่าการส่งออก SVG
SVGOptions ควบคุมการเรนเดอร์ SVG. สำหรับกรอบข้อความ, SVGOptions.setUseFrameSize จะรวมกรอบข้อความในพื้นที่การเรนเดอร์, และ SVGOptions.setUseFrameRotation กำหนดว่าการหมุนกรอบจะถูกใช้หรือไม่. ตั้งค่า SVGOptions.setDisableFontLigatures เป็น true เมื่อข้อความต้องเรนเดอร์โดยไม่มีลิแกเจอร์.
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();
}
ควบคุมข้อความและฟอนต์
เมื่อส่งออกสไลด์เป็น SVG, คุณสามารถควบคุมได้ว่าข้อความจะคงเหลือเป็นข้อความหรือแปลงเป็นกราฟิกเวกเตอร์, และวิธีการรวมหรือลิงก์ฟอนต์ภายนอก. ตัวเลือกต่อไปนี้ช่วยให้คุณสมดุลความสอดคล้องของภาพ, การเลือกข้อความ, และการพึ่งพาฟอนต์ใน SVG ที่ส่งออก.
เวกเตอร์ข้อความทั้งหมด
ตั้งค่า SVGOptions.setVectorizeText เป็น true เพื่อเขียนข้อความในสไลด์ทั้งหมดเป็นกราฟิกเวกเตอร์. วิธีนี้ขจัดการพึ่งพาฟอนต์และทำให้ผลลัพธ์ภาพสอดคล้องกันมากขึ้นในหลายเบราว์เซอร์, แต่ข้อความจะไม่สามารถเลือกหรือค้นหาได้ในรูปแบบข้อความ SVG.
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();
}
เลือกวิธีการจัดการฟอนต์ภายนอก
SVGOptions.setExternalFontsHandling ใช้ค่า SvgExternalFontsHandling สำหรับฟอนต์ที่โหลดจากภายนอก. เลือก AddLinksToFontFiles เพื่ออ้างอิงไฟล์ฟอนต์แยก, Embed เพื่อฝังข้อมูลฟอนต์ใน SVG, หรือ Vectorize เพื่อเรนเดอร์เฉพาะข้อความที่ใช้ฟอนต์ภายนอกเป็นกราฟิก. ตรวจสอบสิทธิ์การใช้ฟอนต์ก่อนการฝังฟอนต์.
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();
}
ลดขนาดภาพที่ฝังอยู่
ใช้ SVGOptions.setPicturesCompression เพื่อลดความละเอียดของภาพที่ฝังอยู่, SVGOptions.setDeletePicturesCroppedAreas เพื่อลบพื้นที่แหล่งข้อมูลที่ถูกครอป, และ SVGOptions.setJpegQuality เพื่อควบคุมคุณภาพการเข้ารหัส JPEG. การตั้งค่าเหล่านี้ลดขนาดไฟล์โดยเสียคุณภาพของภาพหรือข้อมูลภาพที่เก็บไว้.
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();
}
ควบคุมความละเอียดการแรสเตอร์เมตาฟายล์
SVGOptions.setMetafileRasterizationDpi กำหนดขีดจำกัดความละเอียดต่ำสุดสำหรับการแรสเตอร์เมตาฟายล์ระหว่างการส่งออก SVG. ใช้เพื่อสมดุลรายละเอียดและขนาดไฟล์เมื่อภาพ EMF หรือ WMF ถูกแรสเตอร์. มันไม่ได้กำหนด DPI โดยรวมสำหรับ SVG หรือบังคับให้ทุกวัตถุในสไลด์แปลงเป็นภาพแรสเตอร์.
ดาวน์โหลด metafile-rasterization.pptx, ซึ่งมีภาพ EMF ที่มีเส้นทแยงมุมห่างกันใกล้กัน. ตัวอย่างต่อไปนี้ส่งออกสไลด์แรกของไฟล์ที่ความละเอียดการแรสเตอร์สามระดับผ่าน ISlide.writeAsSvg. การตั้งค่าอื่นๆ ของการส่งออกทั้งหมดเหมือนเดิมเพื่อเปรียบเทียบผลลัพธ์.
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();
}
ในผลลัพธ์, EMF จะกลายเป็น PNG ที่ฝังอยู่หนึ่งไฟล์ในแต่ละ SVG. การวัดต่อไปนี้เป็นของงานนำเสนอที่ให้มา; ไม่ใช่สูตรทั่วไปสำหรับแปลง DPI เป็นขนาดพิกเซล.
| DPI การแรสเตอร์เมตาฟายล์ | ขนาด PNG ที่ฝังอยู่ | ขนาดไฟล์ SVG (ไบต์) |
|---|---|---|
| 72 | 1196 × 596 | 170,221 |
| 150 | 2492 × 1242 | 423,149 |
| 300 | 4983 × 2483 | 1,027,169 |
การเปรียบเทียบด้านล่างแสดงบริเวณเดียวกันของภาพแรสเตอร์ที่ฝังไว้ที่ขนาดการแสดงผลขยายเดียวกัน. เส้นทแยงมุมแสดงพิกเซลที่มองเห็นได้ที่ 72 DPI และขอบที่เรียบขึ้นในความละเอียดที่สูงกว่า, ในขณะที่ไฟล์ SVG เพิ่มขนาด. การเพิ่มค่าดังกล่าวไม่ได้จำเป็นต้องปรับปรุงรายละเอียดทั้งหมดหรือเปลี่ยนภาพที่ส่งออกทั้งหมด.

SVGOptions.setPicturesCompression ควบคุมการลดความละเอียดของภาพและสามารถบังผลของการเปลี่ยนความละเอียดการแรสเตอร์เมตาฟายล์. SVGOptions.setJpegQuality ควบคุมคุณภาพการเข้ารหัส JPEG, ไม่ใช่ความละเอียดการแรสเตอร์เมตาฟายล์.
กำหนด ID ที่คงที่ให้กับรูปร่างและข้อความ
ใช้ ISvgShapeFormattingController เพื่อตั้งค่า ISvgShape.setId ให้กับแต่ละรูปร่าง SVG. เพื่อกำหนดค่า ISvgTSpan.setId บนองค์ประกอบ tspan ของข้อความด้วย, ให้ทำการ implement ISvgShapeAndTextFormattingController. กำหนดตัวควบคุมใดตัวหนึ่งด้วย SVGOptions.setShapeFormattingController.
ตัวควบคุมต่อไปนี้ใช้ IShape.getOfficeInteropShapeId, ซึ่งคงที่ตลอดอายุของรูปร่าง, และตัวนับที่ทำซ้ำได้สำหรับ tspan ของข้อความ. สิ่งนี้ทำให้ ID ที่สร้างขึ้นเหมาะสำหรับการประมวลผลต่อจากงานนำเสนอที่ไม่ได้เปลี่ยนแปลง.
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
ภายใน ISvgShapeFormattingController, เรียก ISvgShape.setEventHandler พร้อมค่าของ SvgEvent เพื่อเพิ่มตัวจัดการเหตุการณ์ JavaScript ให้กับรูปร่างที่ส่งออก. กำหนดตัวควบคุมด้วย SVGOptions.setShapeFormattingController และกำหนดฟังก์ชัน JavaScript ในหน้าเว็บหรือเอกสาร SVG ที่โฮสต์ผลลัพธ์.
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();
}
หน้าโฮสต์สามารถกำหนดฟังก์ชัน JavaScript ที่อ้างอิงโดยตัวจัดการได้. การกำหนด ID และตัวจัดการเหตุการณ์ทำให้ผู้ดูสไลด์, การปรับปรุงการเข้าถึง, และเวิร์กโฟลว์ SVG แบบโต้ตอบอื่น ๆ ทำงานได้.
คำถามที่พบบ่อย
เมื่อใดควรใช้ SVGOptions.setVectorizeText แทน SvgExternalFontsHandling.Vectorize?
ใช้ SVGOptions.setVectorizeTextเมื่อข้อความทั้งหมดต้องเป็นอิสระจากฟอนต์. ใช้ SvgExternalFontsHandling.Vectorizeเมื่อเฉพาะข้อความที่ใช้ฟอนต์ภายนอกควรแปลงเป็นกราฟิก.
วิธีที่ดีที่สุดในการทำให้ SVG มีขนาดเล็กลงคืออะไร?
เริ่มต้นด้วยการบีบอัดรูปภาพที่ฝังอยู่, ลบพื้นที่ภาพที่ถูกครอป, และเลือกไฟล์ฟอนต์แบบลิงก์เมื่อสภาพแวดล้อมเป้าหมายสามารถให้บริการได้. ทดสอบผลลัพธ์เนื่องจากความละเอียดภาพที่ต่ำลง, คุณภาพ JPEG ที่ต่ำลง, และข้อความที่เวกเตอร์ทำให้เกิดการแลกเปลี่ยนระหว่างคุณภาพและขนาดที่แตกต่างกัน.
ฉันสามารถแก้ไของค์ประกอบ SVG ที่ส่งออกได้หลังการส่งออกหรือไม่?
ได้. กำหนด ID ผ่านตัวควบคุมการฟอร์แมต, จากนั้นเลือกองค์ประกอบ SVG ที่ตรงกันในเครื่องมือประมวลผลต่อหรือสคริปต์เบราว์เซอร์ของคุณ.