.. _videoInputPSNRMSSIM:

OpenCV的视频输入和相似度测量
**************************************************

目标
====

现在找一个能拍摄视频的设备真是太容易了。结果大家都用视频来代替以前的序列图像。视频可能由两种形式得到，一个是像网络摄像头那样实时视频流，或者由其他设备产生的压缩编码后的视频文件。幸运的是，OpenCV可以使用相同的C++类、用同一种方式处理这些视频信息。在接下来的教程里你将学习如何使用摄像头或者视频文件。

.. container:: enumeratevisibleitemswithsquare

   + 如何打开和读取视频流
   + 两种检查相似度的方法：PSNR和SSIM

源代码
===============

就和其他的OpenCV小例子一样，在这里我也创建了一个小程序来读取两个视频文件然后比较它们的相似度。你可以用这个功能来验证视频压缩后的损失程度，这里有一个 :download:`参考视频（原始视频）<../../../../samples/cpp/tutorial_code/HighGUI/video-input-psnr-ssim/video/Megamind.avi>` 和 :download:`压缩后的视频 <../../../../samples/cpp/tutorial_code/HighGUI/video-input-psnr-ssim/video/Megamind_bugy.avi>`. 你可以在OpenCV的示例文件夹 :file:`samples/cpp/tutorial_code/HighGUI/video-input-psnr-ssim/` 下找到源码和示例视频。

.. literalinclude:: ../../../../samples/cpp/tutorial_code/HighGUI/video-input-psnr-ssim/video-input-psnr-ssim.cpp
   :language: cpp
   :linenos:
   :tab-width: 4
   :lines: 1-14, 28-29, 31-205

如何读取一个视频流（摄像头或者视频文件)？
===========================================================

总的来说，视频捕获需要的所有函数都集成在 :huivideo:`VideoCapture <videocapture>` C++ 类里面。虽然它底层依赖另一个FFmpeg开源库，但是它已经被集成在OpenCV里所以你不需要额外地关注它的具体实现方法。你只需要知道一个视频由一系列图像构成，我们用一个专业点儿的词汇来称呼这些构成视频的图像：“帧”（frame）。此外在视频文件里还有个参数叫做“帧率”（frame rate）的，用来表示两帧之间的间隔时间，帧率的单位是（帧/秒）。这个参数只和视频的播放速度有关，对于单独的一帧图像来说没有任何用途。

你需要先定义一个 :huivideo:`VideoCapture <videocapture>` 类的对象来打开和读取视频流。具体可以通过 :huivideo:`constructor <videocapture-videocapture>` 或者通过 :huivideo:`open <videocapture-open>` 函数来完成。如果使用整型数当参数的话，就可以将这个对象绑定到一个摄像机，将系统指派的ID号当作参数传入即可。例如你可以传入0来打开第一个摄像机，传入1打开第二个摄像机，以此类推。如果使用字符串当参数，就会打开一个由这个字符串（文件名）指定的视频文件。例如在上面的例子里传入如下参数: 

.. code-block:: bash

   video/Megamind.avi video/Megamind_bug.avi  35 10

前两个参数传入了两个文件名，分别代表原始参考视频和测试视频。这里使用了相对地址，这也代表着系统会从软件的工作目录下的video子目录里寻找文件。然后程序将针对这些参数开始进行相似性检查

.. code-block:: cpp

   const string sourceReference = argv[1],sourceCompareWith = argv[2];

   VideoCapture captRefrnc(sourceReference);
   // 或者
   VideoCapture captUndTst;
   captUndTst.open(sourceCompareWith);

你可以用 :huivideo:`isOpened <video-isopened>` 函数来检查视频是否成功打开与否:

.. code-block:: cpp

   if ( !captRefrnc.isOpened())
     {
     cout  << "Could not open reference " << sourceReference << endl;
     return -1;
     }

当析构函数调用时，会自动关闭视频。如果你希望提前关闭的话，你可以调用 :huivideo:`release <videocapture-release>` 函数. 视频的每一帧都是一幅普通的图像。因为我们仅仅需要从 :huivideo:`VideoCapture <videocapture>` 对象里释放出每一帧图像并保存成 *Mat* 格式。因为视频流是连续的，所以你需要在每次调用 :huivideo:`read <videocapture-read>` 函数后及时保存图像或者直接使用重载的>>操作符。

.. code-block:: cpp

   Mat frameReference, frameUnderTest;
   captRefrnc >> frameReference;
   captUndTst.open(frameUnderTest);

如果视频帧无法捕获（例如当视频关闭或者完结的时候），上面的操作就会返回一个空的 *Mat* 对象。我们可以用下面的代码检查是否返回了空的图像：

.. code-block:: cpp

   if( frameReference.empty()  || frameUnderTest.empty())
   {
    // 退出程序
   }

读取视频帧的时候也会自动进行解码操作。你可以通过调用 :huivideo:`grab <videocapture-grab>` 和 :huivideo:`retrieve <videocapture-retrieve>` 函数来显示地进行这两项操作。 

视频通常拥有很多除了视频帧图像以外的信息，像是帧数之类，有些时候数据较短，有些时候用4个字节的字符串来表示。所以 :huivideo:`get <videocapture-get>` 函数返回一个double（8个字节）类型的数据来表示这些属性。然后你可以使用位操作符来操作这个返回值从而得到想要的整型数据等。这个函数有一个参数，代表着试图查询的属性ID。在下面的例子里我们会先获得食品的尺寸和帧数。

.. code-block:: cpp

   Size refS = Size((int) captRefrnc.get(CV_CAP_PROP_FRAME_WIDTH),
                    (int) captRefrnc.get(CV_CAP_PROP_FRAME_HEIGHT)),

   cout << "参考帧的分辨率: 宽度=" << refS.width << "  高度=" << refS.height
        << " of nr#: " << 
		<< endl;

当你需要设置这些值的时候你可以调用 :huivideo:`set <videocapture-set>` 函数。函数的第一个参数是需要设置的属性ID，第二个参数是需要设定的值，如果返回true的话就表示成功设定，否则就是false。接下来的这个例子很好地展示了如何设置视频的时间位置或者帧数：

.. code-block:: cpp

   captRefrnc.set(CV_CAP_PROP_POS_MSEC, 1.2);  // 跳转到视频1.2秒的位置
   captRefrnc.set(CV_CAP_PROP_POS_FRAMES, 10); // 跳转到视频的第10帧
   // 然后重新调用read来得到你刚刚设置的那一帧

你可以参考 :huivideo:`get <videocapture-get>` 和 :huivideo:`set <videocapture-set>` 函数的文档来得到更多信息。


图像比较 - PSNR and SSIM
================================

当我们想检查压缩视频带来的细微差异的时候，就需要构建一个能够逐帧比较差视频差异的系统。最常用的比较算法是PSNR( **Peak signal-to-noise ratio**)。这是个使用“局部均值误差”来判断差异的最简单的方法，假设有这两幅图像：I1和I2，它们的行列数分别是i，j，有c个通道。

.. math::

   MSE = \frac{1}{c*i*j} \sum{(I_1-I_2)^2}

PSNR公式如下:

.. math::

   PSNR = 10 \cdot \log_{10} \left( \frac{MAX_I^2}{MSE} \right)

每个像素的每个通道的值占用一个字节，值域[0,255]。这里每个像素会有 :math:`MAX_I^2` 个有效的最大值 注意当两幅图像的相同的话，MSE的值会变成0。这样会导致PSNR的公式会除以0而变得没有意义。所以我们需要单独的处理这样的特殊情况。此外由于像素的动态范围很广，在处理时会使用对数变换来缩小范围。这些变换的C++代码如下: 

.. code-block:: cpp

   double getPSNR(const Mat& I1, const Mat& I2)
   {
    Mat s1;
    absdiff(I1, I2, s1);       // |I1 - I2|
    s1.convertTo(s1, CV_32F);  // 不能在8位矩阵上做平方运算
    s1 = s1.mul(s1);           // |I1 - I2|^2

    Scalar s = sum(s1);         // 叠加每个通道的元素

    double sse = s.val[0] + s.val[1] + s.val[2]; // 叠加所有通道

    if( sse <= 1e-10) // 如果值太小就直接等于0
        return 0;
    else
    {
        double  mse =sse /(double)(I1.channels() * I1.total());
        double psnr = 10.0*log10((255*255)/mse);
        return psnr;
    }
   }

在考察压缩后的视频时，这个值大约在30到50之间，数字越大则表明压缩质量越好。如果图像差异很明显，就可能会得到15甚至更低的值。PSNR算法简单，检查的速度也很快。但是其呈现的差异值有时候和人的主观感受不成比例。所以有另外一种称作 **结构相似性** 的算法做出了这方面的改进。 

建议你阅读一些关于SSIM算法的文献来更好的理解算法，然而及时你直接看下面的源代码，应该也能建立一个不错的映像。

.. seealso::

   请参考下面深度解析SSIM的文章："Z. Wang, A. C. Bovik, H. R. Sheikh and E. P. Simoncelli, "Image quality assessment: From error visibility to structural similarity," IEEE Transactions on Image Processing, vol. 13, no. 4, pp. 600-612, Apr. 2004." 

.. code-block:: cpp

   Scalar getMSSIM( const Mat& i1, const Mat& i2)
   {
    const double C1 = 6.5025, C2 = 58.5225;
    /***************************** INITS **********************************/
    int d     = CV_32F;

    Mat I1, I2;
    i1.convertTo(I1, d);           // 不能在单字节像素上进行计算，范围不够。
    i2.convertTo(I2, d);

    Mat I2_2   = I2.mul(I2);        // I2^2
    Mat I1_2   = I1.mul(I1);        // I1^2
    Mat I1_I2  = I1.mul(I2);        // I1 * I2

    /***********************初步计算 ******************************/

    Mat mu1, mu2;   // 
    GaussianBlur(I1, mu1, Size(11, 11), 1.5);
    GaussianBlur(I2, mu2, Size(11, 11), 1.5);

    Mat mu1_2   =   mu1.mul(mu1);
    Mat mu2_2   =   mu2.mul(mu2);
    Mat mu1_mu2 =   mu1.mul(mu2);

    Mat sigma1_2, sigma2_2, sigma12;

    GaussianBlur(I1_2, sigma1_2, Size(11, 11), 1.5);
    sigma1_2 -= mu1_2;

    GaussianBlur(I2_2, sigma2_2, Size(11, 11), 1.5);
    sigma2_2 -= mu2_2;

    GaussianBlur(I1_I2, sigma12, Size(11, 11), 1.5);
    sigma12 -= mu1_mu2;

    ///////////////////////////////// 公式 ////////////////////////////////
    Mat t1, t2, t3;

    t1 = 2 * mu1_mu2 + C1;
    t2 = 2 * sigma12 + C2;
    t3 = t1.mul(t2);              // t3 = ((2*mu1_mu2 + C1).*(2*sigma12 + C2))

    t1 = mu1_2 + mu2_2 + C1;
    t2 = sigma1_2 + sigma2_2 + C2;
    t1 = t1.mul(t2);               // t1 =((mu1_2 + mu2_2 + C1).*(sigma1_2 + sigma2_2 + C2))

    Mat ssim_map;
    divide(t3, t1, ssim_map);      // ssim_map =  t3./t1;

    Scalar mssim = mean( ssim_map ); // mssim = ssim_map的平均值
    return mssim;
   }

这个操作会针对图像的每个通道返回一个相似度，取值范围应该在0到1之间，取值为1时代表完全符合。然而尽管SSIM能产生更优秀的数据，但是由于高斯模糊很花时间，所以在一个实时系统（每秒24帧）中，人们还是更多地采用PSNR算法。

正是这个原因，最开始的源码里，我们用PSNR算法去计算每一帧图像，而仅当PSNR算法计算出的结果低于输入值的时候，用SSIM算法去验证。为了展示数据，我们在例程里用两个窗口显示了原图像和测试图像并且在控制台上输出了PSNR和SSIM数据。就像下面显示的那样:

.. image:: images/outputVideoInput.png
   :alt: A sample output
   :align: center

如果你会翻墙，就可以在天朝河蟹掉的 `YouTube <https://www.youtube.com/watch?v=iOcNljutOgg>`_ 上观看操作视频. 

.. raw:: html

  <div align="center">
  <iframe title="Video Input with OpenCV (Plus PSNR and MSSIM)" width="560" height="349" src="http://www.youtube.com/embed/iOcNljutOgg?rel=0&loop=1" frameborder="0" allowfullscreen align="middle"></iframe>
  </div>

翻译者
=================
nahcooo@ `OpenCV中文网站 <http://www.opencv.org.cn>`_ <nahcooo@gmail.com>