CVAT项目中如何强制以原始质量显示标注视图中的图像

在计算机视觉标注工具CVAT的实际使用过程中，开发者有时需要确保标注界面始终以原始图像质量显示，而不使用压缩版本。本文将详细介绍实现这一需求的技术方案。

问题背景

CVAT默认会在标注视图中提供图像质量切换功能，允许用户在"原始质量"和"压缩质量"之间选择。然而，在某些特定场景下，特别是当CVAT部署在本地网络环境中时，开发者可能希望强制系统始终使用原始质量显示图像，以简化用户操作并确保标注精度。

解决方案

要实现这一功能，需要修改CVAT的源代码并重新构建Docker镜像。以下是具体步骤：

1. 定位关键代码文件
   需要修改的文件是server-proxy.ts，该文件负责处理前端与后端之间的数据请求。

2. 修改请求参数
   在文件中找到getData函数，将其中的quality参数固定设置为'original'。修改后的代码片段如下：

async function getData(jid: number, chunk: number, quality: ChunkQuality, retry = 0): Promise<ArrayBuffer> {
    const { backendAPI } = config;

    try {
        const response = await (workerAxios as any).get(`${backendAPI}/jobs/${jid}/data`, {
            params: {
                ...enableOrganization(),
                quality: 'original', // 固定为原始质量
                type: 'chunk',
                number: chunk,
            },
            responseType: 'arraybuffer',
        });
        // ...其余代码保持不变
    }
    // ...异常处理代码
}

3. 重新构建Docker镜像
   修改代码后，必须重新构建Docker镜像才能使更改生效。使用以下命令：

docker compose -f docker-compose.yml -f docker-compose.dev.yml build

4. 重启CVAT服务
   构建完成后，重启服务以应用更改：

docker compose down
docker compose up -d

技术原理

这一修改的核心原理是覆盖了CVAT前端请求图像数据时的默认行为。在原始实现中，CVAT会根据用户选择或系统设置动态决定请求图像的压缩级别。通过强制设置quality参数为'original'，我们确保了所有图像请求都会获取原始质量版本。

注意事项

1. 性能考量：强制使用原始质量可能会增加网络传输负载，特别是在远程访问场景下。但在本地网络环境中，这种影响通常可以忽略。

2. 缓存问题：如果修改后仍看到压缩质量的图像，可能是浏览器缓存所致。建议清除缓存或使用无痕模式测试。

3. 升级兼容性：此修改属于对核心代码的定制，在CVAT版本升级时可能需要重新应用。

结论

通过上述方法，开发者可以轻松实现CVAT标注界面始终显示原始质量图像的需求。这种定制化方案特别适合对图像质量要求严格且部署在本地环境的标注项目。理解这一实现过程也有助于开发者更深入地掌握CVAT的架构设计和定制方法。