osgDB.ObjectWrapper是OpenSceneGraph中的一个类，用于序列化/反序列化任意C++对象。
在OpenSceneGraph中，场景中的节点、场景图等都可以被序列化和反序列化，以实现场景保存和加载，场景导出和导入等功能。osgDB.ObjectWrapper就是实现这个功能的类。
osgDB.ObjectWrapper可以根据指定的C++对象类型和对象实例，将对象数据序列化为可供存储的格式，或将存储的数据反序列化为指定的C++对象实例。
osgDB.ObjectWrapper的实现基于C++ 模板编程技术，为用户提供了友好的“Attribute”式的C++对象数据序列化方式，用户只需继承osgDB.ObjectWrapper并实现write和read两个虚函数即可。
osgDB.ObjectWrapper使用起来非常简单，用户只需继承osgDB.ObjectWrapper并实现write和read两个虚函数，即可实现对自定义C++对象的序列化和反序列化，下面是一个简单的例子：
#include <osgDB/ObjectWrapper>
#include <iostream>
class MyObject {
public:
MyObject():_num(0) {}
MyObject(int n):_num(n){}
int _num;
};
class MyObjectWrapper : public osgDB::ObjectWrapper
{
public:
MyObjectWrapper():ObjectWrapper("MyObject", new MyObject()){}
MyObjectWrapper(const MyObject& obj):ObjectWrapper("MyObject", new MyObject(obj)){}
META_Object(osgDB, MyObjectWrapper);
//将MyObject对象的数据序列化为字符串
virtual bool write(osgDB::OutputStream& os, const osg::Object& obj, const osgDB::Options* options) const
{
const MyObject& myObj = static_cast<const MyObject&>(obj);
std::string str = std::to_string(myObj._num);
os.write(str);
return true;
}
//从字符串中读取数据反序列化为MyObject对象
virtual bool read(osgDB::InputStream& is, osg::Object& obj, const osgDB::Options* options) const
{
MyObject& myObj = static_cast<MyObject&>(obj);
std::string str;
is.read(str);
myObj._num = std::stoi(str);
return true;
}
};
int main()
{
osgDB::Registry::instance()->addObjectWrapper(new MyObjectWrapper);
MyObject obj(1234);
osgDB::Output out;
out.writeObject(obj);
std::string str = out.str();
std::cout << "Serialized Data: " << str << std::endl;
osgDB::Input in(str, &osgDB::Registry::instance()->getOptions());
osg::ref_ptr<osg::Object> objNew = in.readObject();
assert(objNew.valid());
MyObject& obj2 = dynamic_cast<MyObject&>(*objNew.get());
std::cout << "Num: " << obj2._num << std::endl;
return 0;
}
osgDB.ObjectWrapper在序列化过程中支持各种类型的数据，包括基本类型、STL容器、自定义C++类等。它内部维护了类型到字符串的映射关系，即每个类型都对应一个名称字符串。在序列化对象时，每个对象都会被指定一个类型名称，从而能够在反序列化时根据类型名称找到对应的类型和构造函数。
其中，基本类型和STL容器类型均已内置映射，用户无需特意添加。自定义C++对象需要用户自行实现osgDB.ObjectWrapper的子类，并显式指定类型名称，例如前面提到的MyObjectWrapper。