【OpenMesh】文件读取和写入

原文出处：http://openmesh.org/Documentation/OpenMesh-Doc-Latest/mesh_io.html

这一节讲的是从文件中读取网格数据和写入网格数据到文件的方法。

响应的函数定义在名字空间OpenMesh::MeshIO中。这一节分成三部分。第一步给出例子讲述如何使用IOManager，第二步讲述IOManager的背景信息，第三步展示如何添加模块到IOManager。

第一步IOManager快速开始

复制以下代码到工程中。
注意：

• 如果你静态链接OpenMesh，你必须添加OM_STATIC_BUILD到你的应用程序中。这保证读取器和写入器正确初始化。
• IOManager使用文件名扩展名来决定哪一个写入器或者读取器被使用。比如，如果传送的文件是"inoutmesh.obj"，OBJ-File 写入器和读取器会被使用来进行文件操作。

#include <OpenMesh/Core/IO/MeshIO.hh>
MyMesh mesh;
if (!OpenMesh::IO::read_mesh(mesh, "some input file")) 
{
std::cerr << "read error\n";
exit(1);
}
// do something with your mesh ...
if (!OpenMesh::IO::write_mesh(mesh, "some output file")) 
{
std::cerr << "write error\n";
exit(1);
}

第二步IOManager的理论

通常网格数据的读取器和写入器流程通常是直接写入数据结构和相对应的支持文件格式。这种方法有一个显著的缺点，就是目标是不同的数据结构或者添加的是另一种文件格式的时候会导致代码冗余。

IOManager扮演者接口的角色，通过读取器和写入器以及输入输出模块连接一边是持久性数据而另一边是任意数据结构。

任意格式的持久性数据首先被读取模块转化。数据之后通过特定的接口被传送到目标数据结构。写入数据的过程也是相似的。IOManager控制整个过程。读取器和写入器模块对用户是不可见的。然而输入输出模块必须被显示的指定，因为这些模块是针对特定的数据结构的。

数据结构和持久性数据的完全分离使得代码维护和功能扩展非常容易，第三步将会体现。

第三步如何扩展IOManager

添加支持新文件

添加支持新文件涉及到添加读取器和写入器模块。读取器模块继承于OpenMesh::IO::BaseReader。接口模块通常这样定义。

class BaseReader
{
public:
virtual std::string get_description() const = 0;
virtual std::string get_extensions() const = 0;
virtual std::string get_magic() const { return std::string(""); }
virtual bool read(std::istream& _is, BaseImporter& _bi) const = 0;
virtual bool read(const std::string& _filename, BaseImporter& _bi) const = 0;
...
};

基于文件扩展名和文件头信息，IOManager决定哪一个读取器模块被使用。读取器模块解析格式和信息会被传送到目标数据结构，通过继承类OpenMesh::IO::BaseImporter。
写入器模块继承自 OpenMesh::IO::BaseWriter以及和读取器一样的工作方法。

添加新的数据结构

输入器从读取器接收数据。读取器模块通过特定的接口传送信息：

class BaseImporter
{
public:
virtual void add_vertex (const OpenMesh::Vec3f&) {};
virtual void add_normal (const OpenMesh::Vec3f&) {};
virtual void add_texture (const OpenMesh::Vec2f&) {};
virtual void add_face (const FaceType&) {};
};

输入器负责填充目标数据结构。从数据结构输出信息更像是输入数据。写入器模块必须能够迭代全部的向量/坐标/面。因此一个输出器必须提供迭代器：

class BaseExporter
{
public:
virtual void update() = 0;

virtual PVertexIter const_vertices_begin() = 0;
virtual PVertexIter const_vertices_end() = 0;

virtual PTexCoordIter const_texcoords_begin() = 0;
virtual PTexCoordIter const_texcoords_end() = 0;
virtual PIdxFaceIter const_idx_faces_begin() = 0;
virtual PIdxFaceIter const_idx_faces_end() = 0;
virtual PFaceIter const_set_faces_begin() = 0;
virtual PFaceIter const_set_faces_end() = 0;
virtual unsigned int n_faces() = 0;
virtual unsigned int n_vertices() = 0;
virtual unsigned int n_texcoords() = 0;
};

这可能需要输出器缓存引用的数据。update()函数应该在每一个BaseWriter::save()之前被调用来确保缓存数据被更新。
更多信息参考OpenMesh的IO子目录。