# 预览配置说明

## 📖 预览配置参数说明

预览配置位于配置界面的**"预览配置"**区域，用于控制采集卡预览窗口的显示方式。

### 配置参数

#### 1. **预览宽度** (`preview_width`)
- **说明**：预览窗口的宽度（像素）
- **默认值**：1000
- **建议值**：
  - 单个采集卡：800-1200
  - 2个采集卡：1000-1600
  - 4个采集卡：1200-2000
- **用途**：控制预览窗口的整体宽度

#### 2. **预览高度** (`preview_height`)
- **说明**：预览窗口的高度（像素）
- **默认值**：700
- **建议值**：
  - 单个采集卡：600-900
  - 2个采集卡：700-1000
  - 4个采集卡：800-1200
- **用途**：控制预览窗口的整体高度

#### 3. **预览列数** (`preview_columns`)
- **说明**：预览窗口中每行显示的采集卡数量
- **默认值**：2
- **范围**：1-4（推荐）
- **用途**：决定采集卡预览的网格布局列数
- **示例**：
  - 2列：适合2-4个采集卡
  - 1列：适合单个采集卡（全屏显示）
  - 3列：适合3个或6个采集卡

#### 4. **预览行数** (`preview_rows`)
- **说明**：预览窗口中每列显示的采集卡数量
- **默认值**：2
- **范围**：1-4（推荐）
- **用途**：决定采集卡预览的网格布局行数
- **示例**：
  - 2行：配合2列可以显示4个采集卡
  - 1行：适合1-3个采集卡（水平排列）
  - 3行：适合3个或更多采集卡

### 📐 配置示例

#### 示例1：单个采集卡全屏显示
```
预览宽度：1200
预览高度：900
预览列数：1
预览行数：1
```
**效果**：单个采集卡占据整个预览窗口

#### 示例2：2个采集卡并排显示
```
预览宽度：1600
预览高度：800
预览列数：2
预览行数：1
```
**效果**：两个采集卡水平并排显示

#### 示例3：4个采集卡网格显示（2x2）
```
预览宽度：1600
预览高度：1200
预览列数：2
预览行数：2
```
**效果**：四个采集卡以2x2网格方式显示

#### 示例4：6个采集卡网格显示（3x2）
```
预览宽度：1800
预览高度：1200
预览列数：3
预览行数：2
```
**效果**：六个采集卡以3x2网格方式显示

### 🎯 配置技巧

1. **根据采集卡数量调整**：
   - 采集卡数量 = 列数 × 行数
   - 例如：3个采集卡可以用 3列×1行 或 2列×2行（最后一个位置为空）

2. **根据屏幕尺寸调整**：
   - 确保预览窗口能够完整显示在你的屏幕上
   - 如果屏幕较小，可以减小预览宽度和高度

3. **性能考虑**：
   - 预览窗口越大，CPU占用可能越高
   - 推荐在1000-1600像素宽度范围内

4. **视觉体验**：
   - 保持预览窗口的宽高比接近采集卡的宽高比
   - 例如：采集卡是1920×1080，预览窗口可以是1600×900

### 🔧 如何配置

1. **打开配置界面**：
   ```bash
   python gui_config.py
   ```

2. **找到预览配置区域**：
   - 在配置界面右侧找到"预览配置"区域

3. **修改参数**：
   - 在对应的输入框中输入你想要的数值
   - 点击"保存配置"按钮

4. **测试预览**：
   - 点击"启动预览"按钮查看效果
   - 如果效果不理想，可以返回继续调整

### ⚠️ 注意事项

1. **字段名必须正确**：
   - 配置使用 `preview_width`、`preview_height`、`preview_columns`、`preview_rows`
   - 不要使用旧版本的 `preview_window_width` 和 `preview_window_height`

2. **数值类型**：
   - 所有数值必须是整数
   - 宽度和高度建议在 500-3000 像素之间
   - 列数和行数建议在 1-4 之间

3. **配置文件位置**：
   - 配置文件保存在 `config.json` 文件中的 `display` 部分
   - 修改后会立即生效（需要重启预览窗口）

### 📝 配置文件示例

```json
{
  "groups": [...],
  "display": {
    "preview_width": 1000,
    "preview_height": 700,
    "preview_columns": 2,
    "preview_rows": 2,
    "show_preview": true
  }
}
```

### 🚀 快速开始

1. 默认配置（2x2网格，1000x700窗口）适合大多数场景
2. 如果有多个采集卡，先尝试2列×2行的布局
3. 如果只有一个采集卡，设置为1列×1行，增大窗口尺寸
4. 根据实际效果微调，直到满意为止

---

**提示**：预览窗口可以点击任意采集卡画面来放大查看。放大后的窗口会在新窗口中显示，大小固定为1280×720。