Cocos2d-x 3.0-新的Label-Cocos2d-x官方文档

原文

目 录

  1. 新文本标签类Label
  2. 其他文本标签
  3. 字体制作工具使用介绍
  4. 小结

https://github.com/chukong/cocos-docs/blob/master/manual/framework/native/v3/text-label/zh.md

欢迎大家斧正错误，提交PR。

在游戏开发中，文字起了非常重要的作用。游戏介绍、游戏中的提示以及对话等都需要用到文字，Cocos2d-x中给文字渲染提供了灵活的机制，既可以用系统文字，也可以使用自定义渲染字体。另外，文本标签还可用来初始化菜单。

在开发中，我们最常用的4种文本标签是：Label,LabelAtlas,LabelTTF和LabelBMFont，其中3.0尤其提倡使用Lable代替LabelTTF和LabelBMFont，因为Label在渲染速度上较其快。以下我们详细讲解下它们的使用方法。

新文本标签类Label

3.0中你可以使用Label类创建LabelTTF和LabelBMFont中任意一种标签，与他们2种不同的是，新标签类继承于SpriteBatchNode类，这样一来大大提高了渲染速度。以下代码列举几种创建Label的方法：

auto newLabel1 = Label::create(<span class="string" style="color:#dd1144;">"New Label"</span>,<span class="string" style="color:#dd1144;">"Arial"</span>,<span class="number" style="color:#09999;">30</span>);
<span class="indent">  </span>auto newLabel2 = Label::createWithBMFont(<span class="string" style="color:#dd1144;">"bitmapFontTest.fnt"</span>,<span class="string" style="color:#dd1144;">"New Label"</span>);
<span class="indent">  </span>newLabel1->setPosition(Point(visibleSize.width / <span class="number" style="color:#09999;">2</span> + origin.<span class="keyword" style="font-weight:bold">x</span>,visibleSize.height / <span class="number" style="color:#09999;">2</span> + origin.<span class="keyword" style="font-weight:bold">y</span>));
<span class="indent">  </span>newLabel2->setPosition(Point(visibleSize.width / <span class="number" style="color:#09999;">2</span> + origin.<span class="keyword" style="font-weight:bold">x</span>,visibleSize.height / <span class="number" style="color:#09999;">2</span> + origin.<span class="keyword" style="font-weight:bold">y</span> - <span class="number" style="color:#09999;">100</span>));
<span class="indent">  </span>addChild(newLabel1);
<span class="indent">  </span>addChild(newLabel2);
<span class="indent">  </span>TTFConfig ttfConfig;
<span class="indent">  </span>ttfConfig.fontSize = <span class="number" style="color:#09999;">30</span>;
<span class="indent">  </span>ttfConfig.fontFilePath = <span class="string" style="color:#dd1144;">"Paint Boy.ttf"</span>;
<span class="indent">  </span>auto label2 = Label::createWithTTF(ttfConfig,<span class="string" style="color:#dd1144;">"New Label"</span>);
<span class="indent">  </span>label2->setPosition(Point(visibleSize.width / <span class="number" style="color:#09999;">2</span> + origin.<span class="keyword" style="font-weight:bold">x</span>,visibleSize.height / <span class="number" style="color:#09999;">2</span> + origin.<span class="keyword" style="font-weight:bold">y</span> + <span class="number" style="color:#09999;">100</span>));
<span class="indent">  </span>addChild(label2);

上面的例子中，我们使用新标签类创建了一个LabelTTF标签和LabelBMFont标签：

  • create方法默认创建一个LabelTTF标签，参数也和创建LabelTTF标签一样
  • createWithBMFont方法创建一个LabelBMFont标签，第一个参数为文件名，第二个参数为要显示的内容
  • createWithTTF方法使用.ttf文件来创建一个LabelTTF标签，需要注意的是要设置字体大小必须先配置好TTFConfig

其他文本标签

以上介绍了新标签类后，我们来看下以前的标签类。尽管3.0使用了新标签类，但是为了向下兼容，一些以前的标签类仍然可以使用。

图片文字LabelAtlas

LabelAtlas类是使用图片作为文字，该类直接使用图片初始化文字对象。此类支持两种文件类型来初始化：

  • PNG文件
  • plist文件

以下代码使用两种不同文件初始化一个文字对象：

auto label1 = LabelAtlas::<span class="operator"><span class="keyword" style="font-weight:bold">create</span>(<span class="string" style="color:#dd1144;">"PNG Test"</span>,<span class="string" style="color:#dd1144;">"tuffy_bold_italic-charmap.png"</span>,<span class="number" style="color:#09999;">48</span>,<span class="number" style="color:#09999;">64</span>,<span class="string" style="color:#dd1144;">' '</span>);</span>
<span class="indent">  </span>label1->setPosition(Point(visibleSize.width / 2 + origin.x,visibleSize.height / 2 + origin.y));
<span class="indent">  </span>addChild(label1);

<span class="indent">  </span>auto label2 = LabelAtlas::<span class="operator"><span class="keyword" style="font-weight:bold">create</span>(<span class="string" style="color:#dd1144;">"Plist Test"</span>,<span class="string" style="color:#dd1144;">"tuffy_bold_italic-charmap.plist"</span>);</span>
<span class="indent">  </span>label2->setPosition(Point(visibleSize.width / 2 + origin.x,visibleSize.height / 2 + origin.y - 100));
<span class="indent">  </span>addChild(label2);

下面解释下LabelAtlas::create()的5个参数：

  • 第一个参数：标签要显示的内容
  • 第二个参数：图片资源的名称
  • 第三个参数：每个字符的宽度，这个是在制作图片的时候自己设置的，上面代码中的字符宽度为48px，是制图时确定的
  • 第四个参数：每个字符的高度，同理，我们使用的图的每个字符高度为64px
  • 第五个参数：开始字符，该参数帮助找到第一个字符

系统字体LabelTTF

LabelTTF类使用系统中自带的字体，如果创建LabelTTF对象时未给出字体名字或者给出的名字系统中不存在，则使用引擎默认字体初始化对象。

引擎提供两种方式创建LableTTF:

  • 用LabelTTF类的create方法创建
  • 用Label类的createWithTTF方法创建，但是Label类是通过.ttf文件来创建的

以下代码分别使用LabelTTF和Label来创建Label:

auto label1 = LabelTTF::<span class="operator"><span class="keyword" style="font-weight:bold">create</span>(<span class="string" style="color:#dd1144;">"Create with LabelTTF"</span>,<span class="number" style="color:#09999;">30</span>);</span>
<span class="indent">  </span>label1->setPosition(Point(visibleSize.width / 2 + origin.x,visibleSize.height / 2 + origin.y));
<span class="indent">  </span>addChild(label1);

<span class="indent">  </span>TTFConfig ttfConfig;
<span class="indent">  </span>ttfConfig.fontSize = 30;
<span class="indent">  </span>ttfConfig.fontFilePath = "Paint Boy.ttf";
<span class="indent">  </span>auto label2 = Label::createWithTTF(ttfConfig,"<span class="operator"><span class="keyword" style="font-weight:bold">Create</span> <span class="keyword" style="font-weight:bold">with</span> Label<span class="string" style="color:#dd1144;">");
<span class="indent">  </span>label2->setPosition(Point(visibleSize.width / 2 + origin.x,visibleSize.height / 2 + origin.y - 100));
<span class="indent">  </span>addChild(label2);</span></span>

字体图集LabelBMFont

LabelBMFont类是一个基于位图的字体图集，是一个包含所有你需要于坐标数据一起显示在屏幕上的字符的图像，它允许字符从主图中剪切出来。

以下代码用来创建LabelBMFont对象：

auto label = LabelBMFont::<span class="operator"><span class="keyword" style="font-weight:bold">create</span>(<span class="string" style="color:#dd1144;">"BMFont Test"</span>,<span class="string" style="color:#dd1144;">"bitmapFontTest.fnt"</span>);</span>
    label->setPosition(Point(visibleSize.width / 2 + origin.x,visibleSize.height / 2 + origin.y));
    addChild(label);

字体制作工具使用介绍

Cocos2d-x支持许多使用fnt文件格式的位图字体，下面介绍下如何使用Glyph Designer一款Mac下的字体设计器来创建字体图集（Windows下可使用Hiero和BMFont）：

  • 步骤一：启动Glyph Designer,选择File->New，在左上的搜索框中键入需要的字体集名（这里使用”Helvetica”）
  • 步骤二：设置字体尺寸为32，默认情况下Glyph Designer自动调整字体图集尺寸为最小可能值以适配所有可能的图像。
  • 步骤三：在右边Glyph Fill里面选择颜色
  • 步骤四：在Included Glyph里面点击NEHE按钮。在此区域键入你所需要用到的字符
  • 步骤五：点击Export导出文件
  • 步骤六：选择导出文件类型

小结

在游戏开发中，标准字体不需要频繁更改时使用LabelTTF非常合适。在需要定制文字或者在频繁改变文字内容时需要使用LabelBMFont。但3.0的新标签类为你解决了这个问题，你无须再考虑选择那种标签，只需使用新标签类即可。

文字标签类的另外一个作用是可以初始化菜单，关于菜单的用法在此不做详细讲解，下面代码使用文字标签初始化菜单：

sql" style="padding:0.5em; font-family:Monaco,<span class="string" style="color:#dd1144;">"bitmapFontTest.fnt"</span>);</span>
    auto menuItemLabel = MenuItemLabel::<span class="operator"><span class="keyword" style="font-weight:bold">create</span>(label);</span>
    auto menu = Menu::<span class="operator"><span class="keyword" style="font-weight:bold">create</span>(menuItemLabel,<span class="keyword" style="font-weight:bold">NULL</span>);</span>
    menu->setPosition(Point(visibleSize.width / 2 + origin.x,visibleSize.height / 2 + origin.y));
    addChild(menu);

Cocos2d-x 3.0-新的Label-Cocos2d-x官方文档的更多相关文章

  1. three.js模拟实现太阳系行星体系功能

    这篇文章主要介绍了three.js模拟实现太阳系行星体系功能,本文通过实例代码给大家介绍的非常详细，具有一定的参考借鉴价值，需要的朋友可以参考下

  2. HTML5 WebSocket实现点对点聊天的示例代码

    这篇文章主要介绍了HTML5 WebSocket实现点对点聊天的示例代码的相关资料,小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧

  3. HTML5页面无缝闪开的问题及解决方案

    这篇文章主要介绍了HTML5页面无缝闪开方案,本文通过实例代码给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下

  4. 移动端html5模拟长按事件的实现方法

    这篇文章主要介绍了移动端html5模拟长按事件的实现方法的相关资料,小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧

  5. ios – 在Swift的UIView中找到UILabel

    我正在尝试在我的UIViewControllers的超级视图中找到我的UILabels.这是我的代码：这是在Objective-C中推荐的方式,但是在Swift中我只得到UIViews和CALayer.我肯定在提供给这个方法的视图中有UILabel.我错过了什么？我的UIViewController中的调用：解决方法使用函数式编程概念可以更轻松地实现这一目标.

  6. ios – 在Swift中将输入字段字符串转换为Int

    所以我非常擅长制作APP广告Swift,我试图在文本字段中做一些非常简单的输入,取值,然后将它们用作Int进行某些计算.但是’vardistance’有些东西不正确它是导致错误的最后一行代码.它说致命错误：无法解开Optional.None解决方法在你的例子中,距离是一个Int？否则称为可选的Int..toInt()返回Int？因为从String到Int的转换可能失败.请参阅以下示例：

  7. 如何在iOS中检测文本(字符串)语言？

    例如,给定以下字符串：我想检测每个声明的字符串中使用的语言.让我们假设已实现函数的签名是：如果没有检测到语言,则返回可选字符串.因此,适当的结果将是：有一个简单的方法来实现它吗？

  8. xamarin – 崩溃在AccountStore.Create().保存(e.Account,“);

    在Xamarin.Forms示例TodoAwsAuth中https://developer.xamarin.com/guides/xamarin-forms/web-services/authentication/oauth/成功登录后,在aOnAuthenticationCompleted事件中,应用程序在尝试保存到Xamarin.Auth时崩溃错误说不能对钥匙串说期待着寻求帮助.解决方法看看你

  9. ios – 将视频分享到Facebook

    我正在编写一个简单的测试应用程序,用于将视频从iOS上传到Facebook.由于FacebookSDK的所有文档都在Objective-C中,因此我发现很难在线找到有关如何使用Swift执行此操作的示例/教程.到目前为止我有这个在我的UI上放置一个共享按钮,但它看起来已禁用,从我读到的这是因为没有内容设置,但我看不出这是怎么可能的.我的getVideoURL()函数返回一个NSURL,它肯定包含视

  10. xcode – 错误“线程1：断点2.1”

    我正在研究RESTAPI管理器.这是一个错误,我无法解决它.我得到的错误在下面突出显示.当我打电话给这个班级获取资源时：我评论的线打印：Thread1:breakpoint2.1我需要修复错误的建议.任何建议都非常感谢解决方法您可能在不注意的情况下意外设置了断点.单击并拖动代表断路器外部断点的蓝色刻度线以将其擦除.

随机推荐

  1. 【cocos2d-x 3.x 学习笔记】对象内存管理

    Cocos2d-x的内存管理cocos2d-x中使用的是上面的引用计数来管理内存，但是又增加了一些自己的特色。cocos2d-x中通过Ref类来实现引用计数，所有需要实现内存自动回收的类都应该继承自Ref类。下面是Ref类的定义：在cocos2d-x中创建对象通常有两种方式：这两中方式的差异可以参见我另一篇博文“对象创建方式讨论”。在cocos2d-x中提倡使用第二种方式，为了避免误用第一种方式，一般将构造函数设为protected或private。参考资料：[1]cocos2d-x高级开发教程2.3节[

  2. 利用cocos2dx 3.2开发消灭星星六如何在cocos2dx中显示中文

    由于编码的不同，在cocos2dx中的Label控件中如果放入中文字，往往会出现乱码。为了方便使用，我把这个从文档中获取中文字的方法放在一个头文件里面Chinese.h这里的tex_vec是cocos2dx提供的一个保存文档内容的一个容器。这里给出ChineseWords,xml的格式再看看ChineseWord的实现Chinese.cpp就这样，以后在需要用到中文字的地方，就先include这个头文件然后调用ChineseWord函数，获取一串中文字符串。

  3. 利用cocos2dx 3.2开发消灭星星七关于星星的算法

    在前面，我们已经在GameLayer中利用随机数初始化了一个StarMatrix，如果还不知道怎么创建星星矩阵请回去看看而且我们也讲了整个游戏的触摸事件的派发了。

  4. cocos2dx3.x 新手打包APK注意事项！

    这个在编译的时候就可以发现了比较好弄这只是我遇到的，其他的以后遇到再补充吧。。。以前被这两个问题坑了好久

  5. 利用cocos2dx 3.2开发消灭星星八游戏的结束判断与数据控制

    如果你看完之前的，那么你基本已经拥有一个消灭星星游戏的雏形。开始把剩下的两两互不相连的星星消去。那么如何判断是GameOver还是进入下一关呢。。其实游戏数据贯穿整个游戏，包括星星消除的时候要加到获得分数上，消去剩下两两不相连的星星的时候的加分政策等，因此如果前面没有做这一块的，最好回去搞一搞。

  6. 利用cocos2dx 3.2开发消灭星星九为游戏添加一些特效

    needClear是一个flag，当游戏判断不能再继续后，这个flag变为true，开始消除剩下的星星clearSumTime是一个累加器ONE_CLEAR_TIME就是每颗星星消除的时间2.连击加分信息一般消除一次星星都会有连击信息和加多少分的信息。其实这些combo标签就是一张图片，也是通过控制其属性或者runAction来实现。源码ComboEffect.hComboEffect.cpp4.消除星星粒子效果消除星星时，为了实现星星爆裂散落的效果，使用了cocos2d提供的粒子特效引擎对于粒子特效不了

  7. 02 Cocos2D-x引擎win7环境搭建及创建项目

    官网有搭建的文章，直接转载记录。环境搭建：本文介绍如何搭建Cocos2d-x3.2版本的开发环境。项目创建：一、通过命令创建项目前面搭建好环境后，怎样创建自己的Cocos2d-x项目呢？先来看看Cocos2d-x3.2的目录吧这就是Cocos2d-x3.2的目录。输入cocosnew项目名–p包名–lcpp–d路径回车就创建成功了例如：成功后，找到这个项目打开proj.win32目录下的Hello.slnF5成功了。

  8. 利用cocos2dx 3.2开发消灭星星十为游戏添加音效项目源码分享

    一个游戏，声音也是非常的重要，其实cocos2dx里面的简单音效引擎的使用是非常简单的。我这里只不过是用一个类对所有的音效进行管理罢了。Audio.hAudio.cpp好了，本系列教程到此结束，第一次写教程如有不对请见谅或指教，谢谢大家。最后附上整个项目的源代码点击打开链接

  9. 03 Helloworld

    程序都有一个入口点，在C++就是main函数了，打开main.cpp，代码如下：123456789101112131415161718#include"main.h"#include"AppDelegate.h"#include"cocos2d.h"USING_NS_CC;intAPIENTRY_tWinMain{UNREFERENCED_ParaMETER;UNREFERENCED_ParaMETER;//createtheapplicationinstanceAppDelegateapp;return

  10. MenuItemImage*图标菜单创建注意事项

    学习cocos2dx,看的是cocos2d-x3.x手游开发实例详解，这本书错误一大把，本着探索求知勇于发现错误改正错误的精神，我跟着书上的例子一起调试，当学习到场景切换这个小节的时候，出了个错误，卡了我好几个小时。

返回
顶部