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

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