4. 工具界面总览：主窗口布局、菜单栏、工具栏、图像预览区、参数控制面板、直方图与波形监视器

RK ISP 调优工具（通常称为 RKISP_Tuner 或 RKIQTool）的界面设计遵循“所见即所得”的在线调试理念。整个窗口采用经典的 IDE 式多面板布局，将参数编辑、图像预览和数据分析三大核心功能分区展示。本章将逐一拆解主窗口的六大区域，帮助你在首次打开工具时快速建立空间认知。

4.1 主窗口布局总览

工具启动后，默认显示一个 四象限式 的主窗口。左侧为参数控制区，右侧为图像预览与数据分析区。顶部为菜单与工具栏，底部为状态栏。整体布局强调 左侧编辑、右侧观察 的工作流。

4.2 菜单栏与工具栏

菜单栏和工具栏提供了工具的核心操作入口，涵盖 设备管理、配置加载、调试控制 三大类功能。

4.2.1 菜单栏功能清单

4.2.2 工具栏核心按钮

工具栏将最常用的操作以图标按钮形式呈现，方便快速点击。以下为关键按钮及其功能：

• 连接设备 (Connect)：通过 USB 或网络与 RK 平台建立通信，连接成功后状态栏显示设备型号。
• 加载配置 (Load)：从本地加载已保存的 ISP 参数配置文件，参数面板将同步更新。
• 保存配置 (Save)：将当前参数面板中的所有值保存到配置文件。
• 单帧捕获 (Snap)：捕获当前预览画面的一帧，用于静态分析。
• 开始/停止流 (Stream)：控制 ISP 图像数据流的启停，调试时通常保持开启。
• 复位参数 (Reset)：将当前模块的参数恢复为默认值，避免误调。
• 截图 (Screenshot)：截取当前工具界面，用于调试记录。

4.3 图像预览区

图像预览区是调优工作的 视觉反馈核心。它实时显示经过 ISP 管线处理后的最终图像，支持多种显示模式。

• 实时预览 (Live View)：默认模式，以 30fps 或更高帧率显示 ISP 输出图像。
• 单帧冻结 (Freeze)：暂停预览，便于仔细对比参数调整前后的细节变化。
• 分屏对比 (Split View)：将预览区分为左右或上下两部分，左侧显示参考图像（如调优前），右侧显示当前图像（调优后）。
• 局部放大 (Zoom)：支持 1x / 2x / 4x 放大，用于检查噪点、边缘伪影等细节。

预览区顶部通常显示当前图像的分辨率、帧率、曝光时间等元数据，帮助判断 ISP 运行状态。

4.4 参数控制面板

参数控制面板位于窗口左侧，以 树形结构 组织 ISP 管线中的各个模块。每个模块展开后包含若干可调参数，参数类型包括：

• 滑块 (Slider)：用于连续值调节，如增益、曝光时间。
• 下拉菜单 (Dropdown)：用于模式选择，如 AWB 模式、去噪强度等级。
• 数值输入框 (SpinBox)：直接输入精确数值，如 Gamma 曲线节点坐标。
• 复选框 (CheckBox)：启用或禁用某个功能模块。

参数面板支持 实时联动：当拖动滑块或修改数值时，ISP 硬件会立即应用新参数，预览区图像同步更新，实现“即调即看”的在线调试体验。

4.5 直方图与波形监视器

这两个分析工具位于预览区下方，用于 客观量化 图像质量，避免仅凭肉眼判断的主观偏差。

4.5.1 直方图 (Histogram)

直方图显示图像中每个亮度级别的像素数量分布。横轴表示亮度值（0~255，或 0~1023 对于 RAW 域），纵轴表示像素数量。

• RGB 叠加直方图：分别显示 R、G、B 三个通道的分布，用于判断白平衡是否准确（三个通道的峰值应大致重合）。
• Y 亮度直方图：显示亮度分量的分布，用于评估曝光是否合理。理想情况下，直方图应覆盖整个亮度范围，且不出现明显的“撞墙”（过曝或欠曝）。

4.5.2 波形监视器 (Waveform)

波形监视器以 二维扫描线 的方式显示图像每一列的亮度电平。横轴对应图像的宽度方向，纵轴表示亮度值（0~1023）。

• 亮度波形：显示 Y 分量的电平分布，可以直观地看到画面中哪些区域过曝（顶部）或欠曝（底部）。
• RGB 分量波形：分别显示 R、G、B 三个通道的波形，用于精细分析色彩偏移。

4.6 状态栏与辅助信息

窗口底部的状态栏提供 实时系统反馈，包括：

• 设备连接状态：显示当前连接的 RK 平台型号（如 RK3588、RK3568）及连接方式（USB 3.0 / 以太网）。
• ISP 运行状态：显示 ISP 管线是否正常运行，帧率（fps）和管线延迟（ms）。
• 参数同步状态：显示当前参数是否已同步到硬件，若出现“未同步”提示，需点击“应用”按钮。