前言:
介绍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 。