Torque2D MIT 学习笔记(27) ---- ImageFont的使用以及字体ImageAsset的工具生成

时间：2023-02-20 19:04:32

前言

　　ImageFont继承于SceneObject,是一个场景对象,支持例如旋转,缩放,移动加速度以及物理碰撞等一切Torque中场景对象的一切功能.

　　ImageFont只支持ASCII编码表中的32-127这么96个字符,字符的表现是通过一个ImageAsset文件配合一个对应的PNG图片来完成的.

　　ImageAsset中的帧序列与32-Char的结果对应,从而完成渲染.

问题

　　目前主流的字体生成器都没有支持Torque的格式导出,所以想自己做一款字体就比较麻烦.当然你可以去找图,毕竟原理上面已经说了,只要满足就可以.

　　这里我说一种使用BitmapFont工具来生成,然后通过TorqueScript写的工具来做一次转换得到相应的Taml资产格式.

步骤

　　BitMapFont

　　　　　　免费软件,下载直接使用.

　　　　　　勾选32-126的字符:

　　　　　　Torque2D MIT 学习笔记(27) ---- ImageFont的使用以及字体ImageAsset的工具生成

　　　　　　选择字体和导出选项:

　　　　　　Torque2D MIT 学习笔记(27) ---- ImageFont的使用以及字体ImageAsset的工具生成Torque2D MIT 学习笔记(27) ---- ImageFont的使用以及字体ImageAsset的工具生成

　　　　　　保存文件并拷贝到Torque执行文件目录,比如生成的文件叫做: testFont.fnt testFont_0.png　　　　　　

　　脚本实现　　　　　　

// 转换

function BMFontToImageAsset( %fnt_file, %asset_file, %asset_name, %asset_image )

{

	// 文件读取

	%document = new SimXMLDocument();

	if( !%document.loadFile( %fnt_file ) )

	{

		echo( "BMFontToImageAsset.Failed.BadFntFile:" SPC %fnt_file );

		return false;

	}

	// 节点寻找失败

	if( !%document.pushFirstChildElement("font") )

	{

		echo( "BMFontToImageAsset.Failed.BadFntFile:" SPC %fnt_file );

		return false;

	}

	// 节点寻找失败

	if( !%document.pushFirstChildElement("chars") )

	{

		echo( "BMFontToImageAsset.Failed.BadFntFile:" SPC %fnt_file );

		return false;

	}

	// 节点寻找失败

	if( !%document.pushFirstChildElement("char") )

	{

		echo( "BMFontToImageAsset.Failed.BadFntFile:" SPC %fnt_file );

		return false;

	}

	%savexml = new SimXMLDocument();

	%savexml.pushNewElement( "ImageAsset" );

	%savexml.setAttribute( "AssetName", %asset_name );

	%savexml.setAttribute( "ImageFile", %asset_image );

	%savexml.pushNewElement( "ImageAsset.Cells" );

	// 循环查找32-127之间的ASCII字符信息

	while( true )

	{

		%id = %document.attribute("id");

		// 不合法跳过

		if( %id < 32 || %id >= 127 )

		{

			echo( "BMFontToImageAsset.Failed.InvalidChar:" SPC %fnt_file );

			continue;

		}

		// 属性取得

		%x = %document.attribute("x");

		%y = %document.attribute("y");

		%width = %document.attribute("width");

		%height = %document.attribute("height");

		echo( "Char: x=" @ %x SPC "y=" @ %y SPC "width=" @ %width SPC "height=" @ %height );

		%savexml.pushNewElement( "Cell" );

		%savexml.setAttribute( "Offset", %x SPC %y );

		%savexml.setAttribute( "Width", %width );

		%savexml.setAttribute( "Height", %height );

        %savexml.popElement();

		// 寻找下个字符

		if( !%document.nextSiblingElement("char") )

			break;

	}

	// FNT文件关闭

	%document.clear();

	%document.delete();

    // FNT中的字符数量应该是32-126,95个,不够96个字符,如果不够ImageFont是无法创建的.

    %savexml.pushNewElement( "Cell" );

    %savexml.setAttribute( "Offset", "1 1" );

    %savexml.setAttribute( "Width", 1 );

    %savexml.setAttribute( "Height", 1 );

	// ImageAsset格式文件保存

	%savexml.popElement();

	%savexml.saveFile( %asset_file );

	%savexml.delete();

	return true;

}

　　格式转换

　　　　　　在控制台中输入: BMFontToImageAsset( "testFont.fnt", "FontConsolas48.asset.taml", "FontConsolas48", "FontConsolas48.png" )

　　　　　　会在同级目录生成FontConsolas48.asset.taml文件,PNG自己改名字就可以了

　　　至于ImageFont的具体使用,参考自带的字体Toy即可,这里不再多说.

结语

　　BMFont的导出格式中还有很多的参数,有兴趣的朋友可以继续研究.再见~

相关文章