ray/huojv

Fork 0

Files

Ray 735eb79e0d 采集卡bug修复

2025-10-29 17:05:38 +08:00

4.3 KiB

Raw Blame History

预览配置说明

📖 预览配置参数说明

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

配置参数

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网格方式显示

🎯 配置技巧

根据采集卡数量调整：
- 采集卡数量 = 列数 × 行数
- 例如：3个采集卡可以用 3列×1行或 2列×2行（最后一个位置为空）
根据屏幕尺寸调整：
- 确保预览窗口能够完整显示在你的屏幕上
- 如果屏幕较小，可以减小预览宽度和高度
性能考虑：
- 预览窗口越大，CPU占用可能越高
- 推荐在1000-1600像素宽度范围内
视觉体验：
- 保持预览窗口的宽高比接近采集卡的宽高比
- 例如：采集卡是1920×1080，预览窗口可以是1600×900

🔧 如何配置

打开配置界面：
```
python gui_config.py
```
找到预览配置区域：
- 在配置界面右侧找到"预览配置"区域
修改参数：
- 在对应的输入框中输入你想要的数值
- 点击"保存配置"按钮
测试预览：
- 点击"启动预览"按钮查看效果
- 如果效果不理想，可以返回继续调整

⚠️ 注意事项

字段名必须正确：
- 配置使用 preview_width、preview_height、preview_columns、preview_rows
- 不要使用旧版本的 preview_window_width 和 preview_window_height
数值类型：
- 所有数值必须是整数
- 宽度和高度建议在 500-3000 像素之间
- 列数和行数建议在 1-4 之间
配置文件位置：
- 配置文件保存在 config.json 文件中的 display 部分
- 修改后会立即生效（需要重启预览窗口）

📝 配置文件示例

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

🚀 快速开始

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

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

4.3 KiB Raw Blame History Unescape Escape