时间:2022-10-23 11:16:46 | 栏目:C代码 | 点击:次
本节我们将认识XML和YAML这两种文件类型。
所谓XML,即eXtensible Markup Language,翻译成中文为“可扩展标识语言”。首先,XML是一种元标记语言。所谓元标记,就是开发者可以根据自身需要定义自己的标记,比如可以定义标记<book>、<name>。任何满足XML命名规则的名称都可以标记,这就向不同的应用程序打开了的大门。此外,XML是一种语义、结构化语言,它描述了文档的结构与语义。
YAML是YAML Ain’t a Markup Language(YAML不是一种置标语言)的缩写。YAML是一个可读性高,用来表达资料序列的格式。它参考了其他多种语言,包括:XML、C语言、Python、Perl以及电子邮件格式RFC2822。
XML和YAML是使用非常广泛的文件格式。可以利用XML或者YAML格式的文件存储和还原各式各样的数据结构。当然,它们还可以存储和载入任意复杂的数据结构,其中就包括了OpenCV相关周边的数据结构,以及各种原始数据类型,如整数、浮点数和文本字符串。
我们一般使用如下过程来写入或者读取数据到XML或YAML文件中。
(1)实例化一个FileStorage类的对象,用默认带参数的构造函数完成初始化,或者用FileStorage::open()成员函数辅助初始化。
(2)使用流操作符<<进行文件写入操作,或者>>进行文件读取操作,类似C++中的文件输入输出流。
(3)使用FileStorage::release()函数析构掉FileStorage类对象,同时关闭文件。
(1)准备文件写操作
FileStorage是OpenCV中XML和YAML文件的存储类,封装了所有相关的信息。它是OpenCV从文件中读数据或向文件中写数据时必须要使用的一个类。
此类的构造函数为FileStorage::FileStorage,有两个重载,如下:
C++:FileStorage::FileStorage() C++:FileStorage::FileStorage(const string& source, int flags, const string& encoding=string())
构造函数在实际使用中,一般有两种方法。
1)对于第二种带参数的构造函数,进行写操作范例如下:
FileStorage fs("abc.xml", FileStorage::WRITE);
2)对于第一种不带参数的构造函数,可以使用其成员函数FileStorage::open进行数据的写操作,范例如下:
FileStorage fs; fs.open("abc.xml",FileStorage::WRITE);
(2)准备文件读操作
上面讲到的都是以FileStorage::WRITE为标识符的写操作,而读操作,采用FileStorage::READ标识符即可,相关示例代码如下:
1)第一种方式
FileStorage fs(“abc.xml”, FileStorage::READ);
2)第二种方式
FileStorage fs; fs.open(“abc.xml”, FileStorage::READ);
另外需要注意的是,上面的这些操作示例是对XML文件为例子作演示的,而对YAML文件,操作方法是类似的,就是将XML文件换为YAML文件即可。
(1)文本和数字的输入和输出
定义好FileStorage类对象之后,写入文件可以使用<<运算符,例如:
fs<<"iterationNr"<<100;
而读取文件,使用>>运算符,例如:
int itNr; fs["iterationNr"]>>itNr; itNr = (int) fs["iterationNr"];
(2)OpenCV数据结构的输入和输出
关于OpenCV数据结构的输入和输出,和基本的C++形式相同,范例如下:
// 数据结构的初始化 Mat R = Mat_<uchar>::eye(3,3); Mat T = Mat_<double>::zeros(3, 1); // 向Mat中写入数据 fs << "R" << R; fs << "T" << T; // 从Mat中读取数据 fs["R"] >> R; fs["T"] >> T;
对于vector结构的输出和输出,要注意在第一个元素前加上”[“,在最后一个元素后加上”]“。例如:
fs << "strings"<<"["; //开始读入string文本序列 fs << "image1.jpg" << "Awesomeness" << "baboon.jpg"; fs << "]"; //关闭序列
而对于map结构的操作,使用的符号是”{“和”}“,例如:
fs << "Mapping";//开始读入Mapping文本 fs << "{" << "One" << 1; fs << "Two" << 2 << "}";
读取这些数据结构的时候,会用到FileNode和FileNodeIterator数据结构。对FileStorage类的“[”、“]”操作符会返回FileNode数据类型;对于一连串的node,可以使用FileNodeIterator结构,例如:
```cpp FileNode n = fs["strings"];//读取字符串序列以得到节点 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类销毁时自动进行,但我们也可以显式调用其析构函数FileStorage::release()实现。FileStorage::release()函数会析构掉FileStorage类对象,同时关闭文件。
调用过程非常简单,如下:fs.release();
#include<opencv2/opencv.hpp> #include<time.h> using namespace cv; int main() { //初始化 FileStorage fs("test.yaml", FileStorage::WRITE); //开始文件写入 fs << "frameCount" << 5; time_t rawtime; time(&rawtime); fs << "calibrationDate" << asctime(localtime(&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.01, -0.001, 0, 0);//畸变参数 fs << "cameraMatrix" << cameraMatrix << "distCoeffs" << distCoeffs;//读取Mat型cameraMatrix,distcoeffs的内容 fs << "feature" << "["; for (int i = 0; i < 3; i++) { int x = rand() % 640; int y = rand() % 480; uchar ibp = rand() % 256; fs << "{:" << "x" << x << "y" << y << "ibp" << "[:"; for (int j = 0; j < 8; j++) fs << ((ibp >> j) & 1); fs << "]" << "}"; } fs << "]"; fs.release(); printf("完毕,请在工程目录下查看文件-"); getchar(); return 0; }
上面的示例将一个整数、一个文本字符串(标定日期)、2 个矩阵和一个自定义结构“feature”存储到 YML,其中包括特征坐标和 LBP(局部二进制模式)值。这是样本的输出:
%YAML:1.0
frameCount: 5
calibrationDate: "Fri Jun 17 14:09:29 2011\n"
cameraMatrix: !!opencv-matrix
rows: 3
cols: 3
dt: d
data: [ 1000., 0., 320., 0., 1000., 240., 0., 0., 1. ]
distCoeffs: !!opencv-matrix
rows: 5
cols: 1
dt: d
data: [ 1.0000000000000001e-01, 1.0000000000000000e-02,
-1.0000000000000000e-03, 0., 0. ]
features:
- { x:167, y:49, lbp:[ 1, 0, 0, 1, 1, 0, 1, 1 ] }
- { x:298, y:130, lbp:[ 0, 0, 0, 1, 0, 0, 1, 1 ] }
- { x:344, y:158, lbp:[ 1, 1, 0, 0, 0, 0, 1, 0 ] }
作为练习,您可以将上面示例中的“.yml”替换为“.xml”或“.json”,然后查看相应的 XML 文件的外观。
通过查看示例代码和输出可以注意到几件事:
#include<opencv2/opencv.hpp> #include<time.h> using namespace cv; using namespace std; int main() { //改变consolo字体颜色 system("color 6F"); //初始化 FileStorage fs2("test.yaml", FileStorage::READ); //开始文件读取 //法一,对FileNode操作 int frameCount2 = (int)fs2["framecount2"]; std::string date;//定义字符串 date //法二,使用FileNode运算符>> fs2["calibrationDate"] >> date; Mat cameraMatrix2, distCoeffs2; fs2["cameraMatrix"] >> cameraMatrix2; fs2["distCoeffs"] >> distCoeffs2;//读取 cout << "frameCount2:" << frameCount2 << endl << "calibration date:" << date << endl << "camera matrix:" << cameraMatrix2 << endl << "distortion coeffs:" << distCoeffs2 << endl; FileNode feature = fs2["feature"]; FileNodeIterator it = feature.begin(), it_end = feature.end();//定义it int idx = 0; std::vector<uchar>ibpval;//定义向量容器ibpal //使用FileNodeIterator历遍序列(读取) for (; it != it_end; it++, idx++) { cout << "feature#" << idx << ":"; cout << "x=" << (int)(*it)["x"] << ",y=" << (int)(*it)["y"] << ",ibp:("; //也可以使用filenod>>std::vector操作符很容易读取数值阵列 (*it)["ibp"] >> ibpval; for (int i = 0; i < (int)ibpval.size(); i++) cout << "" << (int)ibpval[i]; cout << ")" << endl; } fs2.release(); printf("读取完毕,请按任意键结束-"); getchar(); return 0; }
/* * filestorage_sample demonstrate the usage of the opencv serialization functionality */ #include "opencv2/core.hpp" #include <iostream> #include <string> using std::string; using std::cout; using std::endl; using std::cerr; using std::ostream; using namespace cv; static void help(char** av) { cout << "\nfilestorage_sample demonstrate the usage of the opencv serialization functionality.\n" << "usage:\n" << av[0] << " outputfile.yml.gz\n" << "\n outputfile above can have many different extensions, see below." << "\nThis program demonstrates the use of FileStorage for serialization, that is in use << and >> in OpenCV\n" << "For example, how to create a class and have it serialize, but also how to use it to read and write matrices.\n" << "FileStorage allows you to serialize to various formats specified by the file end type." << "\nYou should try using different file extensions.(e.g. yaml yml xml xml.gz yaml.gz etc...)\n" << endl; } struct MyData { MyData() : A(0), X(0), id() { } explicit MyData(int) : A(97), X(CV_PI), id("mydata1234") { } int A; double X; string id; 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"]; } }; //These write and read functions must exist as per the inline functions in operations.hpp static 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); } static 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) { cv::CommandLineParser parser(ac, av, "{@input||}{help h ||}" ); if (parser.has("help")) { help(av); return 0; } string filename = parser.get<string>("@input"); if (filename.empty()) { help(av); return 1; } //write { FileStorage fs(filename, FileStorage::WRITE); cout << "writing images\n"; fs << "images" << "["; fs << "image1.jpg" << "myfi.png" << "baboon.jpg"; cout << "image1.jpg" << " myfi.png" << " baboon.jpg" << endl; fs << "]"; cout << "writing mats\n"; Mat R =Mat_<double>::eye(3, 3),T = Mat_<double>::zeros(3, 1); cout << "R = " << R << "\n"; cout << "T = " << T << "\n"; fs << "R" << R; fs << "T" << T; cout << "writing MyData struct\n"; MyData m(1); fs << "mdata" << m; cout << m << endl; } //read { FileStorage fs(filename, FileStorage::READ); if (!fs.isOpened()) { cerr << "failed to open " << filename << endl; help(av); return 1; } FileNode n = fs["images"]; if (n.type() != FileNode::SEQ) { cerr << "images is not a sequence! FAIL" << endl; return 1; } cout << "reading images\n"; FileNodeIterator it = n.begin(), it_end = n.end(); for (; it != it_end; ++it) { cout << (string)*it << "\n"; } Mat R, T; cout << "reading R and T" << endl; fs["R"] >> R; fs["T"] >> T; cout << "R = " << R << "\n"; cout << "T = " << T << endl; MyData m; fs["mdata"] >> m; cout << "read mdata\n"; cout << m << endl; cout << "attempting to read mdata_b\n"; //Show default behavior for empty matrix fs["mdata_b"] >> m; cout << "read mdata_b\n"; cout << m << endl; } cout << "Try opening " << filename << " to see the serialized data." << endl << endl; //read from string { cout << "Read data from string\n"; string dataString = "%YAML:1.0\n" "mdata:\n" " A: 97\n" " X: 3.1415926535897931e+00\n" " id: mydata1234\n"; MyData m; FileStorage fs(dataString, FileStorage::READ | FileStorage::MEMORY); cout << "attempting to read mdata_b from string\n"; //Show default behavior for empty matrix fs["mdata"] >> m; cout << "read mdata\n"; cout << m << endl; } //write to string { cout << "Write data to string\n"; FileStorage fs(filename, FileStorage::WRITE | FileStorage::MEMORY | FileStorage::FORMAT_YAML); cout << "writing MyData struct\n"; MyData m(1); fs << "mdata" << m; cout << m << endl; string createdString = fs.releaseAndGetString(); cout << "Created string:\n" << createdString << "\n"; } return 0; }