cocos2dx3.4 Label

推荐整理分享cocos2dx3.4 Label，希望有所帮助，仅作参考，欢迎阅读内容。

文章相关热门搜索词:,内容如对您有帮助，希望把文章链接给更多的朋友！

创建一个空的Label，具体属性以后再设置

static Label* create();

使用系统API创建一个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 这个是字体名称或者字体文件，而这个是创建方式的第二个参数只能是字体文件 而不支持字体名称

Label* a = Label::createWithTTF("cocos2dx", "宋体", ); //这个创建方式会直接中断掉的a->setPosition(Point(, ));addChild(a);

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

和上一个创建方式和要求都一样，不同的是第一个参数要求为TTFConfig的结构体

TTFConfig config("fonts/Marker Felt.ttf",); auto label1 = Label::createWithTTF(config, "Hello Cocos2d-x");label1->setPosition(Point(size.width/2, size.height*0.8));addChild(label1);

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

通过静态字体文件创建文本的方式，参数为fnt文件和对应的png图片

&#;得注意的是：在2.x中，可以使用getChildByTag(i)来获取第i个字符，对其单独设置属性、动作等。在3.x中，则是使用getLetter(i)，而不再是getChildByTag(i)。static Label* createWithBMFont(const std::string& bmfontFilePath, const std::string& text, const TextHAlignment& alignment = TextHAlignment::LEFT, int maxLineWidth = 0, const Vec2& imageOffset = Vec2::ZERO);

这个是和2.x中Atlas形式创建对应的。不过这种有两种形式匹配图片中的文字，一种是直接设置每一块字体的宽高数&#;获取，另一种是通过fnt文件的方式，但原理都是一样的。 一般用来显示数字，渲染效率高

auto label4 = Label::createWithCharMap("fonts/tuffy_bold_italic-charmap.plist");label4->setPosition(Point(size.width / 2, size.height*0.2));addChild(label4);label4->setString("Cocos2d-x"); auto label4 = Label::createWithCharMap("fonts/tuffy_bold_italic-charmap.png",,,' ');label4->setPosition(Point(size.width / 2, size.height*0.2));addChild(label4);label4->setString("Cocos2d-x");

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

static Label * createWithCharMap(Texture2D* texture, int itemWidth, int itemHeight, int startCharMap);

static Label * createWithCharMap(const std::string& plistFile);

//改变字符串内容并重新渲染 //注：如果你没有为Label设置TTF/BMFont/CharMap，会产生很大的开销 virtual void setString(const std::string& text) override; virtual const std::string& getString() const override { return _originalUTF8String; } 设置文字颜色，仅支持TTF和System Font 注：区别 Node节点的颜色 Node ::setColor : Color3B Label::setTextColor : Color4B virtual void setTextColor(const Color4B &color); const Color4B& getTextColor() const { return _textColor; } 获取Label的某个字符 - getLetter - 不支持System Font

* 文字渲染效果 - Shadow : 阴影

- Outline : 轮廓，仅支持TTF

- Glow : 发光，仅支持TTF

对齐方式 > TextHAlignment : 水平对齐方式 - TextHAlignment:LEFT : 左对齐 - TextHAlignment:CENTER : 居中对齐，默认 - TextHAlignment:RIGHT : 右对齐 > TextVAlignment : 垂直对齐方式

- TextVAlignment::TOP : 顶部，默认 - TextVAlignment::CENTER : 中心 - TextVAlignment::BOTTOM : 底部**/ //设置对齐方式 void setAlignment(TextHAlignment hAlignment) { setAlignment(hAlignment,_vAlignment);} void setAlignment(TextHAlignment hAlignment,TextVAlignment vAlignment); TextHAlignment getTextAlignment() const { return _hAlignment;} //设置水平对齐方式 void setHorizontalAlignment(TextHAlignment hAlignment) { setAlignment(hAlignment,_vAlignment); } TextHAlignment getHorizontalAlignment() const { return _hAlignment; } //设置垂直对齐方式 void setVerticalAlignment(TextVAlignment vAlignment) { setAlignment(_hAlignment,vAlignment); } TextVAlignment getVerticalAlignment() const { return _vAlignment; }

/*** Label尺寸大小* - setLineBreakWithoutSpace : 开启自动换行功能* - setMaxLineWidth : 文字内容的最大行宽* - setWidth : Label尺寸大小，宽* - setHeight : Label尺寸大小，高* - setDimensions : Label尺寸大小**/ //是否开启自动换行功能 void setLineBreakWithoutSpace(bool breakWithoutSpace); //最大行宽，内容超过MaxLineWidth，就会自动换行 //前提条件: 仅在width==0时，起作用。 // > width == 0; // > setMaxLineWidth(lineWidth); // > setLineBreakWithoutSpace(true); //它的效果与下面是类&#;的. // > setWidth(lineWidth); // > setLineBreakWithoutSpace(true); //只是width==0时，就无法设置文本的对齐方式了. void setMaxLineWidth(unsigned int maxLineWidth); unsigned int getMaxLineWidth() { return _maxLineWidth;} //设置Label的尺寸大小 //可以理解为Label的文本框大小 //当setLineBreakWithoutSpace(true)时，内容超过width，会自动换行 //并且内容支持文本的对齐方式 //注：设置尺寸大小，使用的是setDimensions，而不是setContentSize ！ void setWidth(unsigned int width) { setDimensions(width,_labelHeight); } void setHeight(unsigned int height){ setDimensions(_labelWidth,height); } void setDimensions(unsigned int width,unsigned int height); unsigned int getWidth() const { return _labelWidth; } unsigned int getHeight() const { return _labelHeight; } const Size& getDimensions() const{ return _labelDimensions; } /*** v3.2 新增* - setLineHeight : 设置行间距* - setAdditionalKerning : 设置文字间距* - getStringLength : 字符串内容长度*/ //设置行间距，不支持system font void setLineHeight(float height); float getLineHeight() const; //设置文字间距，不支持system font void setAdditionalKerning(float space); float getAdditionalKerning() const; //获取Label的字符串内容长度 int getStringLength() const; 重写Node父类的方法 - setBlendFunc : 混合模式 - setScale : 放缩字体大小 - addChild : 添加子节点 - getDescription : 显示Label的描述 //设置颜色混合模式 virtual void setBlendFunc(const BlendFunc &blendFunc) override; //放缩字体大小（一般用于CharMap、BMFont） virtual void setScale(float scale) override; virtual void setScaleX(float scaleX) override; virtual void setScaleY(float scaleY) override; virtual float getScaleX() const override; virtual float getScaleY() const override; //添加子节点 virtual void addChild(Node * child, int zOrder=0, int tag=0) override; virtual void sortAllChildren() override; //Label描述 virtual std::string getDescription() const override;};

【文字渲染效果】支持三种渲染效果：Shadow:阴影Outline:轮廓，仅支持TTFGlow:发光，仅支持TTF注：其中Outline与Glow两个效果，只会作用一个。即无法一起使用。使用举例： Label* lb = Label::createWithTTF("abc", "fonts/Marker Felt.ttf", ); lb->setPosition(visibleSize / 2); this->addChild(lb); lb->enableShadow(Color4B::GREEN, Size(, )); //阴影 lb->enableOutline(Color4B::RED, 3); //轮廓 //lb->enableGlow(Color4B::GREEN); //发光 //取消阴影、轮廓、发光效果 //lb->disableEffect();【对齐方式】TextHAlignment:水平对齐方式* TextHAlignment:LEFT:左对齐* TextHAlignment:CENTER:居中对齐，默认* TextHAlignment:RIGHT:右对齐TextVAlignment:垂直对齐方式* TextVAlignment::TOP:顶部，默认* TextVAlignment::CENTER:中心* TextVAlignment::BOTTOM:底部仅在设置了Label的尺寸大小setDimensions(width,height)，大于显示的字符串内容的尺寸大小，才会起作用。对齐方式举例，如下几张图片所示：对齐方式为：TextHAlignment:LEFTTextVAlignment::TOP【自动换行】在3.x中，自动换行有两种方式。（当然你也可以使用C&#;&#;里的转移字符''进行手动换行）利用lb->setLineBreakWithoutSpace(true)，来支持自动换行功能。利用setMaxLineWidth(maxLineWidth)，来控制自动换行。利用setDimensions(width,height)，来控制自动换行。利用setMaxLineWidth设置每行显示文字的最大宽度。注：这种方法仅在Labelwidth==0的情况下，才会有效。 lb->setLineBreakWithoutSpace(true); lb->setMaxLineWidth(); //最大宽度利用setDimensions使用方法： lb->setLineBreakWithoutSpace(true); lb->setWidth(); //设置Label尺寸宽 lb->setMaxLineWidth(); //设置了Label width，这个就无效【文字间距】间距的调整，可以设置文本内容的行间距与文字间距。注：不支持SystemFont。setLineHeight:设置行间距setAdditionalKerning:设置额外文字间距使用举例：lb->setLineHeight(); lb->setAdditionalKerning();【单独设置某个字符】学过2.x中的LabelBMFont的同学，应该知道这个是怎么回事吧？在3.x中，使用TTF、CharMap、BMFont创建的文字标签，其字符串内容的每个字符都是一个Sprite精灵图片，可以对其进行单独的设置。如精灵放缩、执行动作等。注：不支持SystemFont。lb->getStringLength():获取字符串内容的总长度lb->getLetter(i):获取第i个位置上的字符使用举例： Label* lb = Label::createWithTTF("abc", "fonts/Marker Felt.ttf", ); lb->setPosition(visibleSize / 2); this->addChild(lb); //获取字符串总长度，length = 6 CCLOG("%d", lb->getStringLength()); //获取第1个字符 Sprite* letter1 = lb->getLetter(1); letter1->setColor(Color3B::GREEN); //设置颜色 letter1->setScale(2.0f); //放缩 //获取第4个字符 Sprite* letter4 = lb->getLetter(4); letter4->setColor(Color3B::RED); //设置颜色 letter4->runAction(RepeatForever::create(RotateBy::create(1.0f, ))); //执行旋转动作参考文章

[置顶] cocos2d-x 3.5版 关于Console模块 cocos2d-x引擎发展的日益完善，更新了很多小工具。这个Console模块是一个控制台调试工具，可以实现远程调试，用用还是蛮有意思的。看AppDelegate.cpp里面

CCEditBox实现原理 今天使用了EditBox，记录下几点重要的，可以说是CCEditBox实现原理1.CCEditBox继承CCControlButton，CCIMEDelegate2.CCEditBox实现了touchDownAction方法，并在CCEditBox::initWi

【COCOS2DX-游戏开发之三八】ClippingNode 制作标题闪亮特效 1.用ClippingNode可以实现上面的效果2.以标题作为模板,光效经过ClippingNode(裁剪节点),裁剪掉多余的部分3.附带上lua代码--1.创建模板、ClippingNode(裁剪节点)loca