SmartOpenCV: Android端OpenCV增强库的革新之作

SmartOpenCV简介

SmartOpenCV是一个为Android平台量身打造的OpenCV增强库,旨在解决OpenCV官方SDK在图像预览方面存在的诸多问题。作为一个开源且功能强大的跨平台计算机视觉库,OpenCV在图像处理和图像识别领域得到了广泛应用。然而,在Android平台上,OpenCV官方SDK在图像预览方面存在一些明显的缺陷,这些问题一直困扰着开发者。SmartOpenCV的出现,为这些问题提供了一个优雅的解决方案。

SmartOpenCV的核心特点

易于使用: SmartOpenCV的设计理念是"即插即用"。如果你的项目之前使用的是OpenCV的官方SDK,那么引入SmartOpenCV后,只需在XML文件中将JavaCameraView/JavaCamera2View替换为SmartOpenCV的CameraPreview/Camera2Preview,就可以立即获得与使用官方SDK相同的效果,同时享受SmartOpenCV带来的增强功能。
功能增强:
- 预览自适应: SmartOpenCV能够自动根据前后摄像头、横竖屏以及不同摄像头参数来调整和适配预览方向及大小,开发者无需编写任何额外代码。
- 可扩展的预览绘制算法: 除了内置的默认预览帧绘制算法,SmartOpenCV还提供了策略接口,允许开发者根据具体的业务场景自定义预览绘制算法。
- 可定制的预览帧大小选择算法: SmartOpenCV不仅内置了一种默认的预览帧大小计算算法,还提供了策略接口,使开发者能够根据特定需求自定义预览帧大小计算算法。
- USB摄像头支持: 考虑到USB摄像头作为外设接入设备与移动设备内置摄像头的差异,SmartOpenCV在处理移动设备摄像头的同时,也兼容了对闸机等设备上USB摄像头的处理。
友好的API接口: SmartOpenCV在继承OpenCV官方接口的基础上,通过CameraConfiguration统一了众多繁杂的操作,提供了更加友好的Fluent API接口。这使得开发者能够更加灵活地控制预览显示相关的参数与配置。
与官方SDK解耦: SmartOpenCV不直接依赖于OpenCV官方SDK,这种设计使得它可以兼容所有版本的官方SDK(前提是官方SDK内部核心逻辑未做修改)。这意味着,如果开发者日后打算升级依赖的OpenCV版本,只需更新OpenCV的依赖为新版本即可,无需对代码做任何改动。

SmartOpenCV vs OpenCV官方SDK

为了更直观地展示SmartOpenCV相较于OpenCV官方SDK的优势,我们以人脸识别为例,对比两者在横屏和竖屏模式下的表现:

横屏模式

OpenCV官方SDK: 即使将宽度和高度都设置为match_parent,预览画面仍无法全屏显示,存在明显的黑边。
SmartOpenCV: 预览画面可以完美适配屏幕,无黑边,显示效果更加理想。

竖屏模式

OpenCV官方SDK: 默认不支持竖屏显示,且存在黑边问题。
SmartOpenCV: 完美支持竖屏显示,预览画面可以自适应屏幕方向,无黑边,显示效果优秀。

OpenCV vs SmartOpenCV横屏对比 OpenCV vs SmartOpenCV竖屏对比

如何集成SmartOpenCV

要在你的Android项目中集成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' // 排除打包时依赖的该模块
    }
}

注意: 版本号建议使用已release的最新版本。

SmartOpenCV的使用方法

基础用法

使用SmartOpenCV最简单的方法是在XML布局文件中替换OpenCV的预览控件:

<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提供的高级API:

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());