osg实现自定义插件读取自定义格式的模型文件到场景

原创 已于 2023-10-07 07:00:40 修改 · 1.2k 阅读 · 7 ·
本内容遵循CC 4.0 BY-SA版权协议
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
标签
#osg自定义读写插件
于 2023-10-06 09:59:09 首次发布

目录

1. 前言

2. 预备知识

3. 工具、原料

4. 代码实现

1. 前言

        osg提供了很多插件来读取模型文件到场景中，这些插件支持大约70种格式类型的文件，但现实中的文件是各式各样，osg不可能囊括所有类型文件，当osg不支持某种类型格式文件时，就需要自己根据文件的格式开发插件来对这些文件定制解析、读取。

         本文讲解在osg中，如何实现自定义插件读取自定义格式的模型文件到场景。在读本博文之前，强烈建议先看osgDB::readNodeFile等函数源码剖析博文，该篇博文对osg读取文件的核心函数osgDB::readNodeFile的源码及原理机制进行了深入的剖析，看完并理解后，更加深对本博文的理解。

2. 预备知识

        在osgDB::readNodeFile等函数源码剖析 博文提到，如果想要读取一个自定义格式的文件，则：

  1. 必须开发一个读写器类，该读写器类从ReaderWriter类派生，并重写相应的虚函数。
  2. 利用REGISTER_OSGPLUGIN宏将自定义读写器注册到系统内部，该宏的第1个参数为该类型文件的扩展名，第2个参数是自定义的读写器类名称。
  3. 将1、2步用dll来封装实现，dll文件名格式为：osgdb_ext.dll或osgdb_extd.dll，其中ext为文件扩展名，d表示debug版，没d的表示release版，并将生成的dll放到osgPlugins-xx.yy.zz目录，其中xx.yy.zz为osg版本号。

3. 工具、原料

      本次用到的开发环境如下：

  • osg 3.6.2。
  • Visual Studio 2022。
  • Windows 11 操作系统。

4. 代码实现

         现在假设有一个名称为sphere.csdn 格式的文件，文件内容如下：

图1

这个文件包含创建一个地球所需的数据，其中第1个数值表示球半径；接下来三个数值表示球心位置x、y、z的值，即球位于何处；最后一个表示贴在球上的纹理图片，注意，该纹理图片位于工程的当前目录下。这几个数据之间用空格隔开，空格的个数无所谓。问题的提出：怎么解析这个文件，将其数据在视景器中展现出来？

步骤如下：

  1. 先用Visual Studio 2022建立一个dll工程，并将该dll编译生成的输出目录设置为：osg插件目录下，如：E:\osg\build_osg3.6.2\bin\osgPlugins-3.6.2，请根据你本机实际更改此目录。
  2. 将debug版的dll目标文件名称改为osgdb_csdnd，release版为osgdb_csdn，其中csdn为文件扩展名。
  3. 在Visual Studio 2022中请自行设置该工程的头文件和lib文件，这是osg开发基础，在此不赘述。
  4. 新建一个readMy3DModel类。

如下为该插件在Visual Studio 2022的设置：

图2 

readMy3DModel类的.h文件和cpp文件如下：

.h文件：

#ifndef _READMY3DFMODEL_EXPORT_H
#define _READMY3DFMODEL_EXPORT_H
#include<osgDB/ReaderWriter>
#include<osgDB/Registry>
using namespace osgDB;
class readMy3DModel : public ReaderWriter
{
public:
    readMy3DModel();
    ~readMy3DModel();
public:

    // 返回类名
    virtual const char* className() const override;

    // 读节点
    virtual ReaderWriter::ReadResult readNode(const std::string& fileName, const osgDB::ReaderWriter::Options* options) const override;

private:
    osg::Node* makeSphere(const std::string& strFileDirPath, std::ifstream& stream) const;

    void doTexture(const std::string& strTextureImageFilePath, osg::Geode* pShereGeode) const;
};

REGISTER_OSGPLUGIN(csdn, readMy3DModel)

#endif

.cpp文件：

#include "readMy3DModel.h"
#include<osgDB/FileNameUtils> // 这里有很多文件操作相关的工具类，如：获取文件扩展名、文件目录名等
#include<osgDB/FileUtils> // 这里有很多文件操作相关的工具类，如：文件是否存在，查找文件、文件类型等
#include<osgDB/ReadFile>
#include<osg/ShapeDrawable>
#include<osg/Texture2D>
readMy3DModel::readMy3DModel()
{
	supportsExtension("csdn", "sphere csdn model");
}

readMy3DModel::~readMy3DModel()
{

}

ReaderWriter::ReadResult readMy3DModel::readNode(const std::string& fileName, const osgDB::ReaderWriter::Options* options) const
{
	ReaderWriter::ReadResult result;

	auto strExt = osgDB::getLowerCaseFileExtension(fileName);

	// 在构造函数里必须先通过supportsExtension函数将文件的扩展名加入，否则这里会返回false
	if (!acceptsExtension(strExt)) 
	{
		OSG_WARN << fileName << "Not Found!";
		result = ReaderWriter::ReadResult::FILE_NOT_FOUND;
		return result;
	}

	auto strFileFullPath = osgDB::findDataFile(fileName, options); // 获取文件的绝对路径
	if (!osgDB::fileExists(strFileFullPath))
	{
		OSG_WARN << strFileFullPath << "is not exist!";
		result = ReaderWriter::ReadResult::FILE_NOT_FOUND;
		return result;
	}

	auto strFileDirPath = osgDB::getFilePath(strFileFullPath); // 获取模型文件所在的目录
	std::ifstream stream(strFileFullPath.c_str(), std::ios::in | std::ios::binary);
	if (!stream)
	{
		result = ReaderWriter::ReadResult::ERROR_IN_READING_FILE;
		return result;
	}

	// 构建球体
	result = makeSphere(strFileDirPath, stream);

	return result;
}

const char* readMy3DModel::className() const
{
	return "sphere csdn model";
}

osg::Node* readMy3DModel::makeSphere(const std::string& strFileDirPath, std::ifstream& stream) const
{
	osg::Node* pShereNode{nullptr};
	osgDB::Input fr;
	fr.attach(&stream);

	// 以下解析sphere.csdn文件
	auto radius = 0.0f;
	auto center = osg::Vec3d(0.0, 0.0, 0.0);
	auto textureImageFilePath = std::string();

	/* 读取%f表示读取数值，%s表示读取字符串。
	   注意：%f与%f或%f与%s之间的分隔符即空格个数不需要和sphere.csdn文件完全一致
	         sphere.csdn中要是字符串，必须用英文双引号括起来
    */
	if (!fr.matchSequence("%f %f %f %f %s"))
	{
		return pShereNode;
	}

	fr.readSequence(radius);
	auto x = 0.0f, y = 0.0f, z = 0.0f;
	fr.readSequence(x);
	fr.readSequence(y);
	fr.readSequence(z);
	center.set(x, y, z);

	fr.readSequence(textureImageFilePath);
	textureImageFilePath = strFileDirPath + R"(\)" + textureImageFilePath;
	bool bTextureImageFilePathIsExist = osgDB::fileExists(textureImageFilePath);
	if (!bTextureImageFilePathIsExist)
	{
		OSG_WARN << textureImageFilePath << "is not exist!";
	}

	auto pShereGeode = new osg::Geode();
	osg::TessellationHints* pHints = new osg::TessellationHints;
	pHints->setDetailRatio(5.0f); // 球的精细度设置
	auto pSpere = new osg::ShapeDrawable(new osg::Sphere(center, radius), pHints);
	pShereGeode->addDrawable(pSpere);
	pShereNode = pShereGeode;

	if (bTextureImageFilePathIsExist)
	{
		doTexture(textureImageFilePath, pShereGeode);
	}
	return pShereNode;
}

// 为地球贴纹理
void readMy3DModel::doTexture(const std::string& strTextureImageFilePath, osg::Geode* pShereGeode) const
{

	/*注意：这里需要读取jpg，故请保证jpg插件存在，否则读取jpg会失败。
	关于怎么编译jpg插件到osg，请参见：https://blog.csdn.net/danshiming/article/details/115412956
     */
	auto pImage = osgDB::readImageFile(strTextureImageFilePath);
	if (nullptr == pImage)
	{
		OSG_WARN << "read " << strTextureImageFilePath << "Failed!";
		return;
	}

	// 构造二维纹理对象
	auto pTexture2D = new osg::Texture2D;
	pTexture2D->setImage(pImage);

	// 设置二维纹理过滤器属性
	pTexture2D->setWrap(osg::Texture::WRAP_S, osg::Texture::CLAMP);
	pTexture2D->setWrap(osg::Texture::WRAP_T, osg::Texture::CLAMP);
	pTexture2D->setFilter(osg::Texture::MIN_FILTER, osg::Texture::LINEAR);
	pTexture2D->setFilter(osg::Texture::MAG_FILTER, osg::Texture::LINEAR);

	// 将纹理贴到地球上
	pShereGeode->getOrCreateStateSet()->setTextureAttributeAndModes(0, pTexture2D, osg::StateAttribute::ON);
}

说明：

  • 在.h文件中需要通过如下宏，将该插件类即该读写器注册到osg内核：
REGISTER_OSGPLUGIN(csdn, readMy3DModel)

关于这个宏的作用及参数含义，请参见前提提到的那篇博客。

  • 本类重写了父类的className和readNode函数。
  • osgDB::Input从osgDB:: FieldReaderIterator类派生而来，是一个字段迭代器，通过该对象可以遍历sphere.csdn中每个字段。当然，你也可以自己实现读取一行然后按空格解析出每个数据。
  • 因为贴纹理时，用的是jpg图片，所以本机需要有读取jpg的插件并挂接到osg中，关于怎么编译jpg插件到osg，请参见：osg第三方插件的编译方法（以jpeg插件来讲解）博文。
  • 其它的内容，请参见注释。

请确保sphere.csdn和land_shallow_topo_2048.jpg文件在当前工程目录下，编写主程序以便调用该dll，如下：

#include<osgViewer/Viewer>
#include<osgDB/readFile>
#include<osgDB/FileUtils>

int main(int argc, char *argv[])
{
    osgViewer::Viewer viewer;
    osg::ref_ptr<osgDB::Options>spOptions = new osgDB::Options();
    spOptions->setDatabasePath(".");  // 设置文件搜索目录，即在当前目录下看是否存在sphere.csdn文件
    auto pSphereNode = osgDB::readNodeFile("sphere.csdn", spOptions);
    auto pRoot = new osg::Group;
    pRoot->addChild(pSphereNode);
    viewer.setSceneData(pRoot);
    return viewer.run();
}

运行结果如下：

图3

也可以在命令行中输入如下命令验证是否加载成功：

osgViewerd sphere.csdn

 至此，一个自定义的读写插件开发完成。

OSG开发笔记（二十九）：OSG加载模型文件、加载3DMax三维型文件Demo
热门推荐
长沙红胖子Qt的技术博客
10-27 1万+
Osg深入之后需要打开模型文件，这些模型文件是已有的模型文件，加载入osg之后可以在常见中展示模型文件，该节点可以操作，多个逼真的模型的节点就实现了基本的场景构建。自定义文件插件主要是自定义一个插件读写类，继承osgDB::ReaderWriter类，然后根据需求重写如readNode等函数方法即可。
OSG 3D模型格式插件
深之JohnChen的专栏
09-26 562
这些 DLL 文件是 OpenSceneGraph 的模型格式插件功能：每种插件负责一种特定的3D模型文件格式的导入和导出自动加载：当调用时，OSG 会根据文件扩展名自动加载对应的插件重要性：这些插件是 OSG 与各种3D建模软件之间的桥梁：通用静态模型交换：兼容老旧3D Studio格式：专业动画和复杂场景：开放标准，学术研究：3D打印和纯几何数据。
【OSG系列】osgDB库
步子哥的博客
02-05 725
文件格式支持：osgDB库支持许多常见的3D模型和图像文件格式，包括但不限于：.osg、.obj、.dae、.fbx、.3ds、.stl、.png、.jpg等。使用方法：通过使用osgDB库，您可以轻松地从文件中加载3D模型和图像数据，或将数据保存到文件中。您可以使用预定义的函数来读取和写入不同的文件格式。osgDB是OpenSceneGraph的一个库，用于读取和写入3D模型和图像文件。它提供了一组函数和类，可以加载和保存多种文件格式的数据。功能：osgDB库提供了读取和写入3D模型和图像文件的功能。
osg_osgDB插件机制
yishiwei123的专栏
05-26 4130
最近研究了一段osg/osgDB插件读写机制，xiechulai
osg解析系列-将osg源码分割成osgCore+osgPlugins独立的两部分，osgPlugins可以独立编译，其整合文件见下方链接
qq_42531872的博客
01-06 588
【代码】【M24.01.W11】将osg源码分割成osgCore+osgPlugins独立的两部分，osgPlugins可以独立编译，其整合文件见下方链接。
osg之osgDB读取文件详解
的博客
06-21 8838
osg、osgEarth所有文件都是通过osgDB库来读取，通过Registry来查找文件拓展名对应的osg库(Registry是一个单例类，这个类特别重要，建议通读代码加深对此的理解)，根据一定规则拼接成完成的osg库名并加载，通过ReaderWriter对象来完成节点的读取(ReaderWriter是读写节点的基类，可通过派生此类重写读写方法实现自己的读写格式)。 一、osg读取一个节点的方法 osg::ref_ptr<osg::Node> pNode = osgDB::readNodeFi
osgDB::readNodeFile等函数源码剖析
danshiming的博客
10-03 1552
osg的文件读写接口主要是由osgDB库负责实现。可读写的文件包括：模型、图像、视频、字体、文本文档等。搞清楚这些读写函数内部的实现机制，对于熟悉osg并为自己以后编写读取特定文件的插件是至关重要的。
OSG 3.4.0集成FBX插件实现三维模型读取功能
weixin_42593701的博客
10-25 1065
为了实现条件编译，OSG社区在CMake系统中引入了专用宏，用于控制是否启用FBX插件构建。endif()同时，在源码中通过预处理器判断是否包含相关实现：// ...#endif该宏还可进一步细分为：：仅启用动画支持：仅处理几何体此类细粒度控制有助于裁剪功能集，适用于资源受限的嵌入式系统。graph LR上述流程体现了构建系统的决策逻辑，强调了依赖发现与条件编译的重要性。虽然。
深入理解OSG如何读取FBX文件
weixin_28840811的博客
05-23 1136
OpenSceneGraph (OSG) 是一个高性能的、跨平台的开源3D图形工具库，它能够帮助开发者构建各种图形应用程序，如模拟器、虚拟现实和游戏等。OSG最初由Don Burns和Robert Osfield在20世纪90年代后期开发，其目的是提供一个易用、高效且功能强大的3D图形引擎。这个库广泛应用于图形和仿真领域，已成为IT行业中备受推崇的图形解决方案之一。FBX最初由Kaydara公司开发，用于其3D动画软件Fusion Studio。
OSG编程指南＜十八＞：OSG读写保存文件及对中文字符的支持
欧特GO
12-06 2070
OSG支持的三维文件格式、如何读写、保存文件及对中文字符的支持；附加读取文件的进度示例
osgPlugins相关
醉逍遥的博客
11-09 1800
OSG提供了很多的插件用来读取常用的数据格式，包括图像和模型等等。下面对插件的使用进行简单的描述。 使用插件读取和保存数据 当使用osgDB读取文件时，会自动根据文件的扩展名来到插件目录中寻找相应的插件，来实现。 比如： &gt; osgviewer cow.osg 调用了osgdb_osg插件去读*.osg文件。 &gt; osgviewer model.flt 调用了osgdb...
osg365-plugins(全)-包括（occ、gdal、fbx、3dc、shp、tiff、gif 等）
qq_42531872的博客
01-10 587
osg365-plugins(全)-包括（occ、fbx、tif、gdal等）
第二个项目进展情况
coder
04-18 771
第一个功能：VS+QT的操作WORD的功能 2015年4月11日--4月17日，各种更改，各种GOOGLE，各种查书，各种编码，终于完成了 第二个功能：OSGEARTH路径漫游+physx+物体跟踪以及坐标转换 计划： 4月18日，完成OSGANIMATIONPATH漫游 4月20日，完成OSGEARTH上的漫游 4月21日，加上PHYSX， 4月22日，加上跟随物体的变换
QT+OSG/osgEarth编译之八十二：osgDB+Qt编译（一套代码、一套框架，跨平台编译，版本：OSG-3.6.5核心库osgDB）
LuckyHanMo的博客
11-28 946
通过一套osgDB代码和框架，实现osgDB的跨平台编译。 在Qt环境下，集成osg核心库osgDB头文件、库文件，构建跨平台编译的pro文件。 通过构建的一套配置工程，基于Qt Creator IDE，完成跨平台的编译实践。 在Windows、Linux、MacOS等操作系统上进行测试，成功编译，形成的成果（头文件、库文件等）可在不同系统下调用或使用，从而更好地构建跨平台解决方案。 采用的是osg-3.6.5版本的osgDB。 读者可参考博客中的集成原理和pro文件，构建不同版本的osgDB跨平台包。
OSGB数据的纹理压缩
weixin_44215147的博客
06-29 2530
运行环境 OSG3.4.1 + VS2017 对osgb数据的压缩关键在于纹理的压缩，即可在writeNodeFIie方法中进行操作。 osgDB::writeNodeFile(*rootNode, f_path, new osgDB::Options("WriteImageHint=IncludeFile")); osg老版本中的 writeImageHint=IncludeFile 有缺陷(听一位大佬说的，osg3.6中修复)，我测试后发现，使用这个选项时，在你的vs项目文件夹中必须有 该os
跨平台3D模型格式转换工具：从OSG到OSGB、IVE、OBJ
weixin_29323977的博客
08-07 1376
OSG（OpenSceneGraph）是一个高性能的3D图形工具库，主要用于实时渲染、可视化和模拟领域。它支持多种文件格式，但OSG本身也作为一种常用的场景图描述格式被广泛应用。OSG文件通常包含场景图节点的描述，能够表达复杂的场景结构，包括几何体、光照、纹理映射以及视图和渲染设置等。
OSG Day006
Junglefor的博客
03-03 1679
OSG学习入门
【OSG学习笔记】Day 41: ReadFileCallback 与 WriteFileCallback（自定义文件读取）
最新发布
u012739527的博客
04-11 851
OSG文件读写回调机制解析：本文深入探讨了OpenSceneGraph中的ReadFileCallback和WriteFileCallback自定义文件读写机制。通过继承osgDB::Registry中的抽象回调类，开发者可以在不修改底层源码的情况下扩展文件读写功能，实现日志记录、耗时统计等定制化需求。文章详细分析了回调类的继承关系、核心原理及实现方法，并提供了完整的可运行代码示例，展示了如何注册全局回调并在文件读写前后执行自定义逻辑。这种钩子设计模式为OSG开发提供了灵活的功能扩展能力，同时保持了原有读写
OSG学习之路（一）osg各个库的用途
qq_43238450的博客
05-05 6349
介绍一下osg各个库的用途 组件 Osg核心库 提供了基本的场景图形和渲染功能，以及3d图形程序所需的某些特定功能实现。包括： osg库 包含了用于创建场景图形的场景图形节点类，用作向量和矩阵运算的类，几何体类，以及用于描述和管理渲染状态的类，3d图形程序所需的典型功能类，例如命令行参数解析，动画路径管理，以及错误和警告信息类。 osgUtil库 osg工具库包含的类和函数，可以用于场景图形...
osg第三方插件的编译方法（以jpeg插件来讲解）
danshiming的博客
04-03 2677
osg以插件方式来扩展、加载第三方库，如果这些库在程序运行时找不到，就会报类似如下的错误：（这里以jpeg为例）： 下面以jpeg为例，讲解jpeg插件的编译方法，其它库和这步骤类似。 先从库的官网下载你需要的库。如：从https://jpeg.org/ 下载jpeg的库文件，注意：有的是exe安装包，有的zip等压缩文件。安装包的需要安装，安装后才能有相应的lib、dll文件，如下是我安装之后的目录内容： 2：打开cmake-gui，设置好osg源码目录，二进制文件生成存放目录，...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值