代码收藏家技术教程 2025-02-12

【Python】 CairoSVG使用教程

CairoSVG是一个功能强大的工具，它能将SVG1.1格式的图像转换为PNG、PDF、PS等常见格式。以下是一个详细的CairoSVG使用教程：

一、CairoSVG简介

定义：CairoSVG是一个基于Python的库，它使用Cairo图形库来绘制SVG图像，并支持将SVG图像转换为多种格式。

支持版本：CairoSVG支持Python 3.5及以上版本（部分资料指出至少需要Python 3.6）。较旧的CairoSVG（1.x）版本兼容Python 2.x，但已不再受支持。

依赖项：CairoSVG依赖于tinycss2和cssselect2来应用CSS样式，依赖于defusedxml来检测不安全的SVG文件，嵌入式栅格图像由Pillow库处理。

二、安装CairoSVG

可以使用pip命令来安装CairoSVG：

pip3 install cairosvg

请注意，在安装过程中可能需要额外的工具，这些工具的名称取决于您使用的操作系统。例如，在Windows上，您需要安装适用于Python和Cairo的Visual C++编译器；在macOS上，您需要安装cairo和libffi；在Linux上，您需要安装cairo、python3-dev和libffi-dev。

三、使用CairoSVG

1. 命令行使用

通过命令行，您可以轻松地使用CairoSVG来转换SVG文件。例如，要将当前目录下的image.svg文件转换为image.png文件，可以使用以下命令：

cairosvg image.svg -o image.png

CairoSVG命令行参数详细说明如下：

-h 或 --help：显示帮助信息并退出。

-v 或 --version：显示程序的版本号并退出。

-f 或 --format：指定输出格式，支持pdf、png、ps和svg。

-d 或 --dpi：设置DPI比率，即1英寸和1像素之间的比率。

-W 或 --width：设置父容器的宽度（以像素为单位）。

-H 或 --height：设置父容器的高度（以像素为单位）。

-s 或 --scale：设置输出缩放因子。

-u 或 --unsafe：解析XML实体并允许非常大的文件（警告：易受XXE攻击和各种DoS攻击）。

--output-width 和 --output-height：分别设置期望的输出宽度和高度（以像素为单位）。

-o 或 --output：指定输出文件名。

2. Python库使用

CairoSVG还为Python提供了一个模块，该模块提供了四个函数：svg2pdf、svg2png、svg2ps和svg2svg（部分资料还提到了svg2gif函数，但请注意并非所有版本都支持）。这些函数的使用方法如下：

svg2png：将SVG图像转换为PNG格式。

import cairosvg
cairosvg.svg2png(url="/path/to/input.svg", write_to="/tmp/output.png")

svg2pdf：将SVG图像转换为PDF格式。

cairosvg.svg2pdf(file_obj=open("/path/to/input.svg", "rb"), write_to="/tmp/output.pdf")

svg2ps：将SVG图像转换为PS格式。

output = cairosvg.svg2ps(bytestring=open("/path/to/input.svg").read().encode('utf-8'))

svg2svg：对SVG文件进行切割或其他处理（如果支持的话）。

这些函数需要以下命名参数之一：url（一个URL或文件名）、file_obj（一个类文件对象）或bytestring（包含SVG的字节字符串）。它们还可以接收与命令行选项相对应的可选参数，如parent_width、parent_height、dpi、scale等。如果提供了write_to参数（文件名或类文件对象），则将输出写入此处；否则，函数将返回一个字节字符串。