FileStorage类是OpenCV中用来进行文件操作的封装类,可以对XML,YAML,txt甚至doc文件进行读写操作。在使用opencv时经常需要对特征数据等进行保存,这时候通常会选择XML文件或者YAML文件。xml和yaml都是属于标记语言,开发者可以根据自身需要定义标签。同时他们也是一种语义/结构化语言,他们可以描述文档的结构和语义。FileStorage类可以对C++的基础数据类型(int,float,double等)、容器类(vector,maps)、opencv定义的数据结构(Mat,Scalar等)进行读写操作。
FileStorage类的使用流程如下:
(1)实例化一个FileStorage类对象
(2)使用流操作符<<进行文件写入,>>进行文件读取,类似C++中的文件操作
(3)使用FileStorage::release()函数析构掉类对象,并关闭文件
给出具体实例:
参考:
fs<<"strings:"如果多加了个冒号则会报错:
OpenCV Error: Bad argument (Key name may only contain alphanumeric characters [a-zA-Z0-9]
fs<<"[";代表向量vector的开始,后续输入则是向量容器中具体数据
fs<<"]";表示之前的vector输入结束.
FileStorage
类能够读写硬盘中的.xml
和.yaml
文件,这里我们只讨论对 .xml
- 写入(
FileStorage::WRITE
- ,覆盖写)
- 追加(
FileStorage::APPEND
- ,追加写)
- 读取(
FileStorage::WRITE
- )
FileStorage
以 FileNode
为单位存储数据,且无法删改某个已有 FileNode
的内容,想实现删改功能,得自己造轮子……
写入FileNode
FileNode
有两种类型,
seq
和
map
:
FileStorage fs("data.xml", FileStorage::WRITE);
// seq_node 是一个 seq 型的节点, 以它为父节点,存入10个数据
fs << "seq_node" << "[";
for(size_t i = 0; i < 10; ++i){
fs << i;
}
fs << "]";
// map_node 是一个 map 型节点, 以它为父节点,存入10个数据
fs << "map_node" << "{";
for(size_t i = 0; i < 10; ++i){
fs << "node_" + to_string(i) << i;
}
fs << "}";
fs.release();
seq
和 map
这两种类型的节点,在写入数据时的差别:前者在子节点间,写入一对方括号[]
, 而后者写入花括号{}
;前者在写入子节点的时候,无法为子节点命名,而后者可以。OpenCV 最重要的 Mat
类型在存储时是以 map
读入FileNode
seq
和 map
FileStorage fs("data.xml", FileStorage::READ);
vector<int> a, b;
// seq_node 是一个 seq 型的节点
FileNode seq_node = fs["seq_node"];
for(size_t i = 0; i < 10; ++i){
seq_node[i] >> a[i];
}
// map_node 是一个 map 型节点
FileNode map_node = fs["map_node"];
for(size_t i = 0; i < 10; ++i){
fs["node_" + to_string(i)] >> b[i];
}
fs.release();
seq
型节点既然能以索引去取子节点,那自然有人会想到,能不能用迭代器去访问子节点呢?答案是可以。OpenCV为我们提供了FileNode的迭代器:
// seq_node 是一个 seq 型的节点
FileNode seq_node = fs["seq_node"];
FileNodeIterator it = seq_node.begin();
for(; it != seq_node.end(); ++it){
*it >> a[i];
}
自定义类型的读写
write
和 read
struct MyData{
int i;
string str;
Mat I;
}
// 自定义写入
static void write(FileStorage &fs, const string &, const MyData &mydata){
fs << "{"
<< "index" << mydata.i
<< "str" << mydata.str
<< "img" << mydata.I
<< "}"
}
// 自定义读取
static void read(const FileNode &node, MyData &mydata, const MyData &default_val = MyData()){
if(node.empty()) mydata = default_val;
else {
node["index"] >> mydata.i;
node["str"] >> mydata.str;
node["img"] >> mydata.I;
}
}