OpenCV中的Core组件——输入输出XML, YAML(12)

输入输出XML和YAML文件

1.1 XML和YAML文件
XML是一种元标记语言，所谓元标记就是可自定义标记< name> < book>.任何满足XML命名规则的都可以进行定义。XML是一种语义/结构化语言，它描述了文档的结果和语义；
YAML仍是一种标识语言，但这个不是以标识语言为重点，以数据为中心。YAML是一种可读性高，用来表达资料序列的格式。它参考了其他的语言如：XML，C，Python,Perl等。
YAML用了一种比XML更简洁的方式来完成XML的任务。
1.2 FileStorage类操作文件的使用引导
XML和YAML是非常广泛的文件格式，可以利用XML和YAML格式的文件存储和还原各式各样的数据结构。
通常通过如下步骤来读取或写入数据到XML或YAML文件

• 实例化一个FileStorage类的对象，用默认待参数的构造函数来初始化，或用类的成员函数open()将其 初始化。
• 使用流操作符<< >>对文件进行写入或读取操作。
• 使用FileStorage::release()函数析构FileStorage对象，同时关闭文件。

实例来分析这三个步骤：

【第一步】XML，YAML文件的打开

（1）准备文件写操作
FileStorage是XML和YAML的文件存储类，是OpenCV中从文件中读取或向文件中写入数据时必须要使用的一个类。
构造函数有两个重载.

FileStorage::FileStorage();
FileStorage::FileStorage(const string& source, int flags, const string& encoding=string());

1. 对于第一种不带参数的构造函数，可以使用成员函数open来进行数据的写操作

FileStorage fs;
fs.open("abc.xml/yaml", FileStorage::WRITE);

2. 对于第二种带参数的构造函数

FileStorage fs("abc.xml/yaml", FileStorage::WRITE);

（2）准备文件读操作
读操作，使用FileStorage::READ标识符

1. 第一种方式

FileStorage fs("abc.xml/yaml", FileStorage::READ);

2. 第二种方式
   FileStorage fs;
   fs.open(“abc.xml”, FileStorage::READ);

【第二步】进行文件读写操作

（1）文本和数字的输入和输出
定义好FileStorage类对象后，写入文件可以用<< 运算符。如fs << "iterationN" << 100;
而对于读文件可以使用>> 运算符。如：

int itNr;
fs["iterationN"] >> itNr;
itNr = (int) fs["iterationN"];

（2）OpenCV数据结构的输入和输出

//数据结构初始化
Mat R = Mat_<uchar>::eye(3, 3),
Mat T = Mat_<double>::zeros(3, 3);
//向Mat中写入数据
fs << "R" << R;
fs << "T" << T;

//从Mat中读取数据
fs["R"] >> R;
fs["T"] >> T;

【第三步】vector(arrays)和maps的输入和输出

对于vector结构的输入和输出，需要在第一个加[ ,最后一个元素加上]符号。

fs << "strings" << "[";  //string文本序列开始
fs << "image1.jpg" << "Awesomeness" << "baboon.jpg";
fs << "]";  //关闭序列

对于map结构的操作，使用的符号是“{" 和 “}”

fs << "Mapping";  //开始读入map文本；
fs << "{" << "One" << 1;
fs << "Two" << 2 << "}";

读取这个些结构的时候，会用到FileNode 和 FileNodeIterator数据结构。对FileStorage类的“[" "]"操作符会返回iFileNode 类型的数据，对于一连串的node,可以使用FIelNodeIterator结构

FileNode n = fs["string"];   //读取字符串序列得到节点
if(n.type()!= FileNode::SEQ)
{
	cerr << "发生错误，字符串不是一个序列" << endl;
	return 1;
}
FileNodeIterator it = n.begin(), it_end = n.end();  //遍历节点 
for(; it != it_end; ++it)
	cout<< (string) *it << endl;

【第四步】关闭文件

文件关闭操作会在FileStorage类销毁时自动进行，但我们也可显示调用析构函数relesse()来实现，同会析构掉FileStorage对象同时关闭文件。
fs.release()

实例XML(YAML,doc,txt)文件的写入

#include <opencv2/opencv.hpp>
#include<opencv2/core/core.hpp>
#include <time.h>

using namespace cv;
int main()
{
    //初始化
    FileStorage fs("test.yaml", FileStorage::WRITE);

    //开始写文件
    fs << "frameCount" << 5;
    time_t rawtime; 
    time(&rawtime);
    Mat cameraMatrix = (Mat_<double>(3, 3) << 1000, 0, 320, 0, 1000, 240, 0, 0, 1);
    Mat distCoeffs = (Mat_<double>(5, 1) << 0.1 , 0.001, -0.001, 0, 0);
    fs << "cameraMatrix" << cameraMatrix << "distCoeffs" << distCoeffs;
    fs << "features" << "[";
    for(int i = 0; i < 3; i++) {
        int x = rand() % 640;
        int y = rand() % 480;
        uchar libp = rand() % 256;

        fs << "{:" << "x" << x << "y" << y << "libp" << "[:";
        for(int j = 0; j < 8; j++) 
            fs << ((libp >> j) & i);
        fs << "]" << "}"; 
    }
    fs << "]";
    fs.release();
    printf("文件写完毕，查看生成文件～");
    getchar();
    return 0;
}

实例XML(YAML)文件的读取
需要把对应的yaml文件放到工程目录下。

#include <opencv2/opencv.hpp>
#include <time.h>

using namespace std;
using namespace cv;

int main()
{
    //system("color 6F");
    //初始化
    FileStorage fs2("../test.yaml", FileStorage::READ);

    //方法一：对FileNode操作
    int frameCount = (int) fs2["frameCount"];

    std::string date;
    //方法二：使用FileNode运算符 >>
    fs2["calibrationDate"] >> date;
    Mat cameraMatrix, distCoeffs;
    fs2["cameraMatrix"] >> cameraMatrix;
    fs2["distCoeffs"] >> distCoeffs;
    cout << "frameCount:" << frameCount << endl
            << "calibration date:" << date << endl
            <<"distortion coeffs:" << distCoeffs << endl
            <<"camera Matrix:" << cameraMatrix << endl;
    
    FileNode features = fs2["features"];
    FileNodeIterator it = features.begin(), it_end = features.end();
    int idx = 0;
    std::vector<uchar> lbpval;

    //使用FileNodeIterator遍历序列
    for(; it != it_end; ++it, idx++)
    {
        cout << "feature #" << idx << ":" ;
        cout << "x= " << (int)(*it)["x"] << ", y=" << (int)(*it)["y"] << ", libp: (";
        (*it)["libp"] >> lbpval;
        for(int i =0; i< (int)lbpval.size(); i++)
            cout << "" << (int)lbpval[i] << "\t";
        cout << ")" << endl;
    }
    fs2.release();

    printf("完毕");
    getchar();
    return 0;
}

运行结果：