32_OpenCV中的数据存储 cv::FileStorage

OpenCV提供一种序列话与反序列化的机制，用于将不同数据类型的数据以YAML和XML格式写入磁盘或者从磁盘读取。这种方法可以加载或保存任何OpenCV的数值变量（包括基本数据变量，像int和float等）到一个文件中。这种文件读写的基本机制是通过cv::FileStorage对象实现的。

cv::FileStorage的构造函数：

cv::FileStorage::FileStorage();
cv::FileStorage::FileStorage(string filename, int flag);
cv::FileStorage::open(string file int flag);

cv::FileStorage对象代表着一个XML或者YAML格式的数据文件。可以使用默认构造函数创建一个未打开的cv::FileStorage对象，稍后再使用cv::FileStorage::open()函数打开，也可以给定文件名参数创建一个cv::FileStorage对象，flag的参数可以为cv::FileStorage::WRITE、cv::FileStorage::READ或者cv::FileStorage::APPEND。

成功打开文件后，可以使用cv::FileStorage::operator<<()进行写入操作。

1. 写文件

cv::FileStorage内部数据的存储主要有两种形式。“mapping”（键/值对）和"sequence"(一系列未命名的条目）。如果是要创建一个序列条目，需要提供一个string类型的名字，接下来才是序列数据。

如果像创建一个新的mapping或者sequence，可以使用特殊符号{（用于mapping）或者[（用于sequence），创建后，可以为其添加元素，最终以}或]分别结束一个mapping或者sequence。

完成创建一个mapping，需要按顺序输入条目名以及对应的值。
完成创建一个sequence，只需要一个接一个地输入元素即可。

2. 读取文件

当读取文件时，flag的参数为cv::FileStorage::READ。读取文件时需要确定要访问的数据名，即FileStorage最顶层的mapping中的关键字，可以通过重载操作符cv::FileStorage::operator>>获取，该操作符返回的是一个FileNode对象。

如果该值是基本数据类型，可以通过强制转换直接获取；如果该数据是一个mapping对象，可以通过重载操作符[]，并给定所需关键字访问；如果该数据为sequence对象，可以通过重载操作符[]和一个整型参数访问其中数据，也可以通过cv::FileNodeIterator迭代器进行访问。

注意，读取结束后，需要调用cv::FileStorage::release()关闭文件。

使用参考：

void Write_XML(){
	cv::FileStorage fs("test.yml", cv::FileStorage::WRITE);
	fs << "frameCount" << 5;
	time_t rawTime;
	time(&rawTime);
	fs << "calibrationDate" << asctime(localtime(&rawTime));

	cv::Mat cameraMaterix = (cv::Mat_<double>(3, 3) << 1000, 0, 320, 0, 1000, 240, 0, 0, 1);
	cv::Mat distCoeffs = (
		cv::Mat_<double>(5, 1)
		<< 0.1, 0.01, -0.001, 0, 0
		);
	fs << "cameraMatrix" << cameraMaterix << "distCoeffs" << distCoeffs;

	fs << "features" << "[";
	for (int i = 0; i < 3; i++){
		int x = rand() % 640;
		int y = rand() % 480;
		uchar lbp = rand() % 256;
		fs << "{:" << "x" << x << "y" << y << "lbp" << "[:";
		for (int j = 0; j < 8; j++){
			fs << ((lbp >> j) & 1);
		}
		fs << "]" << "}";
	}
	fs << "]";
	fs.release();
}

void Read_XML(){
	cv::FileStorage fs("test.yml", cv::FileStorage::READ);
	
	// 直接进行数据转换
	int frameCount = (int)fs["frameCount"];

	// 使用操作符 >> 转换
	std::string date;
	fs["calibrationDate"] >> date;
	cv::Mat cameraMatrix, distCoeffs;
	fs["cameraMatrix"] >> cameraMatrix;
	fs["distCoeffs"] >> distCoeffs;

	std::cout << "frameCount:" << frameCount << std::endl
		<< "calibration date:" << date << std::endl
		<< "camera matrix:	" << cameraMatrix << std::endl
		<< "distortion coeffs: " << distCoeffs << std::endl;

	cv::FileNode features = fs["features"];
	cv::FileNodeIterator it = features.begin(), it_end = features.end();
	int idx = 0;
	std::vector<uchar> lbpval;
	 // 遍历一个sequence
	for (; it != it_end; ++it, idx++){
		std::cout << "feature #" << idx << ":";
		std::cout << "x=" << (int)(*it)["x"]
			<< ", y=" << (int)(*it)["y"]
			<< ", lbp:(";
		// 使用cv::FileNode >> std::vector读取数组
		(*it)["lbp"] >> lbpval;
		for (int i = 0; i < (int)lbpval.size(); i++){
			std::cout << " " << (int)lbpval[i];
		}
		std::cout << ")" << std::endl;
	}
	fs.release();
}

生成的yml文件内容：

 读出的内容：