采集卡bug修复

PREVIEW_CONFIG_GUIDE.md

@@ -0,0 +1,161 @@
+# 预览配置说明
+
+## 📖 预览配置参数说明
+
+预览配置位于配置界面的**"预览配置"**区域，用于控制采集卡预览窗口的显示方式。
+
+### 配置参数
+
+#### 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。
+