在Cocos2d-x中要显示文字就需要用到Label控件。在3.x版本的Cocos2d中,舍弃了之前版本所使用的LabelTTF、LabelAtlas、LabelBMFont 3个用于显示文字的类,而使用一个新类Label取代。可想而知,Label实际上就是对之前3个类进行重新封装并统一渲染。
下面是在Cocos2d-x中显示文字的一个例子,具体完整项目可在源文件本章目录下找到项目ChapterThree01查看。
autolabel1=Label::create("thisisthefirstlabel","Arial",36,Size::ZERO,TextHAlignment::LEFT,TextVAlignment::TOP);//创建标签 label1->setPosition(210,310);//设置标签位置 addChild(label1);//加入到场景中 //通过TTFConfig在标签中使用自定义字体 TTFConfigttfconfig("fonts/chunkmuffinhollowwide.ttf",36);//创建TTFConfig对象 autolabel2=Label::createWithTTF(ttfconfig,"thisisthesecondlabel");//创建标签 label2->setPosition(270,250);//设置标签位置 addChild(label2);//将标签加入到场景中 //使用createWithTTF方法创建使用自定义字体的标签 autolabel3=Label::createWithTTF("thisisthethirdlabel","fonts/MarkerFelt.ttf",36); label3->setPosition(200,190); addChild(label3);//将标签加入到场景中 //为标签加入阴影和边框效果 autolabel4=Label::createWithTTF("thisisthefourthlabel",36); label4->setPosition(280,130);//设置标签位置 label4->enableShadow(Color4B::GREEN,Size(5,5));//设置阴影效果 label4->enableOutline(Color4B::RED,3);//设置边框效果 addChild(label4);//将标签加入到场景中 //创建带发光效果的标签 autolabel5=Label::createWithTTF("thisisthefifthlabel",36); label5->setPosition(200,70);//设置标签位置 label5->enableGlow(Color4B::GREEN);//设置光效 addChild(label5);//将标签加入到场景中
运行之后的效果如图3-1所示。
在一般情况下想要在屏幕上输出一行文字只需要按照第01~04行的方法来创建一个标签,然后再将它加入到场景中去就可以了。最简单的创建标签的方法如范例第01~02行所示,其中create方法的6个参数含义分别是:
l标签字体
l标签尺寸
这看上去有点复杂,实在配不上“最简单”的创建方法,所以一般在使用时可以进一步简化,仅保留前3项参数,比如本范例第01行就可以改写成:
auto label1 = Label::create("this is the first label",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行为文字加入的外发光效果只有一个参数,那就是光效的颜色。