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)所示。

 

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()方法用于在图像上添加文字(字母)，该方法的语法声明如下：

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

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

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

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

其中，参数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文件夹到项目即可。

 

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

 (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、补充说明

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