cocos2d-x实战 C++卷 学习笔记--第4章 使用标签

前言：

介绍cocos2d-x中 标签类。

cocos2d-x中 标签类 主要有三种：LabelTTF, LabelAtlas, 和 LabelBMFont。此外，在Cocos2d-x 3.x之后推出了 新的标签类 Label。

LabelTTF 标签类

LabelTTF是使用系统中的字体，它是最简单的标签类。

create 静态函数完整定义：（此处只介绍一种常用的 create 静态方法）

 static LabelTTF * create(const std::string& string,
       const std::string& fontName,
       float fontSize,
       const Size& dimensions = Size::ZERO,
       TextHAlignment hAlignment = TextHAlignment::CENTER,
       TextVAlignment vAlignment = TextVAlignment::TOP);

create函数的第1个参数是要显示的文字，第2个参数是系统字体名，第3个参数是字体的大小。后面省略了三个参数。

示例：

     /////////// 4.2.1  LabelTTF
     LabelTTF* labelOne = LabelTTF::create();
     labelOne->setPosition(Point(origin.x + visibleSize.width / 2,     //// 字体居中显示
         origin.y + visibleSize.height - labelOne->getContentSize().height));
     );

LabelAtlas 标签类

LabelAtlas 是图片集标签，其中的 Atlas 本意是“地图集”、“图片集”，这种标签显示的文字是从一个图片集中取出的，因此使用LabelAtlas需要额外加载图片集文件。

LabelAtlas 比 LabelTTF快很多。

LabelAtlas 中的每个字符必须有固定的高度和宽度。

create 静态函数完整定义：

     static LabelAtlas* create(const std::string& string,
         const std::string& charMapFile,
         int itemWidth,
         int itemHeight,
         int startCharMap);

create 函数的第1个参数是要显示的文字，第2个参数是图片集文件，第3个参数是字符宽度，第4个参数是字符高度，第5个参数是开始字符。

示例：

     ///////////// 4.2.2  LabelAtlas
     //创建 并初始化标签
     auto labelTwo = LabelAtlas::create(, , ' ');
     labelTwo->setPosition(Point(origin.x + visibleSize.width / 2 - labelTwo->getContentSize().width/2,  //// 字体居中显示
         origin.y + visibleSize.height - labelTwo->getContentSize().height * ));
 //    labelTwo->setAnchorPoint(ccp(0.5, 0.5));
     );

注意：在 LabelAtlas 创建在字体中，anchorPoint默认好像是ccp(0,0) 的。你可以创建 LabelAtlas 字体 验证验证。

LabelBMFont 标签类

LabelBMFont是位图字体标签，需要添加字体文件：包括一个图片集（.png）和一个字符坐标文件（.fnt）。

LabelBMFont 比 LabelTTF 快很多。

LabelBMFont 中的每个字符的宽度是可变的。

create 静态函数完整定义：

     static LabelBMFont * create(const std::string& str,
         const std::string& fntFile,
         ,
         TextHAlignment alignment = TextHAlignment::LEFT,
         const Point& imageOffset = Point::ZERO);

create 函数第1个参数是要显示的文字，第2个参数是图片集文件（.fnt）。

示例：

     ///// 4.2.3   LabelBMFont
     auto labelThree = LabelBMFont::create("hello LabelBMFont", "Demo3/BMFont.fnt");
     labelThree->setPosition(Point(origin.x + visibleSize.width / 2 ,
         origin.y + visibleSize.height - labelThree->getContentSize().height * ));
     );

Cocos2d-x 3.x 标签类 Label

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

     static Label* createWithSystemFont(const std::string& text,   /// 要显示的文字
         const std::string& font,       /// 系统字体名
         float fontSize,                /// 字体的大小
         const Size& dimensions = Size::ZERO,  /// 在屏幕上占用区域的大小，可以省略
         TextHAlignment hAlignment = TextHAlignment::LEFT,  /// 文字横向对齐方式，可以省略
         TextVAlignment vAlignment = TextVAlignment::TOP);  /// 文字纵向对齐方式 ，可以省略

createWithSystemFont 示例：

通过 createWithSystemFont 函数创建 Label 对象

     auto label1 = Label::createWithSystemFont();
     label1->setPosition(Point(origin.x + visibleSize.width / , origin.y + visibleSize.height - label1->getContentSize().height));
     );

     static Label * createWithTTF(const std::string& text,
         const std::string& fontFile,   /// 字体文件
         float fontSize,
         const Size& dimensions = Size::ZERO,
         TextHAlignment hAlignment = TextHAlignment::LEFT,
         TextVAlignment vAlignment = TextVAlignment::TOP);

createWithTTF 示例：

通过 createWithTTF 创建 TTF 字体标签对象

     auto label2 = Label::createWithTTF();
     label2->setPosition(Point(origin.x + visibleSize.width / , origin.y + visibleSize.height - ));
     );

     static Label* createWithTTF(const TTFConfig& ttfConfig,
         const std::string& text,
         TextHAlignment alignment = TextHAlignment::LEFT,
         );

createWithTTF 示例：

通过 指定的 TTFConfig 创建 TTF 字体标签对象

     TTFConfig ttfConfig(, GlyphCollection::DYNAMIC);
     auto label3 = Label::createWithTTF(ttfConfig, "Hello Label3");
     label3->setPosition(Point(origin.x + visibleSize.width / , origin.y + visibleSize.height - ));
     );
     ttfConfig.outlineSize = ;
     auto label4 = Label::createWithTTF(ttfConfig, "hello Label4");
     label4->setPosition(Point(origin.x + visibleSize.width / , origin.y + visibleSize.height - ));
     label4->, , , ), Size(, -));
     label4->setColor(Color3B::RED);
     );

     static Label* createWithBMFont(const std::string& bmfontFilePath,
         const std::string& text,
         const TextHAlignment& alignment = TextHAlignment::LEFT,
         ,
         const Point& imageOffset = Point::ZERO);

示例：

通过 createWithBMFont 创建位图字体标签对象

     auto label5 = Label::createWithBMFont("Demo3/BMFont.fnt", "Hello Label5");
     label5->setPosition(Point(origin.x + visibleSize.width / , origin.y + visibleSize.height - ));
     );

补充说明：

Size visibleSize = Director::getInstance()->getVisibleSize();
Point origin = Director::getInstance()->getVisibleOrigin();

标签中文乱码问题：

     auto testLabel1 = LabelTTF::create();
     testLabel1->setPosition(Point(origin.x + visibleSize.width / , origin.y + visibleSize.height - ));
     );
 
     auto testLabel2 = LabelBMFont::create("中国2", "bitmapFontChinese.fnt");
     testLabel2->setPosition(Point(origin.x + visibleSize.width / , origin.y + visibleSize.height - ));
     );
 
     auto testLabel3 = Label::createWithBMFont("bitmapFontChinese.fnt", "中国3");
     testLabel3->setPosition(Point(origin.x + visibleSize.width / , origin.y + visibleSize.height - ));
     );
 
     TTFConfig ttfConfig(, GlyphCollection::DYNAMIC);
     auto testLabel4 = Label::createWithTTF(ttfConfig, "晚上好！", TextHAlignment::CENTER, visibleSize.width);
     testLabel4->setPosition(Point(origin.x + visibleSize.width / , origin.y + visibleSize.height - ));
     );

在windows中文环境下使用Visual Studio创建的源程序文件是采用 GBK 编码。

解决方法：

方法1：在Visual Studio工具中选择【文件】-->【高级保存】，选择【Unicode(UTF-8无签名) - 代码页 65001】，单击确定按钮保存。

方法2：用记事本打开文件，另存为 UTF-8 。