Android App开发超实用实例 | OpenCV在Android手机实现在图像上添加文本

时间:2022-11-02 10:52:38

Android App开发超实用实例 | OpenCV在Android手机实现在图像上添加文本

 OpenCV是一个基于BSD许可(开源)发行的跨平台计算机视觉库,它可以运行在Linux、Windows、Android和Mac OS等操作系统上。OpenCV原本由一系列 C 函数和少量 C++ 类构成,同时提供了Python等其他语言的接口,它实现了图像处理和计算机视觉方面的很多通用算法。下面这个实例演示了使用OpenCV在Android手机实现在图像上绘制文本。本文提供的OpenCV实例使用Java语言编写,并且运行在Android手机上。

01、实例功能

此实例主要通过使用Imgproc的putText()方法,实现在图像上绘制(添加)文本。Imgproc是Image和Processing这两个单词的缩写组合,它是OpenCV的图像处理模块,该模块包含如下内容:线性和非线性的图像滤波、图像的几何变换、图像转换、直方图相关、结构分析和形状描述、运动分析和对象跟踪、特征检测、目标检测等。

当实例运行之后,单击“显示原始图像”按钮,原始图像的效果如图1(a)所示。单击“在图像上添加文本”按钮,在图像上添加文本(OpenCV)之后的效果如图1(b)所示。

Android App开发超实用实例 | OpenCV在Android手机实现在图像上添加文本

 

02、实现代码

public class MainActivity extends Activity {
 ImageView myImageView;
 Bitmap myBitmap;
 static{ System.loadLibrary("opencv_java3");}               //加载OpenCV库
 @Override
 protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  setContentView(R.layout.activity_main);
  myImageView = (ImageView) findViewById(R.id.myImageView);
  myBitmap = BitmapFactory.decodeResource(getResources(), R.mipmap.myimage1);
 }
 public void onClickButton1(View v) {       //响应单击按钮“显示原始图像”
  myImageView.setImageBitmap(myBitmap);
 }
 public void onClickButton2(View v) {     //响应单击按钮“在图像上添加文本”
  Bitmap myNewBitmap=Bitmap.createBitmap(myBitmap.getWidth(),
          myBitmap.getHeight(),Bitmap.Config.RGB_565); //根据原始图像创建空Bitmap
  Mat myMat=new Mat();
  Utils.bitmapToMat(myBitmap,myMat);                //将原始图像保存至myMat
  Point myPoint=new Point(300, 700);                //定义绘制文本的起始位置
  Scalar myScalar=new Scalar(255,0,0,255);              //设置绘制文本的颜色
  //在图像上添加文本(仅支持英文、符号等,中文暂不支持)
  Imgproc.putText(myMat,"OpenCV",myPoint,
          Core.FONT_HERSHEY_COMPLEX,4,myScalar,3);
  //将添加文本之后的图像输出至myNewBitmap
  Utils.matToBitmap(myMat,myNewBitmap);
  //通过ImageView控件显示叠加文本之后的图像
  myImageView.setImageBitmap(myNewBitmap);
 }
}

03、代码说明

上面这段代码在MyCode\MySampleK31\app\src\main\java\com\bin\luo\mysample\ MainActivity.java文件中。在这段代码中,Imgproc的putText()方法用于在图像上添加文字(字母),该方法的语法声明如下:

Android App开发超实用实例 | OpenCV在Android手机实现在图像上添加文本

其中,参数Mat img表示待绘制的图像;参数String text表示待绘制的文字;参数Point org表示文字的起点坐标;参数int fontFace表示字体;参数double fontScale表示文字大小因子,值越大文字越大;参数Scalar color表示文字颜色;参数int thickness表示文字线条宽度。

Utils.bitmapToMat(myBitmap,myMat)用于将Bitmap输出到Mat,该方法的语法声明如下: 

Android App开发超实用实例 | OpenCV在Android手机实现在图像上添加文本

其中,参数Bitmap bmp表示源Bitmap,支持ARGB_8888和RGB_565像素类型;参数Mat mat表示目标Mat,默认类型是CV_8UC4类型,大小和Bitmap一样,通道顺序为RGBA。

Utils.matToBitmap(myMat,myNewBitmap)用于将Mat输出到Bitmap,该方法的语法声明如下: 

Android App开发超实用实例 | OpenCV在Android手机实现在图像上添加文本

其中,参数Mat mat表示源Mat,支持CV_8UC1,CV_8UC3或CV_8UC4类型;参数Bitmap bmp表示目标Bitmap,支持ARGB_8888或RGB_565类型。

static{ System.loadLibrary("opencv_java3");}表示加载OpenCV库。默认情况下,在Android中使用OpenCV需要导入相关的库文件,具体操作步骤如下。 

(1) 从https://opencv.org/releases.html页面中单击Android pack超链接,稍等一会儿即可弹出“新建下载任务”对话框,然后在该对话框中单击“下载”按钮,执行下载操作,如图2所示。在下载完成之后解压文件即可。在此实例中,可以忽略此步骤,直接从源代码中复制openCVLibrary345Copy文件夹到项目即可。

Android App开发超实用实例 | OpenCV在Android手机实现在图像上添加文本

 

(2) 在Android Studio菜单上依次选择File\New\Import Module...,弹出Import Module from Source对话框。在该对话框中单击“Source directory:”右端的文件夹按钮,然后选择openCVLibrary345Copy文件夹,会出现错误(重复)提示。直接在“Module name:”输入框中将openCVLibrary345Copy修改为openCVLibrary345,错误提示消失,如图3所示。再单击Finish按钮即可。

Android App开发超实用实例 | OpenCV在Android手机实现在图像上添加文本

 (3) 按照如下粗体字所示修改MyCode\MySampleK31\app\build.gradle文件。完成之后同步(Sync Now)即可。

apply plugin: 'com.android.application'
android {
    compileSdkVersion 29
    buildToolsVersion "29.0.2"
    defaultConfig {
        applicationId "com.bin.luo.mysample"
        minSdkVersion 27
        targetSdkVersion 29
        versionCode 1
        versionName "1.0"
        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
    sourceSets {  main { jniLibs.srcDirs = ['libs'] } }
}
dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'androidx.appcompat:appcompat:1.0.2'
    implementation 'androidx.constraintlayout:constraintlayout:1.1.3'
    testImplementation 'junit:junit:4.12'
    implementation project(':openCVLibrary345')
    androidTestImplementation 'androidx.test:runner:1.2.0'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.2.0'
}

 (4) 复制MyCode\MySampleK31\app\libs文件夹下的所有内容到(用户的)项目中即可。该文件夹及其子文件夹的文件与手机CPU的类型有关,缺少这些文件在编译或运行时会报错或无响应。

特别说明 /

在测试前必须从MyCode\MySampleK31\app\libs文件夹复制该文件夹中的所有子文件夹及其文件到(用户的)项目的libs文件夹。

04、补充说明

在测试代码时,必须保持网络畅通。