Cocos2d-x 3.0标签类Label

时间：2023-03-09 09:13:54
Cocos2d-x 3.0标签类Label

Cocos2d-x 3.0后推出了新的标签类Label，这种标签通过使用FreeType[1]来使它在不同的平台上有相同的视觉效果。由于使用更快的缓存代理，它的渲染也将更加快速。Label提供了描边和阴影等特性。

Label类的类图如下图所示：

Cocos2d-x 3.0标签类Label

创建Label类静态create函数常用的有如下几个：

  1. static Label* createWithSystemFont(conststd::string &text,             //是要显示的文字
  2. const std::string& font,                                                       //系统字体名
  3. float fontSize,                                                            //字体的大小
  4. const Size& dimensions = Size::ZERO,                            //在屏幕上占用的区域大小,可省略
  5. TextHAlignment  hAlignment = TextHAlignment::LEFT,          //文字横向对齐方式,可省略
  6. TextVAlignment  vAlignment = TextVAlignment::TOP)   //文字纵向对齐方式,可省略
  7. static Label* createWithTTF(conststd::string & text,
  8. const std::string &  fontFile,                                                              //字体文件
  9. float fontSize,
  10. const Size &  dimensions = Size::ZERO,                                           //可省略
  11. TextHAlignment          hAlignment= TextHAlignment::LEFT,          //可省略
  12. TextVAlignment           vAlignment= TextVAlignment::TOP              //可省略
  13. )
  14. static Label* createWithTTF(constTTFConfig& ttfConfig,
  15. const std::string& text,
  16. TextHAlignment alignment =TextHAlignment::LEFT,
  17. int maxLineWidth = 0
  18. )
  19. static Label* createWithBMFont(conststd::string& bmfontFilePath,          //位图字体文件
  20. const std::string&  text,
  21. const TextHAlignment& alignment =TextHAlignment::LEFT, //可省略
  22. int maxLineWidth = 0,                                                                       //可省略
  23. const Point&  imageOffset = Point::ZERO                                //可省略
  24. )

其中createWithSystemFont是创建系统字体标签对象，createWithTTF是创建TTF字体标签对象，createWithBMFont是创建位图字体标签对象。

下面我们通过一个实例介绍一下，它们的使用。这个实例如图下图所示。

Cocos2d-x 3.0标签类Label

下面我们看看HelloWorldScene.cpp中init函数如下：

  1. bool HelloWorld::init()
  2. {
  3. if ( !Layer::init() )
  4. {
  5. return false;
  6. }
  7. Size visibleSize = Director::getInstance()->getVisibleSize();
  8. Point origin = Director::getInstance()->getVisibleOrigin();
  9. auto closeItem = MenuItemImage::create(
  10. "CloseNormal.png",
  11. "CloseSelected.png",
  12. CC_CALLBACK_1(HelloWorld::menuCloseCallback, this));
  13. closeItem->setPosition(Point(origin.x+ visibleSize.width - closeItem->getContentSize().width/2 ,
  14. origin.y + closeItem->getContentSize().height/2));
  15. auto menu = Menu::create(closeItem, NULL);
  16. menu->setPosition(Point::ZERO);
  17. this->addChild(menu, 1);
  18. autolabel1 = Label::createWithSystemFont("Hello World1","Arial", 36);                                   ①
  19. label1->setPosition(Point(origin.x+ visibleSize.width/2,
  20. origin.y + visibleSize.height - 100));
  21. this->addChild(label1,1);
  22. autolabel2 = Label::createWithTTF("Hello World2", "fonts/MarkerFelt.ttf", 36);                       ②
  23. label2->setPosition(Point(origin.x+ visibleSize.width/2,
  24. origin.y + visibleSize.height - 200));
  25. this->addChild(label2,1);
  26. autolabel3 = Label::createWithBMFont("fonts/BMFont.fnt", "HelloWorld3");                            ③
  27. label3->setPosition(Point(origin.x+ visibleSize.width/2,
  28. origin.y + visibleSize.height - 300));
  29. this->addChild(label3,1);
  30. TTFConfigttfConfig("fonts/Marker Felt.ttf",
  31. 36,
  32. GlyphCollection::DYNAMIC);                                                                                                  ④
  33. autolabel4 = Label::createWithTTF(ttfConfig, "Hello World4");                                                  ⑤
  34. label4->setPosition(Point(origin.x+ visibleSize.width/2,
  35. origin.y + visibleSize.height - 400));
  36. this->addChild(label4, 1);
  37. ttfConfig.outlineSize= 4;                                                                                                     ⑥
  38. autolabel5 = Label::createWithTTF(ttfConfig, "Hello World5");                                                  ⑦
  39. label5->setPosition(Point(origin.x+ visibleSize.width/2,
  40. origin.y + visibleSize.height - 500));
  41. label5->enableShadow(Color4B(255,255,255,128),Size(4, -4));                                        ⑧
  42. label5->setColor(Color3B::RED);                                                                                                 ⑨
  43. this->addChild(label5,1);
  44. return true;
  45. }

在上面的代码中第①是通过createWithSystemFont函数创建Label对象，第②行代码是通过createWithTTF是创建TTF字体标签对象，第③行代码是createWithBMFont是创建位图字体标签对象。

第④行代码TTFConfig ttfConfig("fonts/Marker Felt.ttf", 36, GlyphCollection::DYNAMIC)是创建一个TTFConfig结构体变量，TTFConfig结构体的定义如下：

  1. _ttfConfig(constchar* filePath = "",                                                                         //字体文件路径
  2. int  size = 12,                                                                                            //字体大小
  3. constGlyphCollection& glyphCollection = GlyphCollection::DYNAMIC,     //字体库类型
  4. constchar * customGlyphCollection = nullptr,                                     //自定义字体库
  5. booluseDistanceField = false,                                                                         //用户是否可缩放字体
  6. intoutline = 0                                                                                                      //字体描边
  7. )

第⑤行代码Label::createWithTTF(ttfConfig,"Hello World4")是通过指定TTFConfig创建TTF字体标签。第⑥行代码ttfConfig.outlineSize = 4设置TTFConfig的描边字段。第⑦行代码Label::createWithTTF(ttfConfig,"Hello World5")是重新创建TTF字体标签。

第⑧行代码label5->enableShadow(Color4B(255,255,255,128),Size(4, -4))是设置标签的阴影效果。第⑨行代码label5->setColor(Color3B::RED)是设置标签的颜色。

[1] FreeType库是一个完全免费（开源）的、高质量的且可移植的字体引擎，它提供统一的接口来访问多种字体格式文件。——引自于百度百科http://baike.baidu.com/view/4579855.htm

相关文章