# Element Rendering Delta Spec ## REMOVED Requirements ### Requirement: 系统必须支持图片元素渲染 (部分移除) **Reason**: 移除图片适配模式功能(fit 和 background 参数),简化图片渲染逻辑 **Migration**: 移除图片元素的 `fit` 和 `background` 参数定义,系统将使用简单的拉伸模式渲染图片 #### Scenario: 使用 fit 模式渲染图片 **REMOVED** - **WHEN** 元素定义为 `{type: image, src: "photo.jpg", box: [1, 1, 4, 3], fit: contain}` - **THEN** 系统使用 `contain` 模式渲染图片 - **AND** 保持图片宽高比,完整显示在 box 内 #### Scenario: 使用背景色渲染图片 **REMOVED** - **WHEN** 元素定义为 `{type: image, src: "photo.png", box: [1, 1, 4, 3], fit: contain, background: "#f0f0f0"}` - **THEN** 系统使用 `contain` 模式渲染图片 - **AND** 用 #f0f0f0 颜色填充留白区域 #### Scenario: 图片格式不支持时报错 **REMOVED** - **WHEN** 图片文件格式不被 Pillow 支持 - **THEN** 系统抛出错误,提示图片格式不支持,并列出支持的格式 #### Scenario: 图片处理失败时报错 **REMOVED** - **WHEN** Pillow 处理图片时发生异常(如文件损坏) - **THEN** 系统抛出 ERROR 级别错误,不降级到其他模式 #### Scenario: 使用 DPI 配置渲染图片 **REMOVED** - **WHEN** metadata 定义了 `dpi: 120` 且图片需要处理 - **THEN** 系统使用该 DPI 值进行像素与英寸的转换 #### Scenario: fit 参数值无效时报错 **REMOVED** - **WHEN** `fit` 参数值不是 stretch、contain、cover、center 之一 - **THEN** 系统抛出 ERROR,并列出有效值 #### Scenario: background 参数颜色格式无效时报错 **REMOVED** - **WHEN** `background` 值不是有效的颜色格式 - **THEN** 系统抛出 ERROR,提示颜色格式应为 #RRGGBB 或 #RGB ## MODIFIED Requirements ### Requirement: 系统必须支持图片元素渲染 系统 SHALL 将 YAML 中定义的图片元素渲染为 PPTX 图片对象,直接使用 python-pptx 的原生图片添加功能。 #### Scenario: 渲染本地图片 - **WHEN** 元素定义为 `{type: image, src: "images/logo.png", box: [2, 3, 4, 3]}` - **THEN** 系统从指定路径加载图片,在 (2, 3) 位置渲染为 4×3 英寸大小 - **AND** 图片会被拉伸到指定尺寸(python-pptx 默认行为) #### Scenario: 图片文件不存在时报错 - **WHEN** 图片 src 指向不存在的文件路径 - **THEN** 系统抛出错误,明确指出图片文件未找到 #### Scenario: 相对路径处理 - **WHEN** 图片 src 使用相对路径 `"assets/images/logo.png"` - **THEN** 系统基于演示文稿文件所在目录解析相对路径