cocos2d-x 文本标签的用法

Cocos2d-x中标签类，标签类主要有三种：LabelTTF、LabelAtlas、LabelBMFont，此外，3.x推出新的标签类。

1、LabelTTF是使用系统中的字体，它是最简单的标签类，它是继承Node类，具有Node类的基本属性。

LabelTTF的其中一个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);

这里我大家解释下各个参数的作用：第一个参数是我们要显示的文本，他是一个字符串类型；第二个参数是我们字体文件的路径也是字符串类型；第三个参数是我们要显示字体的大小，是Size类型；第四个参数是指在屏幕上占用的区域大小，可省略；第五个参数是指文字横向对齐方式，也可省略；第六个参数是纵向对齐方式，可省略。

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

LabelAtlas比LabelTTF快很多。LabelAtlas中的每个字符必须有固定的高度和宽度。

static LabelAtlas* create(

const std::string& string,

const std::string& charMapFile,

int itemWidth,

int itemHeight,

int startCharMap);

同样的各个参数作用：第一个参数也是要显示的文本，第二个参数是文件名（包括文件路径，文件是图片集文件，格式.png）；第三、四个参数是该字体在图片集里的高度和宽度，第五个参数是图片集的开始字符。

3、LabelBMFont是位图字体标签，需要添加字体文件：暴扣一个图片集（.png）和一个字符坐标文件（.fnt）。LabelBMFont比LabelTTF快很多，LabelBMFont中的每个字符的宽度是可变的。

LabelBMFont是继承Node类，具有Node类的基本特性。

static LabelBMFont * create(

const std::string& str,

const std::string& fntFile,

float width = 0,

TextHAlignment alignment = TextHAlignment::LEFT,

const Vec2& imageOffset = Vec2::ZERO);

第一个参数是要显示的文本，第二个参数是fnt文件（包括路径），第三个参数是宽度，第四个是参数是横向对齐方式，第五个参数是字体色调。

除以上这三个比较常见的文本字体类外，我们cocos2d-x 的Label里还有一些常用的函数，通过这些方法我们也可以创建我们想要的字体，下面我们来介绍一下他们：

1、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);

这里我们就介绍下第三个参数，其他的参数上面有相同的，我就不介绍了，第三个参数是指改字体在屏幕中占用的大小。

2、Label创建TTF字体标签对象：

static Label * createWithTTF(

const std::string& text,

const std::string& fontFilePath,

float fontSize,

const Size& dimensions = Size::ZERO, TextHAlignment hAlignment = TextHAlignment::LEFT,

extVAlignment vAlignment = TextVAlignment::TOP);

参数介绍看上面的。

3、static Label* createWithTTF(

const TTFConfig& ttfConfig,

const std::string& text,

extHAlignment hAlignment = TextHAlignment::LEFT,

int maxLineWidth = 0);

其中：第一个参数是创建一个TTFConfig结构体变量

我们看看这个结构体的整体

_ttfConfig(

const std::string& filePath = "",

float size = 12,

const GlyphCollection& glyphCollection = GlyphCollection::DYNAMIC,

const char *customGlyphCollection = nullptr, bool useDistanceField = false,

int outline = 0)

第一个参数是字体文件路径

第二个参数是字体大小

第三个参数是字体库类型

第四个参数是自定义字体库

第五个参数是开启距离字段字体开关

第六个参数是字体描边。

4、Label创建BM标签对象

static Label* createWithBMFont(

const std::string& bmfontPath,

const std::string& text,

const TextHAlignment& hAlignment = TextHAlignment::LEFT,

int maxLineWidth = 0,

const Vec2& imageOffset = Vec2::ZERO);

参数介绍看上面。

好了，常用的创建文本的方法介绍的差不多了，在这里要跟大家说下，其实在Label里的上面这些创建文本方法都可以用Label的create方法代替，create重载了以上的四种方法，突然感觉create很强大。。。。