Pillow 后端¶

Pillow 后端执行后端中立的 RasterScene，适合优先考虑安装兼容性和普通 CPU位图输出的部署环境。

安装¶

uv add "entari-plugin-htmlrender[pillow]>=0.1.0,<0.2"

pillow extra 安装 Pillow 12 或更高版本。未安装 extra 却启用后端时，composition抛出带安装提示的 GraphicsBackendUnavailableError，不会回退到 Skia。

平台约束¶

Pillow 为受支持的 Python 和主流平台发布 wheel。官方 Linux wheel 已捆绑当前RasterScene draw/PNG/JPEG 路径需要的常用图像库，因此正常 wheel 安装不要求额外的 EGL、OpenGL、Cairo 或 Fontconfig 动态库。若安装器找不到匹配 wheel 而回退到源码构建，则必须按 Pillow 的构建说明准备对应头文件与编译工具链；不要把源码构建依赖当作 wheel 的运行时依赖。

启用¶

plugins:
  htmlrender:
    graphics:
      backend: pillow

像素、命令与并发限制由共享的 graphics 配置控制，见Graphics 后端总览。

运行边界¶

Pillow 不进入 provider。调用方使用 service.graphics 或显式注入的GraphicsRenderer。输出遵循共享的 RGBA、source-over、JPEG matte 与质量语义；native draw 或 encode 失败翻译为 RasterBackendExecutionError。

完整调用示例见绘制 RasterScene。