在Cocos2d-x中要显示文字就需要用到Label控件。在3.x版本的Cocos2d中,舍弃了之前版本所使用的LabelTTF、LabelAtlas、LabelBMFont 3个用于显示文字的类,而使用一个新类Label取代。可想而知,Label实际上就是对之前3个类进行重新封装并统一渲染。
提示:实际上老版本的内容在3.x版本中依然是可以使用的。
下面是在Cocos2d-x中显示文字的一个例子,具体完整项目可在源文件本章目录下找到项目ChapterThree01查看。
【范例3-1 在Cocos2d-x中显示文字】
auto label1 = Label::create("this is the first label","Arial",36, Size::ZERO,TextHAlignment::LEFT,TextVAlignment::TOP); //创建标签 label1->setPosition(210, 310); //设置标签位置 addChild(label1); //加入到场景中 //通过TTFConfig在标签中使用自定义字体 TTFConfig ttfconfig("fonts/chunkmuffinhollowwide.ttf", 36); //创建TTFConfig对象 auto label2 = Label::createWithTTF(ttfconfig,"this is the second label"); //创建标签 label2->setPosition(270,250); //设置标签位置 addChild(label2); //将标签加入到场景中 //使用createWithTTF方法创建使用自定义字体的标签 auto label3 = Label::createWithTTF("this is the third label","fonts/Marker Felt.ttf",36); label3->setPosition(200, 190); addChild(label3); //将标签加入到场景中 //为标签加入阴影和边框效果 auto label4 = Label::createWithTTF("this is the fourth label", "fonts/Marker Felt.ttf", 36); label4->setPosition(280,130); //设置标签位置 label4->enableShadow(Color4B::GREEN, Size(5, 5)); //设置阴影效果 label4->enableOutline(Color4B::RED, 3); //设置边框效果 addChild(label4); //将标签加入到场景中 //创建带发光效果的标签 auto label5 = Label::createWithTTF("this is the fifth label", "fonts/Marker Felt.ttf", 36); label5->setPosition(200, 70); //设置标签位置 label5->enableGlow(Color4B::GREEN); //设置光效 addChild(label5); //将标签加入到场景中
运行之后的效果如图3-1所示。
图3-1 在屏幕上显示不同效果的标签
在一般情况下想要在屏幕上输出一行文字只需要按照第01~04行的方法来创建一个标签,然后再将它加入到场景中去就可以了。最简单的创建标签的方法如范例第01~02行所示,其中create方法的6个参数含义分别是:
l 标签中所显示文字的内容
l 标签字体
l 标签内容字体大小
l 标签尺寸
l 标签中文字在横向和纵向的对齐方式
这看上去有点复杂,实在配不上“最简单”的创建方法,所以一般在使用时可以进一步简化,仅保留前3项参数,比如本范例第01行就可以改写成:
auto label1 = Label::create("this is the first label","Arial",36);
显示的文字如图3-1第一行所示,所以说在Cocos2d中显示文字是非常容易的。然而不能忘记的是,学习Cocos2d的目的主要还是为了做游戏,这样单调的文字自然是远远不能适应游戏的需要,所以就需要在标签中使用更加个性化的字体。
在Cocos2d 2.x版本中,可以使用LabelTTF类创建标签来使用TTF格式的字体,然而在Cocos2d 3.x中由于LabelTTF被取消(实际仍然可以使用),就要考虑使用其他办法来显示自定义字体。目前主要有两种方法:
l 一种是通过TTFConfig配置来创建,如范例第06~09行所示;
l 另一种是使用createWithTTF方法创建使用TTF字体的标签,如范例第11~13行所示。
这两种方法从本质上来说都是从资源目录下读取TTF格式的字体文件,可以在项目目录下找到Resources|fonts文件夹,将从网上下载的字体文件存放在这里。
为了让字体具有更强大的视觉冲击力,还可以给文字加入阴影和边框以及外发光的效果。如范例第17行就是给标签加入阴影,其中Color4B::GREEN是阴影的颜色而Size(5, 5)是阴影相对于文字的相对位置。第18行则是用来设置文字边框的,两个参数分别用来设置边框颜色和宽度。第23行为文字加入的外发光效果只有一个参数,那就是光效的颜色。