# 形状元素

形状元素用于在幻灯片中绘制几何形状。

## 基本语法

```yaml
- type: shape
  box: [x, y, width, height]
  shape: rectangle  # rectangle/ellipse/rounded_rectangle
  fill: "#4a90e2"   # 填充颜色
  line:
    color: "#000000"  # 边框颜色
    width: 2          # 边框宽度（磅）
```

## 属性

| 属性 | 类型 | 必需 | 说明 |
|------|------|------|------|
| `type` | 字符串 | 是 | 必须为 "shape" |
| `box` | 数组 | 是 | 位置和尺寸 [x, y, width, height]（英寸） |
| `shape` | 字符串 | 是 | 形状类型 |
| `fill` | 字符串 | 否 | 填充颜色（#RRGGBB 或 #RGB） |
| `line` | 对象 | 否 | 边框配置 |

## 形状类型

### rectangle（矩形）

```yaml
- type: shape
  box: [1, 1, 4, 2]
  shape: rectangle
  fill: "#4a90e2"
```

### ellipse（椭圆）

```yaml
- type: shape
  box: [1, 1, 4, 2]
  shape: ellipse
  fill: "#e74c3c"
```

### rounded_rectangle（圆角矩形）

```yaml
- type: shape
  box: [1, 1, 4, 2]
  shape: rounded_rectangle
  fill: "#2ecc71"
```

## 边框配置

```yaml
line:
  color: "#000000"  # 边框颜色
  width: 2          # 边框宽度（磅）
```

## 示例

### 简单矩形

```yaml
slides:
  - elements:
      - type: shape
        box: [1, 1, 4, 2]
        shape: rectangle
        fill: "#4a90e2"
```

### 带边框的形状

```yaml
slides:
  - elements:
      - type: shape
        box: [1, 1, 4, 2]
        shape: rectangle
        fill: "#ffffff"
        line:
          color: "#000000"
          width: 2
```

### 多个形状组合

```yaml
slides:
  - elements:
      # 背景矩形
      - type: shape
        box: [0, 0, 10, 5.625]
        shape: rectangle
        fill: "#f5f5f5"

      # 装饰圆形
      - type: shape
        box: [1, 1, 2, 2]
        shape: ellipse
        fill: "#3498db"

      # 文本
      - type: text
        box: [3.5, 1.5, 5, 1]
        content: "欢迎"
        font:
          size: 44
```

### 无填充形状

```yaml
- type: shape
  box: [1, 1, 4, 2]
  shape: rectangle
  fill: "transparent"  # 透明填充
  line:
    color: "#000000"
    width: 2
```

## 注意事项

- 形状会按照 box 指定的尺寸进行绘制
- 填充颜色和边框颜色使用相同的格式
- 边框宽度单位为磅（pt）

## 相关文档

- [坐标系统](../reference/coordinates.md) - 位置和尺寸单位
- [颜色格式](../reference/colors.md) - 颜色表示方法

[返回文档索引](../README.md)