cocos2dx引擎使用plist文件, 一種特殊的xml格式作為其atlas紋理的描述文件. plist遵循蘋果的xml中key-value的設計風格.對于OC來說是合適的, 但xml本身性能低下, 垃圾內容過多, 也讓plist對于高性能游戲引擎不再適合. 因此, 研究TexturePacker的導出插件技術
TexturePacker的自定義插件目錄位于其安裝目錄的bin\exporters\下, 但有一些插件屬于內建支持, 例如cocos2dx的plist格式, 因此無法找到對應插件
本人參考shiva3d插件, 對應導出界面的DataFormat中的Shiva3D, 快速學會了如何導出
官方文檔位于http://www.codeandweb.com/texturepacker/documentation/#customization
插件的基本格式及原理是:
bin\exporters\下的某一目錄下存在的一個名為exporter.xml文件作為插件的描述,例如:
<exporter version="1.0">
<!-- identifier of the exporter -->
<name>shiva3d</name>
<!-- display name of the exporter for the combo box -->
<displayName>Shiva3D</displayName>
<!-- description of the exporter -->
<description>Exporter for Shiva3D.</description>
<!-- exporter version -->
<version>1.0</version>
<!-- currently only one file allowed - more to come with update -->
<files>
<file>
<!-- name of this file variable -->
<name>xml</name>
<!-- human readable name (for GUI) -->
<displayName>XML</displayName>
<!-- file extension for the file -->
<fileExtension>xml</fileExtension>
<!-- name of the template file -->
<template>shiva.xml</template>
</file>
</files>
<!-- target framework supports trimming -->
<supportsTrimming>false</supportsTrimming>
<!-- target framework supports rotated sprites -->
<supportsRotation>true</supportsRotation>
<!-- rotated sprites direction (cw/ccw) -->
<rotationDirection>cw</rotationDirection>
<!-- supports npot sizes -->
<supportsNPOT>true</supportsNPOT>
<!-- supports file name stripping (remove .png etc) -->
<supportsTrimSpriteNames>yes</supportsTrimSpriteNames>
<!-- supports texure subpath -->
<supportsTextureSubPath>yes</supportsTextureSubPath>
</exporter>
在Template字段中, 描述同目錄的導出文件格式模板. TexturePacker使用一種叫Grantlee的模板引擎,類似于Python使用的Django模板引擎, 文檔參見:Grantlee Documentation. 簡單的文本格式可以參考shiva.xml快速學會
這里我們使用protobuf的文本格式(極為類似json)導出plist, 下面是導出模板
{% for sprite in allSprites %}Sprite { Name: "{{sprite.trimmedName}}" FrameX: {{sprite.frameRect.x}} FrameY: {{sprite.frameRect.y}} FrameWidth: {{sprite.frameRectWithoutRotation.width}} FrameHeight: {{sprite.frameRectWithoutRotation.height}} OffsetX: {{sprite.cornerOffset.x}} OffsetY: {{sprite.cornerOffset.y}} OriginalWidth: {{sprite.untrimmedSize.width}} OriginalHeight: {{sprite.untrimmedSize.height}} {% if sprite.rotated %}Rotated: true {% endif %}}
{% endfor %}導出的結果類似于:
Sprite { Name: "car01"
FrameX: 100
FrameY: 129
FrameWidth: 76
FrameHeight: 47
OffsetX: 0
OffsetY: 0
OriginalWidth: 76
OriginalHeight: 47
Rotated: true
}
Sprite { Name: "car02"
FrameX: 100
FrameY: 51
FrameWidth: 76
FrameHeight: 47
OffsetX: 0
OffsetY: 0
OriginalWidth: 76
OriginalHeight: 47
Rotated: true
}
...
導出插件還支持js擴展, 具體內容請繼續參考官方文檔, 但對于簡單的文本格式, 這種方式已經足夠了
對比plist后, 發現plist中的垃圾信息極為多, 而且作為spriteframe的name居然帶有擴展名... 因此脫離plist,編寫自己的導出插件才是王道!