# 坐标系统

yaml2pptx 使用英寸（inch）作为位置和尺寸的单位。

## 基本概念

- **单位**：英寸 (inch)
- **原点**：幻灯片左上角 (0, 0)
- **方向**：X 轴向右，Y 轴向下

## 幻灯片尺寸

### 16:9 宽高比

- 尺寸：10" × 5.625"
- 宽度：10 英寸
- 高度：5.625 英寸

### 4:3 宽高比

- 尺寸：10" × 7.5"
- 宽度：10 英寸
- 高度：7.5 英寸

## box 属性

`box` 属性用于指定元素的位置和尺寸：

```yaml
box: [x, y, width, height]
```

| 参数 | 说明 | 单位 |
|------|------|------|
| `x` | 左上角 X 坐标 | 英寸 |
| `y` | 左上角 Y 坐标 | 英寸 |
| `width` | 元素宽度 | 英寸 |
| `height` | 元素高度 | 英寸 |

## 示例

```yaml
# 位置：(1", 2")，尺寸：宽 8"，高 1"
box: [1, 2, 8, 1]
```

这表示：
- 元素左上角位于 (1", 2")
- 元素宽度为 8"
- 元素高度为 1"

## position 属性（表格）

表格元素使用 `position` 属性指定位置：

```yaml
position: [x, y]
```

| 参数 | 说明 | 单位 |
|------|------|------|
| `x` | 左上角 X 坐标 | 英寸 |
| `y` | 左上角 Y 坐标 | 英寸 |

## 定位示例

### 居中文本

```yaml
# 16:9 幻灯片
# 宽度 10"，要居中一个 8" 宽的元素
# x = (10 - 8) / 2 = 1

- type: text
  box: [1, 2, 8, 1]
  content: "居中文本"
  font:
    align: center
```

### 全屏背景

```yaml
# 16:9 幻灯片
- type: shape
  box: [0, 0, 10, 5.625]  # 完全覆盖
  shape: rectangle
  fill: "#ffffff"
```

### 四个象限

```yaml
slides:
  - elements:
      # 左上象限
      - type: text
        box: [0.25, 0.25, 4.5, 2.5]
        content: "左上"

      # 右上象限
      - type: text
        box: [5.25, 0.25, 4.5, 2.5]
        content: "右上"

      # 左下象限
      - type: text
        box: [0.25, 3, 4.5, 2.5]
        content: "左下"

      # 右下象限
      - type: text
        box: [5.25, 3, 4.5, 2.5]
        content: "右下"
```

## 坐标计算

### 水平居中

```python
x = (slide_width - element_width) / 2
```

### 垂直居中

```python
y = (slide_height - element_height) / 2
```

### 完全居中

```yaml
# 16:9 幻灯片，居中 4" × 2" 的元素
# x = (10 - 4) / 2 = 3
# y = (5.625 - 2) / 2 = 1.8125

- type: shape
  box: [3, 1.8125, 4, 2]
  shape: rectangle
  fill: "#3498db"
```

## 注意事项

- 所有坐标和尺寸必须为正数
- 元素可以超出页面边界（会发出警告）
- 浮点数精度建议保留 2-3 位小数

## 相关文档

- [颜色格式](colors.md) - 颜色表示方法

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