SmartOpenCV: 增强Android端OpenCV图像预览功能的开源库

SmartOpenCV: 让Android端OpenCV图像预览更智能

随着人工智能和计算机视觉技术的快速发展,在移动设备上直接运行智能视觉系统已成为可能。OpenCV作为一个强大的开源计算机视觉库,在Android平台上得到了广泛应用。然而,OpenCV官方SDK在Android端的图像预览功能存在一些问题,影响了开发者的使用体验。为了解决这些问题,SmartOpenCV应运而生。

SmartOpenCV简介

SmartOpenCV是一个专为Android平台设计的OpenCV增强库。它巧妙地解决了OpenCV Android SDK在图像预览方面的多个问题,同时保持了与OpenCV SDK的兼容性。使用SmartOpenCV,开发者无需修改OpenCV SDK的源代码,只需简单替换XML布局文件中的相关组件,即可获得增强的预览功能。

SmartOpenCV Logo

SmartOpenCV的主要特点

易于使用: 对于已经在项目中使用OpenCV官方SDK的开发者来说,集成SmartOpenCV非常简单。只需在XML文件中将JavaCameraView或JavaCamera2View替换为SmartOpenCV的CameraPreview或Camera2Preview,即可获得增强功能。
功能增强:
- 预览自适应: 自动根据前后摄像头、横竖屏以及不同摄像头参数来调整预览方向和大小。
- 可扩展的预览绘制算法: 除了内置的默认预览帧绘制算法,SmartOpenCV还提供了接口让开发者根据具体需求自定义绘制算法。
- 灵活的预览帧大小选择: 开发者可以根据实际场景需求自定义预览帧大小的计算方法。
- 支持USB摄像头: 兼容了对闸机等设备上USB摄像头的处理。
友好的API接口: SmartOpenCV提供了更加简洁和灵活的Fluent API接口,让开发者能够更方便地控制预览显示相关的参数和配置。
与官方SDK解耦: SmartOpenCV不直接依赖于OpenCV官方SDK,这意味着当您需要升级OpenCV版本时,只需更新OpenCV的依赖,而无需修改代码。

SmartOpenCV解决的问题

OpenCV官方SDK在Android平台上存在以下几个主要问题:

默认横屏显示: 官方SDK默认采用横屏显示,且没有提供简单的接口来修改预览方向。
预览存在黑边: 由于OpenCV默认的绘制算法存在偏移,导致预览帧只占用SurfaceView控件的部分区域,其余部分显示为黑色。
预览帧大小选择不合理: OpenCV默认选择小于预览控件的最大预览帧大小,这在许多情况下会导致预览图像无法填满整个控件,甚至远小于控件大小。

SmartOpenCV通过优化这些方面,大大改善了预览效果和用户体验。

效果对比

为了直观地展示SmartOpenCV的优势,我们以人脸识别为例,对比了OpenCV官方SDK和SmartOpenCV在横屏和竖屏模式下的预览效果:

模式	OpenCV官方SDK	SmartOpenCV
横屏
竖屏

从上面的对比图中可以清楚地看到,使用OpenCV官方SDK时,即使将宽高都设置为match_parent,预览画面仍然无法全屏显示,存在明显的黑边。而且,官方SDK默认不支持竖屏显示。相比之下,SmartOpenCV在横屏和竖屏模式下都能够完美适配屏幕,提供全屏且清晰的预览效果。

如何使用SmartOpenCV

基础用法

使用SmartOpenCV非常简单,只需在XML布局文件中替换相应的组件即可:

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <tech.huqi.smartopencv.core.preview.CameraPreview
        android:id="@+id/fd_activity_surface_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />
</LinearLayout>

高级用法

如果您需要更精细地控制预览参数,可以使用SmartOpenCV提供的配置接口:

SmartOpenCV.getInstance().init(mOpenCvCameraView, new CameraConfiguration.Builder()
    .debug(true)
    .cameraIndex(0)
    .keepScreenOn(false)
    .frontCamera(true)
    .openCvDefaultDrawStrategy(false)
    .openCvDefaultPreviewCalculator(false)
    .landscape(false)
    .enableFpsMeter(true)
    .usbCamera(false)
    .maxFrameSize(400, 300)
    .cvCameraViewListener(this)
    .previewSizeCalculator(new IPreviewSizeCalculator() {
        @Override
        public Size calculateCameraFrameSize(List<Size> supportedSizes, int surfaceWidth, int surfaceHeight) {
            return new Size(1080, 1920);
        }
    })
    .drawStrategy(new IDrawStrategy() {
        @Override
        public void drawBitmap(Canvas canvas, Bitmap frameBitmap, int surfaceWidth, int surfaceHeight) {
            // 自定义绘制逻辑
        }
    })
    .build());

通过这种方式,您可以灵活地设置摄像头索引、屏幕方向、最大帧大小等参数,甚至可以自定义预览帧大小的计算策略和绘制策略。

集成SmartOpenCV

要在您的项目中使用SmartOpenCV,请按照以下步骤操作:

在项目根目录的build.gradle文件中添加JitPack仓库:

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

在需要使用SmartOpenCV的模块的build.gradle文件中添加依赖:

dependencies {
    implementation('com.github.HuTianQi:SmartOpenCV:1.0.1') {
        exclude module: 'openCVLibrary411'
    }
}

注意: 版本号建议使用已发布的最新版本,并且由于JitPack在多模块依赖时存在bug,需要排除openCVLibrary411模块。

结语

SmartOpenCV为Android开发者提供了一个强大而易用的工具,有效解决了OpenCV官方SDK在图像预览方面的诸多问题。通过使用SmartOpenCV,开发者可以轻松实现全屏、自适应的图像预览,大大提升了应用的用户体验。无论是进行人脸识别、物体检测还是其他计算机视觉任务,SmartOpenCV都能为您的Android应用带来更出色的预览效果。

如果您正在使用OpenCV进行Android开发,不妨尝试一下SmartOpenCV,相信它会为您的项目带来更多可能性。欢迎访问SmartOpenCV的GitHub仓库了解更多详情,并为这个优秀的开源项目贡献您的力量。

让我们一起,为Android平台上的计算机视觉应用开发创造更多可能!