osgDB.FinishedObjectReadCallback

osgDB.FinishedObjectReadCallback 是一个回调函数接口，用于在 OSG 加载一个对象后执行特定的操作。该接口可以用于在 OSG 加载场景前或场景后执行某些自定义任务，例如修改场景参数或加载其他文件。

概述

osgDB.FinishedObjectReadCallback 定义了一个回调函数 objectRead，当 OSG 完成对象加载时会调用该函数。该回调函数有一个参数 object，表示 OSG 加载的对象。我们可以在 objectRead 中修改对象、添加节点、加载其他场景等。

class FinishedObjectReadCallback : public osg::Referenced
{
public:
    virtual ~FinishedObjectReadCallback() {}

    virtual void objectRead(osg::Object* object) = 0;
};

使用方法

使用 osgDB.FinishedObjectReadCallback 的方法如下：

1. 继承 osgDB.FinishedObjectReadCallback 接口，实现 objectRead 函数；
2. 创建一个 osgDB.ReaderWriter 对象，将回调函数添加至其中；
3. 使用 osgDB 中的函数加载场景，加载完成后回调函数将自动执行。

例如，我们可以写一个继承了 osgDB.FinishedObjectReadCallback 接口的回调函数：

class MyReadCallback : public osgDB::FinishedObjectReadCallback
{
public:
    void objectRead(osg::Object* object) override
    {
        // Do something with the loaded object
    }
};

然后在加载场景的 ReaderWriter 中添加回调函数：

osg::ref_ptr<osgDB::ReaderWriter> rw = osgDB::Registry::instance()->getReaderWriterForExtension("osg");
if (rw.valid())
{
    osg::ref_ptr<MyReadCallback> cb = new MyReadCallback;
    rw->addFinishedObjectReadCallback(cb);

    osg::ref_ptr<osg::Node> node = osgDB::readNodeFile("myScene.osg");

    // Do something with the loaded node
}

当我们调用 readNodeFile 加载场景后，回调函数 cb 将会自动执行，我们可以在其中对 loaded object 进行操作。

注意事项

1. osgDB.FinishedObjectReadCallback 适用于 OSG 3.4 及以上版本。
2. 由于 objectRead 的参数类型为 osg::Object*，因此需要在回调函数中进行强制类型转换，例如 static_cast<osg::Node*>(object)。
3. osgDB.FinishedObjectReadCallback 中的回调函数需要包含必要的同步和线程安全保护，以避免可能的竞态条件。
4. 在添加回调函数之前，需要先判断 osgDB::Registry::instance()->getReaderWriterForExtension("osg") 是否返回了有效的 ReaderWriter 对象，以确保正确的为读取的文件类型添加回调函数。