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 模式
This commit is contained in:
77
README.md
77
README.md
@@ -102,6 +102,7 @@ uv run yaml2pptx.py convert presentation.yaml --skip-validation
|
||||
```yaml
|
||||
metadata:
|
||||
size: "16:9" # 或 "4:3"
|
||||
dpi: 96 # 可选:DPI 配置,默认 96
|
||||
|
||||
slides:
|
||||
- background:
|
||||
@@ -117,6 +118,24 @@ slides:
|
||||
align: center
|
||||
```
|
||||
|
||||
#### DPI 配置
|
||||
|
||||
`metadata.dpi` 参数控制图片处理的分辨率,影响图片质量和文件大小:
|
||||
|
||||
- **默认值**:96 DPI(标准屏幕分辨率)
|
||||
- **建议范围**:72-300 DPI
|
||||
- **常用值**:
|
||||
- 72 DPI:网页显示
|
||||
- 96 DPI:标准屏幕(默认)
|
||||
- 150 DPI:高质量打印
|
||||
- 300 DPI:专业印刷
|
||||
|
||||
```yaml
|
||||
metadata:
|
||||
size: "16:9"
|
||||
dpi: 150 # 高质量输出
|
||||
```
|
||||
|
||||
### 使用模板
|
||||
|
||||
```yaml
|
||||
@@ -160,6 +179,64 @@ slides:
|
||||
- type: image
|
||||
box: [x, y, width, height]
|
||||
src: "path/to/image.png" # 支持相对路径和绝对路径
|
||||
fit: contain # 可选:图片适配模式
|
||||
background: "#f0f0f0" # 可选:背景色(仅对 contain 和 center 模式有效)
|
||||
```
|
||||
|
||||
#### 图片适配模式
|
||||
|
||||
`fit` 参数控制图片如何适配到指定的 box 区域,支持以下模式:
|
||||
|
||||
- **stretch**(默认):拉伸图片以填满整个 box,可能改变宽高比
|
||||
- **contain**:保持宽高比,完整显示图片在 box 内,可能留白
|
||||
- **cover**:保持宽高比,填满整个 box,可能裁剪图片
|
||||
- **center**:不缩放,居中显示,超出部分裁剪
|
||||
|
||||
**示例**:
|
||||
|
||||
```yaml
|
||||
slides:
|
||||
- elements:
|
||||
# 默认 stretch 模式
|
||||
- type: image
|
||||
src: "photo.jpg"
|
||||
box: [1, 1, 4, 3]
|
||||
|
||||
# contain 模式,带灰色背景
|
||||
- type: image
|
||||
src: "photo.jpg"
|
||||
box: [5, 1, 4, 3]
|
||||
fit: contain
|
||||
background: "#f0f0f0"
|
||||
|
||||
# cover 模式,填满区域
|
||||
- type: image
|
||||
src: "photo.jpg"
|
||||
box: [1, 4, 4, 3]
|
||||
fit: cover
|
||||
|
||||
# center 模式,不缩放
|
||||
- type: image
|
||||
src: "icon.png"
|
||||
box: [5, 4, 2, 2]
|
||||
fit: center
|
||||
background: "#ffffff"
|
||||
```
|
||||
|
||||
#### 背景色
|
||||
|
||||
`background` 参数为图片添加背景色,支持 `#RRGGBB` 或 `#RGB` 格式:
|
||||
|
||||
- 仅对 `contain` 和 `center` 模式有效
|
||||
- 当图片小于 box 或保持宽高比时,背景色填充留白区域
|
||||
- 默认为透明(无背景色)
|
||||
|
||||
```yaml
|
||||
- type: image
|
||||
src: "logo.png"
|
||||
box: [1, 1, 3, 2]
|
||||
fit: contain
|
||||
background: "#ffffff" # 白色背景
|
||||
```
|
||||
|
||||
### 形状元素
|
||||
|
||||
Reference in New Issue
Block a user