您的位置: 首页  >  文章  >  Ogre引擎源码——文件管理

Ogre引擎源码——文件管理

分类: 文章 • 2024-08-06 21:07:46

http://blog.****.net/hunter8777/article/details/6221763

本文是关于Ogre引擎中的文件部分，该部分相关的头文件有

OgreArchive.h

OgreArchiveFactory.h

OgreArchiveManager.h

OgreFileSystem.h

OgreZip.h

这里所指文件的英文名为Archive，可以理解为文件、文件夹等广义上的文件容器。

在代码设计中，Archive是一个文件抽象类。

UML图如下：

Ogre引擎源码——文件管理

（1）Archive

这个类就是一个定义接口的抽象类。

该类只有三个成员变量，也都很好理解。

[cpp] view plaincopyprint?
  1. ///Archivename
  2. StringmName;
  3. ///Archivetypecode
  4. StringmType;
  5. ///Read-onlyflag
  6. boolmReadOnly;
[cpp] view plaincopyprint?
  1. ///Archivename
  2. StringmName;
  3. ///Archivetypecode
  4. StringmType;
  5. ///Read-onlyflag
  6. boolmReadOnly;
/// Archive name String mName; /// Archive type code String mType; /// Read-only flag bool mReadOnly;

成员函数部分，定义不少纯虚函数，主要需要子类实现的是文件的load、unload、open、remove基本操作。

（2）ArchiveFactory

该类直接继承了Ogre中实现工厂的模板类FactoryObj<T>，没有任何内容的添加，只是继承实现了Archive的工厂模式。

（3）ArchiveManager

顾名思义，这个类的作用是负责管理Archive与Archive工厂。相应的数据结构如下：

[cpp] view plaincopyprint?
  1. typedefmap<String,ArchiveFactory*>::typeArchiveFactoryMap;
  2. ///Factoriesavailabletocreatearchives,indexedbyarchivetype
  3. ArchiveFactoryMapmArchFactories;
  5. ///Currentlyloadedarchives
  6. typedefmap<String,Archive*>::typeArchiveMap;
  7. ArchiveMapmArchives;
[cpp] view plaincopyprint?
  1. typedefmap<String,ArchiveFactory*>::typeArchiveFactoryMap;
  2. ///Factoriesavailabletocreatearchives,indexedbyarchivetype
  3. ArchiveFactoryMapmArchFactories;
  5. ///Currentlyloadedarchives
  6. typedefmap<String,Archive*>::typeArchiveMap;
  7. ArchiveMapmArchives;
typedef map<String, ArchiveFactory*>::type ArchiveFactoryMap; /// Factories available to create archives, indexed by archive type ArchiveFactoryMap mArchFactories; /// Currently loaded archives typedef map<String, Archive*>::type ArchiveMap; ArchiveMap mArchives;

两个Map，一个管理已经导入的Archive，另一个管理工厂。

每种工厂类型对应不同Archive的子类。在Ogre中主要有两种类型文件，通过UML图可以看到，一类是ZipArchive，还有一类是FileSystemArchive。稍后会简单介绍下这两个类的细节。

在ArchiveManager中，最重要的是实现load和unload函数。

[cpp] view plaincopyprint?
  1. Archive*load(constString&filename,constString&archiveType);
  2. voidunload(Archive*arch);
  3. voidunload(constString&filename);
[cpp] view plaincopyprint?
  1. Archive*load(constString&filename,constString&archiveType);
  2. voidunload(Archive*arch);
  3. voidunload(constString&filename);
Archive* load( const String& filename, const String& archiveType); void unload(Archive* arch); void unload(const String& filename);

Load函数大致如下(省略部分检验代码)

[cpp] view plaincopyprint?
  1. ArchiveFactoryMap::iteratorit=mArchFactories.find(archiveType);
  2. pArch=it->second->createInstance(filename);
  3. pArch->load();
  4. mArchives[filename]=pArch;
[cpp] view plaincopyprint?
  1. ArchiveFactoryMap::iteratorit=mArchFactories.find(archiveType);
  2. pArch=it->second->createInstance(filename);
  3. pArch->load();
  4. mArchives[filename]=pArch;
ArchiveFactoryMap::iterator it = mArchFactories.find(archiveType); pArch = it->second->createInstance(filename); pArch->load(); mArchives[filename] = pArch;

可以看出load的操作流程大致如下：

  1. 获取该Archive类型的工厂实例
  2. 通过工厂创建相应的Archive
  3. 使用创建出来的Archive进行资源的load
  4. 将该Archive进行保存以便管理

unload操作流程和上述操作基本一致。

另外ArchiveManager也提供了ArchiveMap的迭代器，方便遍历所有已经导入的Archive。

（4）ZipArchive / FileSystemArchive

这两个类是Archive的子类，实现了抽象类Archive中定义的所有接口。这也代表Ogre所定义两种文件类型：压缩文件和一般文件。文件的读取最终都是以数据流的形式保存在内存中，数据流的类型是DataStream。当然也可以根据自己的文件特点，编写自己的DataStream，如ZipArchive就定义了自己的数据流ZipDataStream。

ZipArchive类主要依赖了第三方类库zzip，这个类的接口在实现的形式上可以理解成是设计模式的Adapter，将zzip的函数调用封装成了Archive的形式。该类通过调用zzip的接口完成zip压缩文件的读取，最终转换成ZipDataStream。压缩文件主要用于图形资源文件。

FileSystemArchive则直接将文件通过fstream读入，是基本的C++的文件操作方法。

本文是关于Ogre引擎中的文件部分，该部分相关的头文件有

OgreArchive.h

OgreArchiveFactory.h

OgreArchiveManager.h

OgreFileSystem.h

OgreZip.h

这里所指文件的英文名为Archive，可以理解为文件、文件夹等广义上的文件容器。

在代码设计中，Archive是一个文件抽象类。

UML图如下：

Ogre引擎源码——文件管理

（1）Archive

这个类就是一个定义接口的抽象类。

该类只有三个成员变量，也都很好理解。

[cpp] view plaincopyprint?
  1. ///Archivename
  2. StringmName;
  3. ///Archivetypecode
  4. StringmType;
  5. ///Read-onlyflag
  6. boolmReadOnly;
[cpp] view plaincopyprint?
  1. ///Archivename
  2. StringmName;
  3. ///Archivetypecode
  4. StringmType;
  5. ///Read-onlyflag
  6. boolmReadOnly;
/// Archive name String mName; /// Archive type code String mType; /// Read-only flag bool mReadOnly;

成员函数部分，定义不少纯虚函数，主要需要子类实现的是文件的load、unload、open、remove基本操作。

（2）ArchiveFactory

该类直接继承了Ogre中实现工厂的模板类FactoryObj<T>，没有任何内容的添加，只是继承实现了Archive的工厂模式。

（3）ArchiveManager

顾名思义，这个类的作用是负责管理Archive与Archive工厂。相应的数据结构如下：

[cpp] view plaincopyprint?
  1. typedefmap<String,ArchiveFactory*>::typeArchiveFactoryMap;
  2. ///Factoriesavailabletocreatearchives,indexedbyarchivetype
  3. ArchiveFactoryMapmArchFactories;
  5. ///Currentlyloadedarchives
  6. typedefmap<String,Archive*>::typeArchiveMap;
  7. ArchiveMapmArchives;
[cpp] view plaincopyprint?
  1. typedefmap<String,ArchiveFactory*>::typeArchiveFactoryMap;
  2. ///Factoriesavailabletocreatearchives,indexedbyarchivetype
  3. ArchiveFactoryMapmArchFactories;
  5. ///Currentlyloadedarchives
  6. typedefmap<String,Archive*>::typeArchiveMap;
  7. ArchiveMapmArchives;
typedef map<String, ArchiveFactory*>::type ArchiveFactoryMap; /// Factories available to create archives, indexed by archive type ArchiveFactoryMap mArchFactories; /// Currently loaded archives typedef map<String, Archive*>::type ArchiveMap; ArchiveMap mArchives;

两个Map，一个管理已经导入的Archive，另一个管理工厂。

每种工厂类型对应不同Archive的子类。在Ogre中主要有两种类型文件，通过UML图可以看到，一类是ZipArchive，还有一类是FileSystemArchive。稍后会简单介绍下这两个类的细节。

在ArchiveManager中，最重要的是实现load和unload函数。

[cpp] view plaincopyprint?
  1. Archive*load(constString&filename,constString&archiveType);
  2. voidunload(Archive*arch);
  3. voidunload(constString&filename);
[cpp] view plaincopyprint?
  1. Archive*load(constString&filename,constString&archiveType);
  2. voidunload(Archive*arch);
  3. voidunload(constString&filename);
Archive* load( const String& filename, const String& archiveType); void unload(Archive* arch); void unload(const String& filename);

Load函数大致如下(省略部分检验代码)

[cpp] view plaincopyprint?
  1. ArchiveFactoryMap::iteratorit=mArchFactories.find(archiveType);
  2. pArch=it->second->createInstance(filename);
  3. pArch->load();
  4. mArchives[filename]=pArch;
[cpp] view plaincopyprint?
  1. ArchiveFactoryMap::iteratorit=mArchFactories.find(archiveType);
  2. pArch=it->second->createInstance(filename);
  3. pArch->load();
  4. mArchives[filename]=pArch;
ArchiveFactoryMap::iterator it = mArchFactories.find(archiveType); pArch = it->second->createInstance(filename); pArch->load(); mArchives[filename] = pArch;

可以看出load的操作流程大致如下：

  1. 获取该Archive类型的工厂实例
  2. 通过工厂创建相应的Archive
  3. 使用创建出来的Archive进行资源的load
  4. 将该Archive进行保存以便管理

unload操作流程和上述操作基本一致。

另外ArchiveManager也提供了ArchiveMap的迭代器，方便遍历所有已经导入的Archive。

（4）ZipArchive / FileSystemArchive

这两个类是Archive的子类，实现了抽象类Archive中定义的所有接口。这也代表Ogre所定义两种文件类型：压缩文件和一般文件。文件的读取最终都是以数据流的形式保存在内存中，数据流的类型是DataStream。当然也可以根据自己的文件特点，编写自己的DataStream，如ZipArchive就定义了自己的数据流ZipDataStream。

ZipArchive类主要依赖了第三方类库zzip，这个类的接口在实现的形式上可以理解成是设计模式的Adapter，将zzip的函数调用封装成了Archive的形式。该类通过调用zzip的接口完成zip压缩文件的读取，最终转换成ZipDataStream。压缩文件主要用于图形资源文件。

FileSystemArchive则直接将文件通过fstream读入，是基本的C++的文件操作方法。

相关推荐