Cocos2dx 3.0 -- 有freeType做靠山的Label
cocos2dx 3.0版本之前，我们一直都是用CCLabelTTF，CCLabelBMFont,CCLabelAtlas来创建文本标签，但是！3.0版本放出来后...看到这里你心里是不是又颤抖了一下？别害怕嘛，我要说的是：3.0版本出来后这些标签也都是还可以用的啦，只是说我们有了更好的选择。
cocos2dx3.0添加了一种新的文本标签，这种标签不同的地方有： 使用freetype来使它在不同的平台上有相同的视觉效果；由于使用更快的缓存代理，它的渲染也将更加快速；同时它还提供了绘边、阴影等特性。
所以因为Label，我决定离开LabelTTF和LabelBMFont（这个开头你猜到了么？）
---------------------------------------------------
常用的接口一览（因为很多接口都与LabelTTFT等一样，所以就列一些我所了解的“异类”）
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
|
//创建普通的文本标签，效果和CCLabelTTF::create(...);一样。TTFConfig是什么？下面会介绍
static
Label * create(
const
std::string& text,
const
std::string& fontName,
float
fontSize,
const
Size& dimensions = Size::ZERO, TextHAlignment hAlignment = TextHAlignment::LEFT,
TextVAlignment vAlignment = TextVAlignment::TOP);
//通过读取TTFConfig配置的方式创建标签，
static
Label* createWithTTF(
const
TTFConfig& ttfConfig,
const
std::string& text, TextHAlignment alignment = TextHAlignment::LEFT,
int
lineWidth = 0);
//使用.fnt的方式创建标签，类似CCLabelBMFont:create();
static
Label* createWithBMFont(
const
std::string& bmfontFilePath,
const
std::string& text,
const
TextHAlignment& alignment = TextHAlignment::LEFT,
int
lineWidth = 0,
const
Point& imageOffset = Point::ZERO);
//使用.png的方式创建标签，类似CCLabelAtlas::create();
static
Label * createWithCharMap(
const
std::string& charMapFile,
int
itemWidth,
int
itemHeight,
int
startCharMap);
virtual
void
enableShadow(
const
Color3B& shadowColor = Color3B::BLACK,
const
Size &offset = Size(2,-2),
float
opacity = 0.75f,
int
blurRadius = 0);
virtual
void
enableOutline(
const
Color4B& outlineColor,
int
outlineSize = -1);
//只支持TTF
virtual
void
enableGlow(
const
Color3B& glowColor);
//只支持 TTF
virtual
void
disableEffect();
//取消所有特效
//特效的种类有一下四种：
enum
class
LabelEffect {
NORMAL,
//普通标签（纯粹的、脱离了低级趣味的label）
OUTLINE,
//文艺标签（有描边）
SHADOW,
//2B标签 （有阴影）
GLOW
//土豪标签（有荧光）
};
|
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
|
//TTFConfig 是一个结构体，里面包含了你要创建一个ttf的label常用配置，如下所示
typedef
struct
_ttfConfig
{
std::string fontFilePath;
//文件路径
int
fontSize;
//字体大小，默认12
GlyphCollection glyphs;
//使用的字符集，默认DYNAMIC
const
char
*customGlyphs;
//呵呵
bool
distanceFieldEnabled;
//我对这个的理解是：是否让文字显得紧凑？默认为false
int
outlineSize;
//字体描边的大小，默认为0
//构造函数
...
//注意：当outlineSize初始化的值大于0时，distanceFieldEnabled则为false
}TTFConfig;
//GlyphCollection有四种类型：
enum
class
GlyphCollection {
DYNAMIC,
NEHE,
ASCII,
CUSTOM
};
|
1、使用.ttf
1）创建
复制代码
|
当然了，也可以用Label创建普通的标签，效果和用CCLabelTTF::create()的一样
复制代码
|
2）另字体看起来紧凑点，也就是设置distanceFieldEnabled = true
直接修改config里的distanceFieldEnabled，方式如下：
复制代码
|
3）设置glow（荧光）效果，（我也不知道该怎么描述glow这词...）
复制代码
|
4）设置描边
复制代码
|
效果如图所示。注意， 使用描边效果后，distanceFieldEnabled 将变成 false，这也意味着在有描边的情况下是显示不了荧光效果的（我想太多了...)
5）设置阴影
复制代码
|
2、使用.fnt 的label
1）创建
复制代码
|
2）设置阴影（描边和荧光只能用在.ttf 上）
复制代码
|
效果如图，可以与上图对比一下。
3、使用.png
加入我们有这么一张图，使用方法如下：
1）创建
复制代码
|
2）设置阴影
复制代码
|
4、取消所有特效
复制代码
|
恩，就介绍到这里。具体的用法可以参考testCpp。