New Label of Cocos2d-x v3.0
What's new of Label in Cocos2d-x v3.0?
- Deprecated
cclabelTTF,cclabelBMFont,cclabelAtlas. There is only one classLabelsince Cocos2d-x v3.0. - Glow， shadow and outline effects supported.
- Using
freetype2to generate texture for labels,which improve the speed of creating fonts and make sure that labels have the same effect on different platforms.
How to use new Label?
Create with SystemFont
createWithSystemFont() will call the native API by the platform-dependent code. The first 3 parameters are necessaries and the rest would have a default value if they were omitted.
1 2 3 |
/** Creates a label with an initial string,font[font name or font file],font size,dimension in points,horizontal alignment and vertical alignment. **/ 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); |
Create with TTF
CreateWithTTF() uses libfreetype2 to create the fonts. It would save each char of the strings to the cache that improve the speed of creating fonts. There are two ways to create a LabelTTF bellows:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 |
//First way to create a LabelTTF by TTF files auto label = Label::createWithTTF("label test","fonts/Marker Felt.ttf",32); label->setPosition(Point(size.width/2,size.height*0.6)); this->addChild(label); //Second way to create a LabelTTF by TTFconfig TTFConfig label_config; //Set the TTF file of TTFConfig,this attribute should not be omitted label_config.fontFilePath = "fonts/Marker Felt.ttf"; label_config.fontSize = 32; //Choose the glyhps,which includes DYNAMIC,NEHE,ASCII and CUSTOM Now label_config.glyphs = GlyphCollection::DYNAMIC; //Set the customGlyphs to null since here we don't use the custom glyphs. label_config.customGlyphs = nullptr; //Open or not open distanceField label_config.distanceFieldEnabled = false; label_config.outlinesize = 0; //create the LabelTTF through the label config auto label_two = Label::createWithTTF(label_config,"label test"); label_two->setPosition(Point(size.width/2,size.height*0.5)); this->addChild(label_two); |
To kNow what is distanceField， read this paper Distance-field-fonts
Create with BMFont
To create a label with FNT file,we have createWithBMFont()
1 2 3 |
//Create a BMFont label,the first parameter is the fnt file,second is your text. The chars of your string should be included in your fnt files,or it can't display nomally. auto bmfont = Label::createWithBMFont("fonts/gameover_score_num.fnt","123456789"); |
Create with CharMap
The createWithCharMap() represents the cclabelAtlasin the past. It has a simpler rule compare to the BMFont. It is common used in the number fonts. We have 3 overrided functions in Cocos2d-x v3.0 above to create with char map.
//创建charMap 参数分别为：png图片的路径，每个字符的宽和高，起始字符
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
// 3 ways to create with char map,according to the 'cclabel.h' static Label * createWithCharMap(const std::string& charMapFile,int itemWidth,int itemHeight,int startCharMap); static Label * createWithCharMap(Texture2D* texture,int startCharMap); static Label * createWithCharMap(const std::string& plistFile); //create a label with char map. //parameters: PNG picture,width,height,the first char. auto charMap = Label::createWithCharMap("fonts/tuffy_bold_italic-charmap.png",48,64,' '); charMap->setPosition(Point(size.width/2,size.height*0.4)); charMap->setString("123456789"); this->addChild(charMap); //You can also create the char map by a plist auto charMap2 = Label::createWithCharMap("fonts/tuffy_bold_italic-charmap.plist"); charMap2->setPosition(Point(Point(size.width/2,size.height*0.3))); charMap2->setString("123456789"); this->addChild(charMap2); |
Glow,shadow and outline effects
1 2 3 4 5 6 7 8 |
//Outline effect,only support for TTF label_two->enableOutline(Color4B(255,0,255),5); //Glow effect,only support for TTF and the distanceFieldEnabled must be true label_three->enableGlow(Color4B(255,255)); //Shadow effect label_four->enableShadow(Color4B(0,255,Size(3,10),0); |
