蔡军生先生第二人生的源码分析(七十三)LLFeatureManager类分析特性文件

前面介绍类LLFeatureManager的声明部分，现在继续前面的内容进行分析，来看看它的实现代码，到底是怎么获取文本文件里的内容。先来看看它需要分析显示特性文件的内容是怎么样的，如下：
version 10

// NOTE: This is mostly identical to featuretable_mac.txt with a few differences
// Should be combined into one table

//
// Generates lists of feature mask that can be applied on top of each other.
//
// // Begin comments
// list <name>
// Starts a feature list named <name>
// <name> <available> <recommended>
// <name> is the name of a feature
// <available> is 0 or 1, whether the feature is available
// <recommended> is an S32 which is the recommended value
//
// For now, the first list read sets up all of the default values
//


//
// All contains everything at their default settings for high end machines
// NOTE: All settings are set to the MIN of applied values, including 'all'!
//
list all
RenderVBO 1 1
RenderAniso 1 0
RenderAvatarMode 1 2
RenderAvatarVP 1 1
RenderDistance 1 128
RenderLighting 1 1
RenderObjectBump 1 1
RenderParticleCount 1 4096
RenderRippleWater 1 1
RenderTerrainDetail 1 2
VertexShaderEnable 1 1
UseOcclusion 1 1
RenderCubeMap 1 1

//
// Class 0 Hardware (Unknown or just old)
//
list Class0
VertexShaderEnable 1 0
RenderVBO 1 0
RenderDistance 1 64
RenderAvatarVP 1 0
RenderAvatarMode 1 0
RenderLighting 1 0
RenderObjectBump 1 0
RenderRippleWater 1 0

//
// Class 1 Hardware
//
list Class1
VertexShaderEnable 1 0
RenderVBO 1 1
RenderDistance 1 96
RenderAvatarVP 1 1
RenderAvatarMode 1 0
RenderLighting 1 0
RenderObjectBump 1 0
RenderRippleWater 1 0

//
// Class 2 Hardware (make it purty)
//
list Class2
VertexShaderEnable 1 1
RenderAvatarVP 1 1
RenderAvatarMode 1 1
RenderLighting 1 1
RenderObjectBump 1 1
RenderRippleWater 1 1

//
// Class 3 Hardware (make it purty)
//
list Class3
VertexShaderEnable 1 1
RenderAvatarVP 1 1
RenderAvatarMode 1 1
RenderLighting 1 1
RenderObjectBump 1 1
RenderRippleWater 1 1

//
// No Pixel Shaders available
//
list NoPixelShaders
VertexShaderEnable 0 0
RenderAvatarVP 0 0

//
// No Vertex Shaders available
//
list NoVertexShaders
VertexShaderEnable 0 0
RenderAvatarVP 0 0

//
// "Default" setups for safe, low, medium, high
//
list safe
RenderVBO 1 0
RenderAniso 1 0
RenderAvatarVP 0 0
RenderLighting 1 0
RenderParticleCount 1 1024
RenderTerrainDetail 1 0


list low
RenderVBO 1 0
RenderAniso 1 0
RenderLighting 1 0

list medium
RenderLighting 1 0


//
// CPU based feature masks
//

// 1Ghz or less (equiv)
list CPUSlow
RenderParticleCount 1 1024


//
// RAM based feature masks
//
list RAM256MB
RenderObjectBump 0 0


//
// Graphics card based feature masks
//
list OpenGLPre15
RenderVBO 1 0

list Intel
RenderVBO 1 0
RenderAniso 1 0
RenderLighting 1 0
RenderTerrainDetail 1 0

list GeForce2
RenderVBO 1 1
RenderAniso 1 0
RenderLighting 1 0
RenderParticleCount 1 2048
RenderTerrainDetail 1 0

list ATI_Mobility_Radeon_X3xx
VertexShaderEnable 1 0

list ATI_Mobility_Radeon_X6xx
VertexShaderEnable 1 0


现在就来查看怎么样使用代码来分析上面的文件内容，加载和分析文件代码如下：
#001 void LLFeatureManager::init()
#002 {

下面函数就是打开文件，并分析文件数据。
#003 // load the tables
#004 loadFeatureTables();
#005

下面函数加载GPU的类内容。
#006 // get the gpu class
#007 loadGPUClass();
#008

下面函数应用所有需要显示特性。
#009 // apply the base masks, so we know if anything is disabled
#010 applyBaseMasks();
#011 }


接着来分析函数loadFeatureTables，它的代码如下：
#001 BOOL LLFeatureManager::loadFeatureTables()
#002 {
#003 // *TODO - if I or anyone else adds something else to the skipped list
#004 // make this data driven. Put it in the feature table and parse it
#005 // correctly

插入几个集合。
#006 mSkippedFeatures.insert("RenderAnisotropic");
#007 mSkippedFeatures.insert("RenderGamma");
#008 mSkippedFeatures.insert("RenderVBOEnable");
#009 mSkippedFeatures.insert("RenderFogRatio");
#010

获取文件所在的目录。
#011 std::string data_path = gDirUtilp->getAppRODataDir();
#012

获取目录分隔符。
#013 data_path += gDirUtilp->getDirDelimiter();
#014

获取显示特性文件的名称。
#015 data_path += FEATURE_TABLE_FILENAME;
#016
#017
#018 char name[MAX_STRING+1]; /*Flawfinder: ignore*/
#019
#020 llifstream file;
#021 U32 version;
#022

用API函数打开文件featuretable.txt。
#023 file.open(data_path.c_str()); /*Flawfinder: ignore*/
#024

判断文件是否打开成功。
#025 if (!file)
#026 {
#027 llwarns << "Unable to open feature table!" << llendl;
#028 return FALSE;
#029 }
#030

读取文件第一行的版本并检查。
#031 // Check file version
#032 file >> name;
#033 file >> version;
#034 if (strcmp(name, "version"))
#035 {
#036 llwarns << data_path << " does not appear to be a valid feature table!" << llendl;
#037 return FALSE;
#038 }
#039

保存文件的版本。
#040 mTableVersion = version;
#041

下面循环地分析这个文件直到文件结束。
#042 LLFeatureList *flp = NULL;
#043 while (!file.eof())
#044 {
#045 char buffer[MAX_STRING]; /*Flawfinder: ignore*/
#046 name[0] = 0;
#047

读取一个集合的名称。
#048 file >> name;
#049

跳过一些没用的行内容。
#050 if (strlen(name) >= 2 && /*Flawfinder: ignore*/
#051 name[0] == '/' &&
#052 name[1] == '/')
#053 {
#054 // This is a comment.
#055 file.getline(buffer, MAX_STRING);
#056 continue;
#057 }
#058
#059 if (strlen(name) == 0) /*Flawfinder: ignore*/
#060 {
#061 // This is a blank line
#062 file.getline(buffer, MAX_STRING);
#063 continue;
#064 }
#065

判断是否读取一个列表特性字段。
#066 if (!strcmp(name, "list"))
#067 {

分析到list一段内容了。
#068 if (flp)
#069 {
#070 //flp->dump();
#071 }

读取list段的名称。
#072 // It's a new mask, create it.
#073 file >> name;
#074 if (mMaskList.count(name))
#075 {
#076 llerrs << "Overriding mask " << name << ", this is invalid!" << llendl;
#077 }
#078

创建保存整个list段的列表管理。
#079 flp = new LLFeatureList(name);
#080 mMaskList[name] = flp;
#081 }
#082 else
#083 {

一行一行地读取list中的元素。
#084 if (!flp)
#085 {
#086 llerrs << "Specified parameter before <list> keyword!" << llendl;
#087 }
#088 S32 available;
#089 F32 recommended;
#090 file >> available >> recommended;

把一行的元素特征保存到创建的list里。
#091 flp->addFeature(name, available, recommended);
#092 }
#093 }

下面关闭文件。
#094 file.close();
#095
#096 return TRUE;
#097 }

上面这段代码是先分析eaturetable.txt的版本，然后依次分析list段内容，直到把所有list段内容分析完成，最后把分析出来的特性内容保存到类LLFeatureList列表里面，其它类需要使用时，就可以直接从这个LLFeatureList类里读取相应的内容出来，达到判断显示卡是否满足运行这个游戏的目的。