Files

lanyuanxiaoyao 19d6661381 feat: 添加图片适配模式支持

- 支持四种图片适配模式：stretch、contain、cover、center
- 支持背景色填充功能（contain 和 center 模式）
- 支持文档级 DPI 配置（metadata.dpi）
- PPTX 渲染器集成 Pillow 实现高质量图片处理
- HTML 渲染器使用 CSS object-fit 实现相同效果
- 添加完整的单元测试、集成测试和端到端测试
- 更新 README 文档和架构文档
- 模块化设计：utils/image_utils.py 图片处理工具模块
- 添加图片配置验证器：validators/image_config.py
- 向后兼容：未指定 fit 时默认使用 stretch 模式

2026-03-04 10:29:21 +08:00

2.8 KiB

Raw Blame History

Element Rendering - Delta Spec

本 spec 是对 openspec/specs/element-rendering/spec.md 的增量修改。

MODIFIED Requirements

Requirement: 系统必须支持图片元素渲染

系统 SHALL 将 YAML 中定义的图片元素渲染为 PPTX 图片对象，支持 fit 和 background 参数控制图片适配模式。

Scenario: 渲染本地图片

WHEN 元素定义为 {type: image, src: "images/logo.png", box: [2, 3, 4, 3]}
THEN 系统从指定路径加载图片，在 (2, 3) 位置渲染为 4×3 英寸大小
AND 使用默认的 stretch 模式（向后兼容）

Scenario: 使用 fit 模式渲染图片

WHEN 元素定义为 {type: image, src: "photo.jpg", box: [1, 1, 4, 3], fit: contain}
THEN 系统使用 contain 模式渲染图片
AND 保持图片宽高比，完整显示在 box 内

Scenario: 使用背景色渲染图片

WHEN 元素定义为 {type: image, src: "photo.png", box: [1, 1, 4, 3], fit: contain, background: "#f0f0f0"}
THEN 系统使用 contain 模式渲染图片
AND 用 #f0f0f0 颜色填充留白区域

Scenario: 图片文件不存在时报错

WHEN 图片 src 指向不存在的文件路径
THEN 系统抛出错误，明确指出图片文件未找到

Scenario: 图片格式不支持时报错

WHEN 图片文件格式不被 Pillow 支持
THEN 系统抛出错误，提示图片格式不支持，并列出支持的格式

Scenario: 图片处理失败时报错

WHEN Pillow 处理图片时发生异常（如文件损坏）
THEN 系统抛出 ERROR 级别错误，不降级到其他模式

Scenario: 相对路径处理

WHEN 图片 src 使用相对路径 "assets/images/logo.png"
THEN 系统基于演示文稿文件所在目录解析相对路径

Scenario: 使用 DPI 配置渲染图片

WHEN metadata 定义了 dpi: 120 且图片需要处理
THEN 系统使用该 DPI 值进行像素与英寸的转换

Scenario: fit 参数值无效时报错

WHEN fit 参数值不是 stretch、contain、cover、center 之一
THEN 系统抛出 ERROR，并列出有效值

Scenario: background 参数颜色格式无效时报错

WHEN background 值不是有效的颜色格式
THEN 系统抛出 ERROR，提示颜色格式应为 #RRGGBB 或 #RGB

Requirement: 图片元素的 box 参数必须存在

系统 SHALL 要求图片元素必须包含 box 参数，否则验证失败。

Scenario: 缺少 box 参数时报错

WHEN 图片元素未定义 box 参数
THEN 系统抛出 ERROR，提示 box 参数为必需

Scenario: box 参数格式正确

WHEN 图片元素定义了 box: [1, 2, 4, 3]
THEN 系统验证通过，将 box 用于图片定位和尺寸

2.8 KiB Raw Blame History Unescape Escape