在 PHP 中将演示文稿幻灯片渲染为 SVG 图像
概述
SVG 是一种基于 XML 的可伸缩图像格式,适用于 Web 发布、幻灯片查看器、辅助功能工作流和自动化后处理。Aspose.Slides 将每张幻灯片导出为单独的 SVG 文件,并让您控制文本、字体、图片和 SVG 元素的写入方式。
使用 SVGOptions 当导出的 SVG 必须紧凑、在浏览器之间保持一致或准备进行交互使用时。
将幻灯片导出为 SVG
创建一个 Presentation,选择幻灯片,并使用 Slide.writeAsSvg 将其写入流。下面的示例将演示文稿中的每张幻灯片导出为单独的 SVG 文件。
$presentation = new Presentation("presentation.pptx");
try {
$slideCount = java_values($presentation->getSlides()->size());
for ($slideIndex = 0; $slideIndex < $slideCount; $slideIndex++) {
$slide = $presentation->getSlides()->get_Item($slideIndex);
$slideNumber = java_values($slide->getSlideNumber());
$outputFileName = sprintf("slide-%d.svg", $slideNumber);
$svgStream = new Java("java.io.FileOutputStream", $outputFileName);
$slide->writeAsSvg($svgStream);
$svgStream->close();
}
} finally {
$presentation->dispose();
}
文件名使用 Slide.getSlideNumber 而不是循环索引。您也可以使用 Shape.writeAsSvg 导出单个形状,当幻灯片查看器或网页只需要该形状时。
配置 SVG 输出
SVGOptions 控制 SVG 渲染。对于文本框,SVGOptions.setUseFrameSize 将文本框包含在渲染区域内,且 SVGOptions.setUseFrameRotation 决定是否应用框架旋转。将 SVGOptions.setDisableFontLigatures 设置为 true 时,文本必须在无连字的情况下渲染。
$presentation = new Presentation("presentation.pptx");
$svgStream = null;
try {
$svgOptions = new SVGOptions();
$svgOptions->setDisableFontLigatures(true);
$svgOptions->setUseFrameSize(true);
$svgOptions->setUseFrameRotation(false);
$slide = $presentation->getSlides()->get_Item(0);
$svgStream = new Java("java.io.FileOutputStream", "slide-with-custom-options.svg");
$slide->writeAsSvg($svgStream, $svgOptions);
} finally {
$svgStream->close();
$presentation->dispose();
}
控制箭头端的线段裁剪
SVG 1.1 没有标记内嵌设置来指定线条在箭头下方的停止位置。默认情况下,Aspose.Slides 会缩短导出的线条,使其笔画不穿过标记。将 SVGOptions::setDisableLineEndCropping 与 true 一起调用,可将笔画绘制到线条的原始端点。此设置仅影响 SVG 输出。线条在幻灯片上的位置和长度保持不变。
示例在第 2 和第 10 点宽的线条上绘制三角形和菱形箭头。它两次导出同一幻灯片,仅更改裁剪选项。
use aspose\slides\FillType;
use aspose\slides\LineArrowheadStyle;
use aspose\slides\Presentation;
use aspose\slides\ShapeType;
use aspose\slides\SVGOptions;
$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$y = 40;
foreach ([LineArrowheadStyle::Triangle, LineArrowheadStyle::Diamond] as $style) {
foreach ([2, 10] as $width) {
$line = $slide->getShapes()->addAutoShape(ShapeType::Line, 40, $y, 200, 0);
$format = $line->getLineFormat();
$format->getFillFormat()->setFillType(FillType::Solid);
$color = new Java("java.awt.Color", 0, 0, 139);
$format->getFillFormat()->getSolidFillColor()->setColor($color);
$format->setWidth($width);
$format->setEndArrowheadStyle($style);
$y += 50;
}
}
$options = new SVGOptions();
$options->setDisableLineEndCropping(false);
$cropped = new Java("java.io.FileOutputStream", "cropped.svg");
try {
$slide->writeAsSvg($cropped, $options);
} finally {
$cropped->close();
}
$options->setDisableLineEndCropping(true);
$uncropped = new Java("java.io.FileOutputStream", "uncropped.svg");
try {
$slide->writeAsSvg($uncropped, $options);
} finally {
$uncropped->close();
}
} finally {
$presentation->dispose();
}
比较显示了 10 点宽线条上的三角形箭头。启用裁剪时,尖端锐利;禁用裁剪时,笔画穿过标记的斜侧并留下平坦的末端。

在示例的其他线条中,穿出的笔画在 2 点宽的三角形上不太明显。填充的菱形在两种宽度下都覆盖了笔画的末端。
控制文本和字体
将幻灯片导出为 SVG 时,您可以控制文本是保持为文本还是转换为矢量图形,以及外部字体如何包含或引用。以下选项帮助您在导出 SVG 时平衡视觉一致性、文本可选取性和字体依赖性。
向量化所有文本
将 SVGOptions.setVectorizeText 设置为 true,可将所有幻灯片文本写为矢量图形。这消除了字体依赖,使跨浏览器的视觉效果更一致,但文本不再可作为 SVG 文本进行选择或搜索。
$presentation = new Presentation("presentation.pptx");
$svgStream = null;
try {
$svgOptions = new SVGOptions();
$svgOptions->setVectorizeText(true);
$slide = $presentation->getSlides()->get_Item(0);
$svgStream = new Java("java.io.FileOutputStream", "slide-with-vectorized-text.svg");
$slide->writeAsSvg($svgStream, $svgOptions);
} finally {
$svgStream->close();
$presentation->dispose();
}
选择外部字体的处理方式
SVGOptions.setExternalFontsHandling 使用一个 SvgExternalFontsHandling 值来处理外部加载的字体。选择 AddLinksToFontFiles 以引用单独的字体文件,Embed 将字体数据嵌入 SVG,或 Vectorize 将仅使用外部字体的文本渲染为图形。嵌入字体前请确认字体授权。
$presentation = new Presentation("presentation.pptx");
try {
$slide = $presentation->getSlides()->get_Item(0);
$linkedFontsOptions = new SVGOptions();
$linkedFontsOptions->setExternalFontsHandling(SvgExternalFontsHandling::AddLinksToFontFiles);
$linkedFontsStream = new Java("java.io.FileOutputStream", "slide-with-font-links.svg");
try {
$slide->writeAsSvg($linkedFontsStream, $linkedFontsOptions);
} finally {
$linkedFontsStream->close();
}
$embeddedFontsOptions = new SVGOptions();
$embeddedFontsOptions->setExternalFontsHandling(SvgExternalFontsHandling::Embed);
$embeddedFontsStream = new Java("java.io.FileOutputStream", "slide-with-embedded-fonts.svg");
try {
$slide->writeAsSvg($embeddedFontsStream, $embeddedFontsOptions);
} finally {
$embeddedFontsStream->close();
}
$vectorizedExternalFontsOptions = new SVGOptions();
$vectorizedExternalFontsOptions->setExternalFontsHandling(SvgExternalFontsHandling::Vectorize);
$vectorizedExternalFontsStream = new Java("java.io.FileOutputStream", "slide-with-vectorized-external-fonts.svg");
try {
$slide->writeAsSvg($vectorizedExternalFontsStream, $vectorizedExternalFontsOptions);
} finally {
$vectorizedExternalFontsStream->close();
}
} finally {
$presentation->dispose();
}
减小嵌入图像大小
使用 SVGOptions.setPicturesCompression 降低嵌入图片的分辨率,使用 SVGOptions.setDeletePicturesCroppedAreas 省略裁剪的源区域,并使用 SVGOptions.setJpegQuality 控制 JPEG 编码质量。这些设置会在降低图像保真度或保留的图像数据的代价下减小文件大小。
$presentation = new Presentation("presentation.pptx");
$svgStream = null;
try {
$svgOptions = new SVGOptions();
$svgOptions->setPicturesCompression(PicturesCompression::Dpi150);
$svgOptions->setDeletePicturesCroppedAreas(true);
$svgOptions->setJpegQuality(80);
$slide = $presentation->getSlides()->get_Item(0);
$svgStream = new Java("java.io.FileOutputStream", "compressed-slide.svg");
$slide->writeAsSvg($svgStream, $svgOptions);
} finally {
$svgStream->close();
$presentation->dispose();
}
控制元文件光栅化分辨率
SVGOptions.setMetafileRasterizationDpi 设置在 SVG 导出期间对元文件进行光栅化的最低分辨率限制。使用它可以在对 EMF 或 WMF 图像进行光栅化时平衡细节和文件大小。它并不为 SVG 定义全局 DPI,也不会强制幻灯片上的每个对象都成为光栅图像。
下载 metafile-rasterization.pptx,其中包含一张具有紧密对角线的 EMF 图像。以下示例通过 Slide.writeAsSvg 将其第一张幻灯片以三种光栅化分辨率导出。所有其他导出设置保持相同,以便对比结果。
$presentation = new Presentation("metafile-rasterization.pptx");
try {
foreach ([72, 150, 300] as $dpi) {
$svgOptions = new SVGOptions();
$svgOptions->setMetafileRasterizationDpi($dpi);
$svgOptions->setPicturesCompression(PicturesCompression::Dpi330);
$svgOptions->setJpegQuality(90);
$outputFileName = sprintf("slide-%d.svg", $dpi);
$svgStream = new Java("java.io.FileOutputStream", $outputFileName);
try {
$presentation->getSlides()->get_Item(0)->writeAsSvg($svgStream, $svgOptions);
} finally {
$svgStream->close();
}
}
} finally {
$presentation->dispose();
}
输出中,EMF 成为每个 SVG 中的一个嵌入 PNG。以下测量针对提供的演示文稿;它们并非将 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
向 SVGOptions.setShapeFormattingController 提供格式化回调,以为每个 SVG 形状设置 SvgShape.setId。回调还可以在文本 tspan 元素上设置 SvgTSpan.setId 的值。
PhpJavaBridge 在流模式下运行时,无法从 writeAsSvg 调用 PHP 回调。请将格式化逻辑放入一个小的 Java 辅助类,编译后将生成的 JAR 文件添加到桥接类路径中。该辅助类可以使用 Shape.getOfficeInteropShapeId,该 ID 在形状的生命周期内保持稳定,并使用可重复的计数器为其文本跨度分配 ID。请参阅 Java 实现的 StableSvgIdController 获取辅助代码。
将编译好的 com.example.slides.StableSvgIdController 类添加到桥接类路径后,从 PHP 实例化它并分配给 SVGOptions:
$presentation = new Presentation("presentation.pptx");
$svgStream = null;
try {
$shapeFormattingController = new Java("com.example.slides.StableSvgIdController");
$svgOptions = new SVGOptions();
$svgOptions->setShapeFormattingController($shapeFormattingController);
$slide = $presentation->getSlides()->get_Item(0);
$svgStream = new Java("java.io.FileOutputStream", "slide-with-stable-ids.svg");
$slide->writeAsSvg($svgStream, $svgOptions);
} finally {
$svgStream->close();
$presentation->dispose();
}
添加 SVG 事件处理程序
在格式化回调中,使用 SvgShape.setEventHandler 并传入一个 SvgEvent 值,为导出形状添加 JavaScript 事件处理程序。通过 SVGOptions.setShapeFormattingController 分配回调,并在承载结果的页面或 SVG 文档中定义 JavaScript 函数。
与稳定 ID 类似,当 PhpJavaBridge 使用流模式时,请在 Java 辅助类中实现回调。Java 实现的 SvgEventController 为名为 ActionButton 的形状分配 ID 和 OnClick 处理程序。编译该辅助类,将其作为 com.example.slides.SvgEventController 添加到桥接类路径,并按以下方式从 PHP 使用:
$presentation = new Presentation("presentation.pptx");
$svgStream = null;
try {
$shapeFormattingController = new Java("com.example.slides.SvgEventController");
$svgOptions = new SVGOptions();
$svgOptions->setShapeFormattingController($shapeFormattingController);
$slide = $presentation->getSlides()->get_Item(0);
$svgStream = new Java("java.io.FileOutputStream", "interactive-slide.svg");
$slide->writeAsSvg($svgStream, $svgOptions);
} finally {
$svgStream->close();
$presentation->dispose();
}
宿主页面可以定义由处理程序引用的 JavaScript 函数。分配 ID 和事件处理程序可实现幻灯片查看器、辅助功能增强和其他交互式 SVG 工作流。
常见问题
何时应使用 SVGOptions.setVectorizeText 而不是 SvgExternalFontsHandling.Vectorize?
当所有文本必须独立于字体时,使用 SVGOptions.setVectorizeText。当仅需要将使用外部字体的文本转换为图形时,使用 SvgExternalFontsHandling.Vectorize。
使 SVG 更小的最佳方法是什么?
首先压缩嵌入的图片,删除裁剪的图像区域,并在目标环境能够提供字体文件时选择链接字体文件。测试结果,因为降低图像分辨率、降低 JPEG 质量以及矢量化文本各有不同的质量和大小权衡。
导出后可以修改导出的 SVG 元素吗?
可以。通过格式化回调分配 ID,然后在后处理工具或浏览器脚本中选择匹配的 SVG 元素。