csb2csd
cocostudio csb反编成csd
建完工程搜了遍才发现已经有大佬实现了csb2csd。可惜在windows系统折腾了几遍竟然没法编译成功(linux上一遍过了)。还是决定自己手撸一个好了。
使用说明
python 版本2.7
python convert.py path_of_csb执行后会在脚本目录/csd生成对应的csd文件。如遇到转换过程报错或转换后格式错误的,欢迎反馈并尽量提供源文件。
配置相关
CSParseBinary.fbs 是基于cocos/editor-support/cocostudio/fbs-files/CSParseBinary.fbs,添加了一些其他结构,使用flatc -p CSParseBinary.fbs生成库结构,部分坑需要手动修改
header_rule.json和child_rule.json是导出csd的规则配置,其中header_rule.json是对应csd中类似的格式
2.1 header_rule.json
以Button为例,
配置
"Button":[
["DisplayState", "Displaystate", false, ""],
["Scale9Enable", "Scale9Enabled", false, ""],
["LeftEage", "CapInsets.X", 0.0, ""],
["RightEage", "CapInsets.X", 0.0, ""],
["TopEage", "CapInsets.Y", 0.0, ""],
["BottomEage", "CapInsets.Y", 0.0, ""],
["Scale9OriginX", "CapInsets.X", 0.0, ""],
["Scale9OriginY", "CapInsets.Y", 0.0, ""],
["Scale9Width", "CapInsets.Width", 0.0, ""],
["Scale9Height", "CapInsets.Height", 0.0, ""],
["ShadowOffsetX", "ShadowOffsetX", 0.0, ""],
["ShadowOffsetY", "ShadowOffsetY", 0.0, ""],
["ButtonText", "Text", "", ""],
["FontSize", "FontSize", "", ""]
],
对应csd结构
TopEage="11" BottomEage="11" Scale9OriginX="15" Scale9OriginY="11" Scale9Width="1" Scale9Height="9"
ShadowOffsetX="2" ShadowOffsetY="-2" ButtonText="Test" FontSize="14">
fbs结构
table ButtonOptions
{
widgetOptions:WidgetOptions;
normalData:ResourceData;
pressedData:ResourceData;
disabledData:ResourceData;
fontResource:ResourceData;
text:string;
fontName:string;
fontSize:int;
textColor:Color;
capInsets:CapInsets;
scale9Size:FlatSize;
scale9Enabled:bool;
displaystate:bool;
outlineEnabled:bool = false;
outlineColor:Color;
outlineSize:int = 1;
shadowEnabled:bool = false;
shadowColor:Color;
shadowOffsetX:float = 2;
shadowOffsetY:float = -2;
shadowBlurRadius:int;
isLocalized:bool = false;
}
["Scale9OriginY", "CapInsets.Y", 0.0, ""]第一个为csd的字段名,第二个为根据fbs取值的字段路径, 第三个为默认值,等于默认值的将不写到csd中,第四个为重命名,如["ProgressType", "Direction", 0, "0=Left_To_Right,1=Right_To_Left"]就是值为0时,写入csd的是Left_To_Right,1时写入Right_To_Left
2.2 child_rule.json 跟2.1类似
struct FlatSize
{
width:float;
height:float;
}
["Size", "Size", "X=Width,Y=Height", ""], 第一个为csd的字段名,第二个为根据fbs取值的字段路径, 第三个为重命名,即将width的值以键X写入csd,第四个为特殊标记,不赋值的时候会按照fbs的字段格式导出,特殊值目前只有ImageData,代表这是文件路径格式
待完成
支持粒子特效、骨骼动画
支持动画曲线的points
……
踩过的坑
对比引擎用的CSParseBinary_generated.h和给出的CSParseBinary.fbs,发现fbs中的isLocalized位置有问题需要手动移至最后
九宫格数据Scale9OriginX,Scale9OriginY,Scale9Width,Scale9Height必须是整数否则会解析错误,取出的浮点数要去除小数点和0
编辑器里显示的九宫格用的是LeftEage、RightEage、TopEage、BottomEage,而不是2中的几个字段
字段名不一致容易写错的:
fbs字段名
编辑器字段
ClipEnabled
ClipAble
Scale9Enabled
Scale9Enable
TouchScaleEnable
TouchScaleChangeAble
flatc导出python时bool类型的默认值未生效,默认值全部都是false,一些默认值为true的会有问题,已手动修改
骨骼动画、粒子特效的结构描述竟然不在CSParseBinary.fbs里面,暂只整合进了SketonNode