/TexturePacker-Fnt-Helper

这是一个使用TexturePacker合并BMFont图片后，自动修正位图描述文件的工具

Primary LanguageJavaMIT LicenseMIT

TexturePacker-Fnt-Helper

1. 项目说明

将字体位图图片和正常游戏精灵图片，通过TexturePacker打包为一个图集的时候，一般会输出

  • *.png: 合并后的图集图片
  • *.plist: 一个描述如何从图集图片中获取到原始图片的描述性文件

而原始字体的位图图片是由下面两个文件组成

  • *.png: 位图的图集图片
  • *.fnt: 一个描述如何从位图图集图片中获取到原始文字的描述性文件

因为合并之后，字体位图图片一般会发生偏移，因此通过原来的 *.fnt 文件，将不能在合并后的图集图片中获取到正确的文字位置，因为合并后的字体图集图片在新的图集中，位置是发生了偏移的，可能不在是 (0, 0) 作为其起点坐标了。

本工具为修正 *.fnt 文件得出一个新的修正偏移量的 *_fix.fnt 文件，通过这个新的 *_fix.fnt 文件就可以从新的图集图片中正确解析出位图文字

2. 工具使用说明

  1. 安装 Java 8+

  2. 下载本项目

    git clone git@github.com:zhitaocai/TexturePacker-Fnt-Helper.git

  3. 进入本项目目录执行下面命令即可

    java -jar FntHelper.jar xxx/xxx.fnt 100 100

* 参数一：fnt原始文件路径
* 参数二：x偏移量（暂时需要自己查看 .plist 文件去获取）
* 参数三：y偏移量（暂时需要自己查看 .plist 文件去获取）

    执行上述命令之后会在原来的 *.fnt 文件同目录下生成一个新的 *_fix.fnt 文件

3. 详细使用示例说明

  1. 将位图和其他图片打包成图集

打包后

  1. 使用上面工具命令后，将会生成新的 .fix.fnt 文件，其中，命令中的参数二和参数三获取方式如下：

然后会生成一个 .fix.fnt 文件

  1. 把这个3个文件拖入到场景，此时会提示报错，因为我们 .fix.fnt 文件所指向的原始位图文件还是 红色字体.png，此时我们要修改这个指向为我们新的图集文件名字 atlas.png（当然你可以是顺手修改位图文件名），最后效果如下：

  1. 最后演示如下

4. 支持我吧

如果我的项目对你起到帮助，不妨支持一下我吧~

🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏

5.参考文献

LICENSE

MIT License

Copyright (c) 2019 Zhitao Cai

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.