GameData类

该类用来对游戏的数据进行访问。

GameData类的实现存放在路径下文件data/framework/game/game_data.h中。

GameData Class

成员

---

GameData ()

构造函数。 用来创建新GameData类的实例。

void loadData (Xml xml)

其作用是从Xml类的实例读取游戏数据。

参数

• Xml xml - 指游戏的数据。

void saveData (Xml xml)

其作用是将游戏数据写入Xml类的实例。

参数

• Xml xml - 指要写入游戏数据的Xml类的实例。

void load (string file_name)

其作用是从文件加载游戏数据。

参数

• string file_name - 指存放游戏文件的路径。

void save ()

其作用是将游戏数据保存进*.game文件。

string getGameFile (int is_absolute = false)

其作用是返回相对于data_path的存放游戏文件的路径。

参数

• int is_absolute - 指可用来表明是否返回绝对文件路径的标记。 1，表示返回绝对文件路径；0，表示不返回。

返回值

存放*.game文件的路径。

void setGameFile (string path)

其作用是设置存放游戏文件的路径。

参数

• string path - 指存放*.game文件的相对路径。

string getGamePath (int is_absolute = false)

其作用是返回相对于data_path的游戏文件的文件夹的路径。

参数

• int is_absolute - 指可用来表明是否返回绝对文件路径的标记。 1，表示返回绝对文件路径；0，表示不返回。

返回值

存放游戏文件的文件夹的路径。

int getNumEntities ()

其作用是返回游戏实体的数量。

返回值

游戏实体的数量。

EntityData getEntity (variable index)

其作用是通过实体自身的索引（index）返回该实体。

参数

• variable index - 该参数可以是实体序号，前提是index为整型；它也可以是实体名称，前提是index为string型。

返回值

实体的数据。

void removeEntity (variable index)

其作用是通过实体自身的索引（index）移除该实体。

参数

• variable index - 该参数可以是实体序号，前提是index为整型；它也可以是实体名称，前提是index为string型。

EntityData addEntity (string name)

其作用是创建新实体并将其添加到实体列表。

参数

• string name - 指新实体的名称。

返回值

新实体。

string getEntityPropertyFile (int is_absolute = false)

其作用是返回存放基本实体的属性文件的路径。

参数

• int is_absolute - 指可用来表明是否返回绝对文件路径的标记。 1，表示返回绝对文件路径；0，表示不返回。

返回值

存放属性文件的路径。

void setEntityPropertyFile (string file)

其作用是设置存放基本实体的属性文件的路径。

参数

• string file - 存放属性文件的路径。

int getNumLevels ()

其作用是返回游戏关卡的数量。

返回值

游戏关卡的数量。

LevelData getLevel (variable index)

其作用是通过索引（index）返回LevelData。

参数

• variable index - 该参数可以是关卡序号，前提是index为整型；它也可以是关卡名称，前提是index为string型。

返回值

LevelData。

void removeLevel (variable index)

其作用是通过索引（index）移除关卡。

参数

• variable index - 该参数可以是关卡序号，前提是index为整型；它也可以是关卡名称，前提是index为string型。

LevelData addLevel (string name)

其作用是将新关卡添加给游戏。

参数

• string name - 指新关卡的名称。

返回值

新关卡。

string getName ()

其作用是返回游戏名称。

返回值

游戏名称。

void setName (string name)

其作用是设置游戏名称。

参数

• string name - 指游戏名称。

string getDeveloper ()

其作用是返回有关游戏开发者的信息。

返回值

有关游戏开发者的信息。

void setDeveloper (string developer)

其作用是添加有关游戏开发者的信息。

参数

• string developer - 指有关游戏开发者的信息。

string getCopyright ()

其作用是返回版权信息。

返回值

版权信息。

void setCopyright (string copyright)

其作用是添加版权信息。

参数

• string copyright - 指版权信息。

string getVersion ()

其作用是返回游戏的版本。

返回值

游戏的版本。

void setVersion (string version)

其作用是添加有关游戏版本的信息。

参数

• string version - 指有关游戏版本的信息

string getDescription ()

其作用是返回游戏的描述。

返回值

游戏的描述。

void setDescription (string description)

其作用是添加游戏的描述。

参数

• string description - 指游戏的描述。

string getWindowTitle ()

其作用是返回游戏窗口的标题。

返回值

游戏窗口的标题。

void setWindowTitle (string window_title)

其作用是设置游戏窗口的标题。

参数

• string window_title - 指游戏窗口的标题。

string getPropertiesListFile (int is_absolute = false)

其作用是返回存放游戏属性的文件的路径。

参数

• int is_absolute - 指可用来表明是否返回绝对文件路径的标记。 1，表示返回绝对文件路径；0，表示不返回。

返回值

存放游戏属性的文件的路径。

void setPropertiesListFile (string path)

其作用是设置存放游戏属性的文件的路径。

参数

• string path - 指存放游戏属性的文件的路径。