opencv（c++）文件输入和输出使用XML和YAML文件

参考：
1、https://docs.opencv.org/3.2.0/
2、https://github.com/opencv/opencv/

---

File Input and Output using XML and YAML files

你会找到以下问题的答案：

• 如何使用YAML或XML文件打印和读取文本和OpenCV文件？
• 如何为OpenCV数据结构做同样的事情？
• 如何为你的数据结构做到这一点？
• 使用OpenCV数据结构，如cv :: FileStorage，cv :: FileNode或cv ::
  FileNodeIterator。

---

源代码

您可以从这里下载，或者在OpenCV源代码库的samples / cpp / tutorial_code / core / file_input_output / file_input_output.cpp中找到它。

以下是如何实现目标列表中枚举的所有东西的示例代码。

#include <opencv2/core.hpp>#include <iostream>#include <string>using namespace cv;using namespace std;static void help(char** av){    cout << endl        << av[0] << " shows the usage of the OpenCV serialization functionality."         << endl        << "usage: "                                                                      << endl        <<  av[0] << " outputfile.yml.gz"                                                 << endl        << "The output file may be either XML (xml) or YAML (yml/yaml). You can even compress it by "        << "specifying this in its extension like xml.gz yaml.gz etc... "                  << endl        << "With FileStorage you can serialize objects in OpenCV by using the << and >> operators" << endl        << "For example: - create a class and have it serialized"                         << endl        << "             - use it to read and write matrices."                            << endl;}class MyData{public:    MyData() : A(0), X(0), id()    {}    explicit MyData(int) : A(97), X(CV_PI), id("mydata1234") // explicit to avoid implicit conversion    {}    void write(FileStorage& fs) const                        //Write serialization for this class    {        fs << "{" << "A" << A << "X" << X << "id" << id << "}";    }    void read(const FileNode& node)                          //Read serialization for this class    {        A = (int)node["A"];        X = (double)node["X"];        id = (string)node["id"];    }public:   // Data Members    int A;    double X;    string id;};//These write and read functions must be defined for the serialization in FileStorage to workstatic void write(FileStorage& fs, const std::string&, const MyData& x){    x.write(fs);}static void read(const FileNode& node, MyData& x, const MyData& default_value = MyData()){    if(node.empty())        x = default_value;    else        x.read(node);}// This function will print our custom class to the consolestatic ostream& operator<<(ostream& out, const MyData& m){    out << "{ id = " << m.id << ", ";    out << "X = " << m.X << ", ";    out << "A = " << m.A << "}";    return out;}int main(int ac, char** av){    if (ac != 2)    {        help(av);        return 1;    }    string filename = av[1];    { //write        Mat R = Mat_<uchar>::eye(3, 3),            T = Mat_<double>::zeros(3, 1);        MyData m(1);        FileStorage fs(filename, FileStorage::WRITE);        fs << "iterationNr" << 100;        fs << "strings" << "[";                              // text - string sequence        fs << "image1.jpg" << "Awesomeness" << "../data/baboon.jpg";        fs << "]";                                           // close sequence        fs << "Mapping";                              // text - mapping        fs << "{" << "One" << 1;        fs <<        "Two" << 2 << "}";        fs << "R" << R;                                      // cv::Mat        fs << "T" << T;        fs << "MyData" << m;                                // your own data structures        fs.release();                                       // explicit close        cout << "Write Done." << endl;    }    {//read        cout << endl << "Reading: " << endl;        FileStorage fs;        fs.open(filename, FileStorage::READ);        int itNr;        //fs["iterationNr"] >> itNr;        itNr = (int) fs["iterationNr"];        cout << itNr;        if (!fs.isOpened())        {            cerr << "Failed to open " << filename << endl;            help(av);            return 1;        }        FileNode n = fs["strings"];                         // Read string sequence - Get node        if (n.type() != FileNode::SEQ)        {            cerr << "strings is not a sequence! FAIL" << endl;            return 1;        }        FileNodeIterator it = n.begin(), it_end = n.end(); // Go through the node        for (; it != it_end; ++it)            cout << (string)*it << endl;        n = fs["Mapping"];                                // Read mappings from a sequence        cout << "Two  " << (int)(n["Two"]) << "; ";        cout << "One  " << (int)(n["One"]) << endl << endl;        MyData m;        Mat R, T;        fs["R"] >> R;                                      // Read cv::Mat        fs["T"] >> T;        fs["MyData"] >> m;                                 // Read your own structure_        cout << endl            << "R = " << R << endl;        cout << "T = " << T << endl << endl;        cout << "MyData = " << endl << m << endl << endl;        //Show default behavior for non existing nodes        cout << "Attempt to read NonExisting (should initialize the data structure with its default).";        fs["NonExisting"] >> m;        cout << endl << "NonExisting = " << endl << m << endl;    }    cout << endl        << "Tip: Open up " << filename << " with a text editor to see the serialized data." << endl;    return 0;}

说明

这里我们只讨论关于XML和YAML文件的输入。 您的输出（及其各自的输入）文件可能只有这些扩展名之一和来自此的结构。 它们是可以序列化的两种数据结构：映射（如STL映射）和元素序列（如STL向量）。 它们之间的区别在于，在地图中，每个元素都有一个唯一的名字，通过你可以访问它的东西。 对于序列，您需要通过它们来查询特定项目。

1、XML / YAML文件打开和关闭。 在你写这些文件的任何内容之前，你需要打开它，最后关闭它。 OpenCV中的XML / YAML数据结构是cv :: FileStorage。 要指定文件绑定到硬盘上的这个结构，你可以使用它的构造函数或open（）函数：

string filename = "I.xml";FileStorage fs(filename, FileStorage::WRITE);//...fs.open(filename, FileStorage::READ);

你使用第二个参数中的任何一个是一个常数，指定你可以在其上执行的操作的类型：WRITE，READ或APPEND。 文件名中指定的扩展名也决定了将要使用的输出格式。 如果指定* .xml.gz *之类的扩展名，输出可能会被压缩。

该文件在cv :: FileStorage对象被销毁时自动关闭。 但是，您可以通过释放函数明确地调用它：

fs.release();                                       // explicit close

2、输入和输出文本和数字。 数据结构使用与STL库相同的<<输出运算符。 为了输出任何类型的数据结构，我们首先需要指定它的名字。 我们只需打印出这个名字就可以了。 对于基本类型，您可以按照以下值打印：

fs << "iterationNr" << 100;

读入是一个简单的寻址（通过[]运算符）和铸造操作或通过>>操作符读取：

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

3、OpenCV数据结构的输入/输出。 那么这些行为就像基本的C ++类型一样：

Mat R = Mat_<uchar >::eye  (3, 3),    T = Mat_<double>::zeros(3, 1);fs << "R" << R;                                      // Write cv::Matfs << "T" << T;fs["R"] >> R;                                      // Read cv::Matfs["T"] >> T;

4、向量（数组）和关联映射的输入/输出。 正如我之前提到的，我们也可以输出地图和序列（数组，矢量）。 再次，我们首先打印变量的名称，然后我们必须指定我们的输出是序列还是映射。

对于第一个元素之前的序列，打印“[”字符，在最后一个之后打印“]”字符：

fs << "strings" << "[";                              // text - string sequencefs << "image1.jpg" << "Awesomeness" << "baboon.jpg";fs << "]";                                           // close sequence

对于地图演练是相同的，但现在我们使用“{”和“}”分隔符：

fs << "Mapping";                              // text - mappingfs << "{" << "One" << 1;fs <<        "Two" << 2 << "}";

为了读取这些，我们使用cv :: FileNode和cv :: FileNodeIterator数据结构。 cv :: FileStorage类的[]运算符返回一个cv :: FileNode数据类型。 如果节点是顺序的，我们可以使用cv :: FileNodeIterator迭代项目：

FileNode n = fs["strings"];                         // Read string sequence - Get nodeif (n.type() != FileNode::SEQ){    cerr << "strings is not a sequence! FAIL" << endl;    return 1;}FileNodeIterator it = n.begin(), it_end = n.end(); // Go through the nodefor (; it != it_end; ++it)    cout << (string)*it << endl;

对于maps，您可以再次使用[]运算符来访问给定的项目（或者>>运算符）：

n = fs["Mapping"];                                // Read mappings from a sequencecout << "Two  " << (int)(n["Two"]) << "; ";cout << "One  " << (int)(n["One"]) << endl << endl;

6、读写你自己的数据结构。 假设你有一个数据结构如：

class MyData{public:      MyData() : A(0), X(0), id() {}public:   // Data Members   int A;   double X;   string id;};

可以通过在OpenCV I / O XML / YAML接口（如OpenCV数据结构的情况下）通过在类的内部和外部添加读取和写入功能来对其进行序列化。 对于内部部分：

void write(FileStorage& fs) const                        //Write serialization for this class{  fs << "{" << "A" << A << "X" << X << "id" << id << "}";}void read(const FileNode& node)                          //Read serialization for this class{  A = (int)node["A"];  X = (double)node["X"];  id = (string)node["id"];}

那么你需要在类之外添加下面的函数定义：

void write(FileStorage& fs, const std::string&, const MyData& x){x.write(fs);}void read(const FileNode& node, MyData& x, const MyData& default_value = MyData()){if(node.empty())    x = default_value;else    x.read(node);}

在这里你可以观察到，在read 部分，我们定义了如果用户试图读取一个不存在的节点会发生什么。 在这种情况下，我们只是返回默认的初始化值，但是更详细的解决方案是为对象ID返回一个负值。

一旦添加了这四个函数，使用>>操作符进行写操作，使用<<操作符进行读操作：

MyData m(1);fs << "MyData" << m;                                // your own data structuresfs["MyData"] >> m;                                 // Read your own structure_

或者尝试阅读non-existing read：

fs["NonExisting"] >> m;   // Do not add a fs << "NonExisting" << m command for this to workcout << endl << "NonExisting = " << endl << m << endl;