HTML5引擎Construct2技术剖析(二)

接上一节,在讲解游戏数据解析之前,需要先介绍一下游戏数据格式。
(另,本人也写了一个基于C2引擎开发的游戏编辑器,能够导出与Construct2相同格式数据文件,发表在百度贴吧construct2吧 帖子地址为:http://tieba.baidu.com/p/3629460539)

游戏数据文件格式

使用Construct2开发HTML5游戏,不需要写一行js代码,导出游戏时,编辑器中的关卡场景和事件表单的所有游戏数据全部保存在data.js文件中,数据采用json格式来组织,下面就分类介绍json格式中各个字段的含义(需要说明的是,有少量的字段的含义还没有弄清楚,可能会有个别字段含义理解错误,欢迎指正)

ProjectModel

一个游戏对应一个工程模型,整个游戏的数据模型采用ProjectModel数据格式来保存,是一个数组Array对象(按索引顺序来介绍各个字段含义):

[0]: string,游戏名
[1]: string, 第一个场景名, null表示缺省
[2]: Array,Plugin(插件)模型列表,具体格式详见后面
[3]: Array,ObjectType(对象类型)模型列表,具体格式详见后面
[4]: Array,Family(集合)模型列表,具体格式详见后面
[5]: Array,Layout(界面)模型数据,具体格式详见后面
[6]: Array,EventSheet(事件单)数据,具体格式详见后面
[7]: Array,预加载的音频数据列表,是一个2维数组,数组单元格式为
—[0]: string, 音频文件名;
—[1]: number,文件大小(字节数目)
[8]: string,资源文件相对目录
[9]: bool,是否采用像素对齐
[10]: number,原始设计宽度
[11]: number,原始设计高度
[12]: number,全屏模式,0 = off, 1 = crop(图像显示比例不随窗口大小变化,窗口越大显示的场景越多), 2 = scale inner(保持原始长宽比进行缩放,与窗口长宽比不一致时会裁掉部分场景), 3 = scale outer(保持原始长宽比进行缩放,与窗口长宽比不一致时会显示更多场景添补黑边;主要用于不支持缩放,但是支持多种分辨率), 4 = letterbox scale(保持原始长宽比,与窗口长宽比不一致时会出现黑边), 5 = integer letterbox scale(缩放模式与letterbox scale相同,但是缩放比例必须是整数倍)
[13]: bool,是否开启3D加速
[14]: bool,是否开启线性采样
[15]: bool,是否支持背景alpha
[16]: string,版本字符串
[17]: bool,是否使用高Dpi模式
[18]: bool,load屏幕是否采用Layout布局(如果为真,则第一个场景布局就是加载界面的布局)
[19]: number,loading屏幕显示风格,0=显示加载logo图片,1=显示进度条, 2=文字显示加载百分比)
[20]: number,显示方向, 0 = any任意, 1= portrait竖屏, 2 = landscape横屏)
[21]: number,下一个UID
[22]: bool,游戏暂停时屏幕变模糊
[23]: bool,全屏缩放显示质量, false =低质量, true =高质量
[24]: number,缩小显示质量(缩放比例小于1),0 = low (关闭mipmaps), 1 = medium (开启mipmaps, dense spritesheet), 2 = high (开启mipmaps, sparse spritesheet)
[25]: number,是否预加载声音文件,0 =否, 1 =是
[26]: string,游戏项目名
[27]: Array,Container(容器)数据列表,具体格式详见后面

Plugin数据格式

Plugin表示游戏用到的插件列表,是一个数组对象:

[0]:number,插件索引(在objectRefTable表中的索引),
[1]:bool,全局唯一
[2]:bool,是否在游戏世界中出现
[3]:bool,是否具有位置属性(用于add_common_aces函数向system_object对象添加相关的Cnds(条件)、Acts(动作)、Exps(表达式)函数)
[4]:bool,是否具有大小属性(用于add_common_aces函数,作用类似)
[5]:bool,是否具有角度属性(用于add_common_aces函数,作用类似)
[6]:bool,是否具有展现属性(用于add_common_aces函数,作用类似)
[7]:bool,是否具有深度属性(用于add_common_aces函数,作用类似)
[8]:bool,是否具有特效属性(用于add_common_aces函数,作用类似)
[9]:bool,是否每次tick需要重绘

ObjectType数据格式

ObjectType表示游戏中用到的实体类型,用于创建相应的对象实例,是一个数组对象:

[0]:string,类型名称
[1]:number,类型所属的插件原型在ObjectRef表中的索引
[2]:bool,是否为family
[3]:Array,内部实例变量SID数组
[4]: number,包含的行为数目
[5]: number,包含的特效数目
[6]:Array,使用的纹理文件数据,是一个数组对象:
—[0]:string,图像文件相对路径(相对于游戏资源目录)
—[1]: number,文件大小(字节)
—[2]: number,图像格式, 0表示RGBA8,1表示RGB8 ,2表示RGBA4,3表示RGB5_A1 ,4表示RGB565
[7]:Array,Animation(动画)数据列表,具体格式详见后面
[8]:Array,Behavior(行为)数据列表,是一个2维数组,每个数组单元格式为:
—[0]:string,行为名
—[1]: function, 行为对象构造函数
—[2]: number, sid(唯一标示)
[9]:false, 是否为全局实例(即该类型的实例在退出Layout时不会删除,例如玩家控制的精灵)
[10]:false, 是否在loading界面中
[11]:number, sid(唯一标示)
[12]:Array,Effect(特效)数据,缺省提供的是混合渲染特效,也可以自定义特殊绘制效果,是一个长度为2的数组,数组单元格式为:
—[0]: string, 特效名称
—[1]: string,特效类型名
[13]:Array,TilePoly数据(尚未弄清楚)
[14]:Array,插件参数数组 (如果是singleglobal对象)

Animation数据格式

Animation记录一个事件变量,是一个数组对象:

[0]: string,动画名称
[1]: number,每秒播放帧数(一般不超过60帧)
[2]: false,是否无限循环播放
[3]: number,重复播放次数(在非无限循环的情况下)
[4]: number,当动画结束时停留的帧号
[5]: bool,是否Ping-Pong模式(正向/反向交替播放),
[6]: number, sid(唯一标示)
[7]: Array,动画帧列表,是一个2维数组,数组单元格式为:
—[0]: string,动画帧文件相对路径(相对游戏资源目录)
—[1]: number,文件大小(字节数)
—[2]: number,在纹理文件上X偏移
—[3]: number,在纹理文件上Y偏移
—[4]: number,宽度,如果动画文件就包含一帧(即整个图片为一个动画帧),则为0
—[5]: number,高度,如果动画文件就包含一帧,则为0
—[6]: number,持续的帧数,默认为1
—[7]: number,原点X坐标相对位置(取值0-1)
—[8]: number,原点Y坐标相对位置(取值0-1)
—[9]:Array,自定义的锚点信息,是一个2维数组,数组单元格式为:
——[0]: string,锚点名
——[1]: number, X坐标相对位置(取值0-1)
—[2]: number, Y坐标相对位置(取值0-1)
—[10]:Array,碰撞多边形顶点列表,每2个值表示一个顶点的XY相对坐标(相对于原点而且,而不是纹理文件左上角)
—[11]: number,像素格式, 0表示RGBA8,1表示RGB8 ,2表示RGBA4,3表示RGB5_A1 ,4表示RGB565

Family数据格式

若干个对象类型ObjectType可以组成一个Family, 向Family赋予特效、参数、行为等数据,当创建对象实例时,对象实例除了具有自身类型所有属性外,还会加入所在Family中的属性,其结构是一个变长数组:

[0]: number,Family对应的对象类型索引(即在runtime.types_by_index数组中的索引)
[1-n]: number,Family中包含的对象类型索引列表

需要说明,数组长度可变,Family中包含n类对象,数组总长度为n+1。Family中的对象必须属于同一类插件

Layout数据格式

Layout记录一个完整界面的数据,是一个数组对象:

[0]: string,界面名称
[1]: number,原始宽度
[2]: number,原始高度
[3]: bool,是否支持无限滚动
[4]: string,关联的EventSheet名(只能关联一个EventSheet)
[5]: number, sid(唯一标示)
[6]: Array,场景中的Layer(图层)列表
[7]: Array,场景中不在world中(不可见)的实例列表
[8]: Array,场景中使用的特效列表

Layer数据格式

Layer记录一个图层的数据模型,是一个数组对象:

[0]: string,图层名称
[1]: number, 图层在Layout中的顺序索引(索引小的图层先绘制)
[2]: number, sid(唯一标示)
[3]: bool,是否初始可见
[4]: Array,背景颜色,长度为3:
—[0]: number, 红色
—[1]: number, 绿色
—[2]: number, 蓝色
[5]: bool,是否透明
[6]: number,图层在X坐标方向的滚动速度倍数(相对正常速度)
[7]: number,图层在Y坐标方向的滚动速度倍数(相对正常速度)
[8]: number,透明度(取值0~1)
[9]: bool, 是否强制图层渲染到临时纹理上(即使在没有特效情况下);如果图层使用的特效,则会先绘制到临时纹理上,然后在绘制到Canvas上
[10]: bool, 是否使用渲染网格,优化包含很多静态对象的大图层渲染
[11]: number,缩放比例
[12]: number,混合模式,
[13]: number,默认特效索引(当指定的特效无效或不存在时,则调用该特效替换)
[14]: Array,图层中包含的Instance(对象实例)列表,,具体格式详见后面
[15]: Array,图层中包含的Effect列表,是一个2维数组,数组单元格式为:
—[0]: string,特效ID名
—[1]: string,特效类型名
—[2]: Array,参数列表,长度可变,与特效使用的参数数目一致

Instance数据格式

Instance记录在图层中的一个对象实例,是一个数组:

[0]: Array,对象缺省实例的初始化数据,是一个数组(如果不是tilemap,则不要长度大于13,否则碰撞检测有问题):
[0]:number,x坐标
[1]:number,y坐标
[2]:number,z坐标
[3]:number,宽度
[4]:number,高度
[5]:number,深度
[6]:number,旋转角度(弧度)
[7]:number,透明度
[8]:number,原点x坐标
[9]:number,原点y坐标
[10]:number,混合渲染模式
[11]:number,特效回调函数索引(当指定特效无效时,使用该特效代替)
[12]:Array,特效参数数组,如果特效无参数,则为空数组
[13]: Array, TileMap格子数据,其格式如下
—[0] number,格子列数
—[1] number,格子行数
—[2] string,格子数据,采用合并方式,如果连续格子数据相同,例如0,0,则会处理为2x0
——[1]: number,对象类型索引(在runtime.types_by_index数组中的索引)
——[2]: number, sid(唯一标示)
——[3]: Array,自定义参数数据,是一个2维数组,数组单元格式为:
———[0]:类型不确定,参数值
———[1]:string,参数名
——[4]: Array,行为属性数据
——[5]: Array,插值属性数据,与插件定义顺序一致

Container数据格式

Container记录一个容器集合,是一个变长数组,数组元素是对象类型索引;每个对象类型只能属于1个容器;

下一个节详见介绍事件表单(EventSheet)数据格式

你可能感兴趣的:(HTML5引擎Construct2技术剖析(二))