osgDB.ReadFileCallback

osgDB.ReadFileCallback是一个类，它用于处理OpenSceneGraph (OSG)库中读取文件的回调函数。它通常用于延迟加载模型资源以提高应用程序的性能。

基本用法

osgDB.ReadFileCallback是OpenSceneGraph库中的一个回调函数接口，用于处理文件的读取。要使用它，您需要定义一个自己的回调类，继承osgDB.ReadFileCallback类并实现其中的一个虚函数。然后将此回调类作为参数传递给osgDB::Registry::instance()->setReadFileCallback()函数。

class MyReadFileCallback : public osgDB::ReadFileCallback
{
public:
    virtual osgDB::ReaderWriter::ReadResult readNode(const std::string& file,
                                                     const osgDB::Options* options) const;
};

在实现自己的回调类时，需要实现其中的一个虚函数，根据所需的功能来选择实现哪个函数：

• osgDB::ReaderWriter::ReadResult osgDB::ReadFileCallback::readNode(const std::string& file, const Options* options = nullptr) const 读取给定文件的节点。

• osgDB::ReaderWriter::ReadResult osgDB::ReadFileCallback::readImage(const std::string& file, const Options* options = nullptr) const 读取给定文件的图片。

• osgDB::ReaderWriter::ReadResult osgDB::ReadFileCallback::readShader(const std::string& file, const Options* options = nullptr) const 读取给定文件的着色器。

• osgDB::ReaderWriter::ReadResult osgDB::ReadFileCallback::readObject(const std::string& file, const Options* options = nullptr) const 读取给定文件中的对象。

例如下面是一个自定义的osgDB::ReadFileCallback实现：

osgDB::ReaderWriter::ReadResult MyReadFileCallback::readNode(const std::string& file,
                                                              const osgDB::Options* options) const
{
    // 假设这里我们需要在加载节点之前先打印日志
    osg::notify(osg::INFO) << "Loading node from " << file << std::endl;

    // 调用默认的读取函数读取节点
    osgDB::ReaderWriter::ReadResult rr = osgDB::Registry::instance()->readNode(file, options);

    // 假设这里需要在加载节点完成后发送一个事件通知
    osg::notify(osg::INFO) << "Loaded node from " << file << std::endl;

    return rr;
}

然后，在应用程序中，使用以下语句来注册自定义读取回调：

osgDB::Registry::instance()->setReadFileCallback(new MyReadFileCallback);

高级用法

默认情况下，OpenSceneGraph使用osgDB::Registry::instance()->readNode()函数来读取模型数据。有时，这种默认的读取功能无法满足我们的需求，我们需要更复杂的模型读取过程。在这种情况下，可以使用osgDB::Registry::instance()->setReaderWriterForExtension()来为特定的格式注册自定义的osgDB::ReaderWriter。

一个自定义的osgDB::ReaderWriter可以通过继承osgDB::ReaderWriter来实现。例如，以下是一个基于Assimp库的自定义ReaderWriter的实现（当然，您需要在您的项目中包含Assimp库）：

#include <assimp/Importer.hpp>
#include <assimp/scene.h>
#include <assimp/postprocess.h>

class AssimpReaderWriter : public osgDB::ReaderWriter
{
public:
    virtual const char* className() const override { return "Assimp ReaderWriter";}

    virtual bool acceptsExtension(const std::string& extension) const override
    {
        return osgDB::equalCaseInsensitive(extension, "dae");
    }

    virtual ReadResult readNode(const std::string& fileName, const Options* options) const override
    {
        Assimp::Importer importer;

        const aiScene* ai_scene = importer.ReadFile(fileName, aiProcess_Triangulate |
                                                              aiProcess_GenSmoothNormals |
                                                              aiProcess_FlipUVs);

        if (!ai_scene)
        {
            osg::notify(osg::WARN) << "Cannot load " << fileName << ", error message: " << importer.GetErrorString() << std::endl;
            return ReadResult::ERROR_IN_READING_FILE;
        }

        osg::ref_ptr<osg::Node> node = convertAiScene(ai_scene);

        return ReadResult(node, ReadResult::FILE_LOADED);
    }

    // 辅助函数
    osg::ref_ptr<osg::Node> convertAiScene(const aiScene* ai_scene) const;
};

然后使用以下代码来注册自定义ReaderWriter：

osgDB::Registry::instance()->setReaderWriterForExtension(new AssimpReaderWriter, "dae");

这样，当OSG尝试在读取扩展名为‘dae’的模型文件时，就会使用自定义的AssimpReaderWriter来读取模型数据。

参考资料

• OpenSceneGraph 3.4.1 documentation: osgDB::ReadFileCallback