plist文件操作

Cocos2d-x数据篇04:plist文件操作

【前言】

在Cocos2d-x中,plist文件 是非常常见的配置文件。它是特定格式的xml文件。

例如:小图打包成大图的纹理图片、制作粒子特效、帧动画等,都用到了plist文件作为配置文件。

本节要介绍的是:如何创建plist文件,以及读取plist文件中的数据信息。

 

【plist文件】

属性列表(Property List)文件是一种用来存储序列化后的对象的文件。

属性列表文件的文件扩展名为 .plist,因此通常被称为plist文件。

 

1、plist文件在Cocos中的应用

(1)图片纹理的配置信息

将多个纹理小图片打包成一个大图片,并生成plist文件。用于配置各个小图的名称、尺寸大小、以及在大图中的所在的矩形区域位置等信息。

可以使用TexturePacker工具,将多个小碎图的纹理打包成一张大图片。

(2)帧动画的配置信息

将帧动画的数据信息,生成为plist配置文件。包含每帧间隔、动画重复次数、每一帧所需的图片、每张图片的名称、尺寸大小、以及在大图中所在的矩形区域位置等信息。

(3)粒子特效的配置信息

将粒子特效的数据信息,生成为plist配置文件。包含粒子发射器的位置信息、发射器模式、最大粒子数量、发射角度、发射速度、纹理贴图等等信息。

(4)还有其它。

 

2、plist文件格式

plist文件为属性列表文件,类似于键值对(key-value)的形式。

plist文件举例:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
//
<?xml version= "1.0"  encoding= "UTF-8" ?>
<!DOCTYPE plist PUBLIC  "-//Apple//DTD PLIST 1.0//EN"  "http://www.apple.com/DTDs/PropertyList-1.0.dtd" >
<plist version= "1.0" >
<dict>
<key>dict</key>
<dict>
<key>name</key>
<string>Alice</string>
<key>age</key>
<string>20</string>
</dict>
<key>array</key>
<array>
<integer>0</integer>
<integer>1</integer>
<integer>2</integer>
</array>
<key> bool </key>
< true />
<key>data</key>
<data></data>
<key>date</key>
<date>2015-02-16T16:47:11Z</date>
<key>number</key>
<integer>123456</integer>
<key>string</key>
<string>hello world!</string>
</dict>
</plist>
//

属性类型有:

> Dictionary :字典。(子属性列表为:键值对形式)

> Array         :数组。(子属性列表为:数组值的形式)

> Boolean    :逻辑值。(true / false)

> Number    :数字。

> String       :字符串。

> Date          :日期。

> Data          :数据。

其中,根节点只能为字典或数组。

并且在字典或数组中,键对应的值依然可以为以上的各个属性类型。

 

3、创建/编辑plist文件

在Mac OS系统中,XCode可以直接创建和编辑plist文件。

当然也可以使用plist编辑软件,或直接使用文本编辑器进行编写。

XCode中,编辑plist文件非常方便。

其中,根节点Root,只能为Dictionary、或Array类型。

wKiom1TiMoLiwX2QAAETD6stsBk455.jpg

以上plist文件数据,代码形式如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
//
<?xml version= "1.0"  encoding= "UTF-8" ?>
<!DOCTYPE plist PUBLIC  "-//Apple//DTD PLIST 1.0//EN"  "http://www.apple.com/DTDs/PropertyList-1.0.dtd" >
<plist version= "1.0" >
<dict>
<key>dict</key>
<dict>
<key>name</key>
<string>Alice</string>
<key>age</key>
<string>20</string>
</dict>
<key>array</key>
<array>
<integer>0</integer>
<integer>1</integer>
<integer>2</integer>
</array>
<key> bool </key>
< true />
<key>data</key>
<data></data>
<key>date</key>
<date>2015-02-16T16:47:11Z</date>
<key>number</key>
<integer>123456</integer>
<key>string</key>
<string>hello world!</string>
</dict>
</plist>
//

我想大家应该能读得懂把。

 

4、读取plist文件

接下来讲讲如何读取plist文件的数据信息。

(1)根节点为Dictionary :使用 FileUtils::getInstance()->getValueMapFromFile(); 读取为一个ValueMap 。

(2)根节点为Array :使用 FileUtils::getInstance()->getValueVectorFromFile(); 读取为一个ValueVector 。

使用举例:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
//
// 文件路径
std::string path =  "/soft/cocos2d-x-3.4/projects/Demo34/Resources/testPlist.plist" ;
// 读取plist文件
// 以根节点为字典Dictionary为例
// 根节点为字典Dictionary , 读取为一个ValueMap
ValueMap plist = FileUtils::getInstance()->getValueMapFromFile(path);
// 若根节点为数组Array , 读取为一个ValueVector
// ValueVector plist = FileUtils::getInstance()->getValueVectorFromFile(path);
// 获取数据
// 读取 "string"
CCLOG( "string = %s" , (plist[ "string" ].asString()).c_str());
// 读取 "dict" , 也是一个字典ValueMap
ValueMap& dict = plist[ "dict" ].asValueMap();
CCLOG( "name = %s" , (dict[ "name" ].asString()).c_str());
CCLOG( "age  = %s" , (dict[ "age" ].asString()).c_str());
// 读取 "array" , 是一个数组ValueVector
ValueVector& array = plist[ "array" ].asValueVector();
for  ( int  i = 0; i < array.size(); i++) {
Value& value = array[i];
CCLOG( "%d" , value.asInt());
}
//

 

【扩展阅读】

http://zh.wikipedia.org/wiki/Plist (维基百科)

http://zengrong.net/post/1981.htm (Cocos2d-x中的PLIST文件格式详解)

http://cn.cocos2d-x.org/tutorial/show?id=2117 (Spritesheet的plist文件格式解析)

转载于:https://www.cnblogs.com/dudu580231/p/4780604.html

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值