SmartOpenCV

SmartOpenCV：增强Android平台OpenCV功能的利器

SmartOpenCV是一个为Android平台OpenCV SDK提供增强功能的开源库。它解决了OpenCV Android SDK在图像预览方面存在的多个问题,同时提供了更友好的API接口,让开发者能够更灵活地控制预览显示相关参数与配置。

主要特点

SmartOpenCV具有以下几个突出特点:

1. 易于使用:只需在XML布局文件中将OpenCV的JavaCameraView/JavaCamera2View替换为SmartOpenCV的CamerPreview/Camera2Preview,即可获得增强功能。

2. 功能增强:

   • 预览自适应:自动根据摄像头和屏幕方向调整预览。
   • 可扩展的预览绘制算法:提供默认算法,同时允许自定义。
   • 可扩展的预览帧大小选择算法:提供默认算法,同时允许自定义。
   • 支持USB摄像头:兼容外接USB摄像头的处理。

3. 友好的API接口:提供Fluent API风格的CameraConfiguration接口,方便配置各项参数。

4. 与官方SDK解耦:不直接依赖OpenCV SDK,方便升级官方SDK版本。

解决的问题

SmartOpenCV主要解决了OpenCV Android SDK在以下几个方面的问题:

1. 默认横屏显示且无法修改预览方向的问题。
2. 预览绘制存在黑边的问题。
3. 预览帧大小选择算法不符合实际需求的问题。

使用方法

基础用法

只需在XML布局中将OpenCV的视图替换为SmartOpenCV的对应视图:

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

高级用法

通过SmartOpenCV.getInstance().init()方法进行初始化,可以灵活控制各项参数:

SmartOpenCV.getInstance().init(mOpenCvCameraView, new CameraConfiguration.Builder()
    .debug(true)
    .cameraIndex(0)
    .frontCamera(true)
    .landscape(false)
    .enableFpsMeter(true)
    .maxFrameSize(400, 300)
    .cvCameraViewListener(this)
    // 更多配置...
    .build());

效果对比

SmartOpenCV解决了OpenCV SDK在横屏和竖屏下预览存在黑边、无法全屏显示等问题,大大改善了预览效果。开发者可以下载Demo APK进行对比体验。

集成方法

1. 在项目根目录的build.gradle中添加JitPack仓库。
2. 在模块的build.gradle中添加SmartOpenCV依赖。

结语

SmartOpenCV为Android开发者提供了一个强大的工具,在保留OpenCV强大功能的同时,解决了多个实际应用中的痛点问题。它的易用性和灵活性使得在Android平台上开发计算机视觉应用变得更加简单和高效。