feat: 移除图片适配模式功能
移除图片 fit 和 background 参数支持,简化图片渲染逻辑。系统恢复到直接使用 python-pptx 原生图片添加功能,图片将被拉伸到指定尺寸。 变更内容: - 移除 ImageElement 的 fit 和 background 字段 - 移除 metadata.dpi 配置 - 删除 utils/image_utils.py 图片处理工具模块 - 删除 validators/image_config.py 验证器 - 简化 PPTX 和 HTML 渲染器的图片处理逻辑 - HTML 渲染器使用硬编码 DPI=96(Web 标准) - 删除相关测试文件(单元测试、集成测试、e2e 测试) - 更新规格文档和用户文档 - 保留 Pillow 依赖用于未来可能的图片处理需求 影响: - 删除 11 个文件 - 修改 10 个文件 - 净减少 1558 行代码 - 所有 402 个测试通过 Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
@@ -67,49 +67,6 @@ yaml2pptx.py (入口)
|
||||
- 核心层不依赖其他业务模块
|
||||
- 验证层可以调用核心层的元素验证方法
|
||||
|
||||
### 图片处理架构
|
||||
|
||||
图片适配模式功能采用分层设计,将图片处理逻辑与渲染逻辑分离:
|
||||
|
||||
```
|
||||
ImageElement (核心层)
|
||||
↓ 定义 fit/background 字段
|
||||
utils/image_utils.py (工具层)
|
||||
↓ 提供图片处理函数
|
||||
├─→ apply_fit_mode() - 应用适配模式
|
||||
├─→ create_canvas_with_background() - 创建背景画布
|
||||
└─→ inches_to_pixels() / pixels_to_inches() - 单位转换
|
||||
↓ 使用 Pillow (PIL)
|
||||
renderers/pptx_renderer.py (渲染层)
|
||||
↓ 调用 image_utils 处理图片
|
||||
└─→ 将处理后的图片添加到 PPTX
|
||||
renderers/html_renderer.py (渲染层)
|
||||
└─→ 使用 CSS object-fit 实现相同效果
|
||||
```
|
||||
|
||||
**设计要点**:
|
||||
|
||||
1. **Pillow 依赖**:
|
||||
- 用于高质量图片处理(缩放、裁剪、画布创建)
|
||||
- 使用 LANCZOS 重采样算法确保最佳质量
|
||||
- 支持 RGB 模式和透明度处理
|
||||
|
||||
2. **适配模式实现**:
|
||||
- **stretch**:直接使用 `Image.resize()`
|
||||
- **contain**:使用 `ImageOps.contain()` 保持宽高比
|
||||
- **cover**:使用 `ImageOps.cover()` + 中心裁剪
|
||||
- **center**:不缩放,使用 `Image.crop()` 裁剪超出部分
|
||||
|
||||
3. **DPI 配置**:
|
||||
- 在 `metadata.dpi` 配置,默认 96
|
||||
- 通过 Presentation → Renderer 传递
|
||||
- 用于像素与英寸的转换计算
|
||||
|
||||
4. **向后兼容性**:
|
||||
- `fit` 和 `background` 参数可选
|
||||
- 未指定 `fit` 时默认使用 `stretch` 模式
|
||||
- 现有 YAML 文件无需修改即可正常工作
|
||||
|
||||
## 模块职责
|
||||
|
||||
### 1. yaml2pptx.py(入口层)
|
||||
@@ -128,22 +85,13 @@ renderers/html_renderer.py (渲染层)
|
||||
- 进度日志显示准确的渲染数量(不包括禁用的幻灯片)
|
||||
|
||||
### 2. utils/(工具层)
|
||||
- **职责**:通用工具函数和图片处理
|
||||
- **职责**:通用工具函数
|
||||
- **包含**:
|
||||
- `utils/__init__.py` - 日志和颜色工具
|
||||
- 日志函数:`log_info()`, `log_success()`, `log_error()`, `log_progress()`
|
||||
- 颜色转换:`hex_to_rgb()`, `validate_color()`
|
||||
- `utils/image_utils.py` - 图片处理工具
|
||||
- 单位转换:`inches_to_pixels()`, `pixels_to_inches()`
|
||||
- 图片适配:`apply_fit_mode()` - 支持 stretch/contain/cover/center 四种模式
|
||||
- 画布创建:`create_canvas_with_background()` - 创建带背景色的画布
|
||||
- **依赖**:
|
||||
- Pillow (PIL) - 用于高质量图片处理
|
||||
- 使用 LANCZOS 重采样算法确保最佳质量
|
||||
- **设计原则**:
|
||||
- 图片处理与渲染逻辑分离
|
||||
- 支持 DPI 配置,灵活控制图片分辨率
|
||||
- 所有图片操作返回 PIL Image 对象,便于后续处理
|
||||
- Pillow (PIL) - 保留用于未来可能的图片处理需求
|
||||
|
||||
### 3. loaders/yaml_loader.py(加载层)
|
||||
- **职责**:YAML 文件加载和验证
|
||||
@@ -187,10 +135,6 @@ renderers/html_renderer.py (渲染层)
|
||||
- `validators/resource.py` - 资源验证器
|
||||
- `ResourceValidator` - 检查图片、模板文件存在性
|
||||
- 验证模板文件结构
|
||||
- `validators/image_config.py` - 图片配置验证器
|
||||
- `validate_fit_value()` - 验证 fit 参数值
|
||||
- `validate_background_color()` - 验证背景色格式
|
||||
- `validate_dpi_value()` - 验证 DPI 值范围
|
||||
- `validators/validator.py` - 主验证器
|
||||
- `Validator` - 协调所有子验证器
|
||||
- 集成元素级验证、几何验证、资源验证
|
||||
|
||||
Reference in New Issue
Block a user