游戏场景中的文字包括了静态文字和动态文字。静态文字如下图所示游戏场景中①号文字“COCOS2DX”,动态文字如图4-1所示游戏场景中的②号文字“Hello World”。
静态文字一般是由美工使用Photoshop绘制在背景图片上,这种方式的优点是表现力很丰富,例如:①号文字“COCOS2DX”中的“COCOS”、“2D”和“X”设计的风格不同,而动态文字则不能,而且静态文字无法通过程序访问,无法动态修改内容。
动态文字一般是需要通过程序访问,需要动态修改内容。Cocos2d-x Lua可以通过标签类实现。

场景中的文字

下面我们重点介绍Cocos2d-x Lua中标签类,Cocos2d-x Lua中标签类主要有三种:LabelTTF、LabelAtlas和LabelBMFont。此外,在Cocos2d-x 3.x之后又推出了新的标签类Label。
LabelTTF
LabelTTF是使用系统中的字体,它是最简单的标签类。LabelTTF类图如下图所示,可以LabelTTF继承了Node类,具有Node的基本特性。此外还实现了LabelProtocol接口。

LabelTTF类图

如果我们要展示图中所示的Hello World文字,我们可以使用LabelTTF实现。

LabelTTF实现的Hello World文字

LabelTTF实现的Hello World文字主要代码如下:

  1. function GameScene:createLayer()
  2. local layer = cc.Layer:create()
  3. // 创建并初始化标签
  4. local label = cc.LabelTTF:create("Hello World", "Arial", 64)                        ①
  5. label:setPosition(cc.p(size.width/2, size.height - label:getContentSize().height))
  6. layer:addChild(label, 1)
  7. local sprite = cc.Sprite:create("HelloWorld.png")
  8. sprite:setPosition(cc.p(size.width/2,
  9. size.height/2))
  10. layer:addChild(sprite, 0)
  11. return layer
  12. end

上述代码第①行是创建一个LabelTTF对象,create函数的第一个参数是要显示的文字,第二个参数是系统字体名,第三个参数是字体的大小,事实上该create函数省略了三个参数,create函数的完整定义如下:

  1. cc.LabelTTF:create (text,
  2. fontName,
  3. fontSize,
  4. dimensions=cc.size(0,0),    --在屏幕上占用的区域大小,cc.size(0,0)表示按照字体大小显示
  5. hAlignment= cc.TEXT_ALIGNMENT_LEFT,         -- 水平对齐,默认值是靠右对齐
  6. vAlignment= cc.VERTICAL_TEXT_ALIGNMENT_TOP)     -- 垂直对齐,默认值是顶对齐

其中后三个参数有默认值,如果不指定就会使用默认值。
LabelAtlas
LabelAtlas是图片集标签,其中的Atlas本意是“地图集”、“图片集”,这种标签显示的文字是从一个图片集中取出的,因此使用LabelAtlas需要额外加载图片集文件。LabelAtlas 比LabelTTF快很多。LabelAtlas 中的每个字符必须有固定的高度和宽度。
LabelAtlas类图如下图所示,LabelAtlas间接地继承了Node类,具有Node的基本特性,它还直接继承了AtlasNode。此外还实现了LabelProtocol接口。

LabelAtlas类图

如果我们要展示图中所示的Hello World文字,我们可以使用LabelAtlas实现。

LabelAtlas实现的Hello World文字

LabelAtlas实现的Hello World文字主要代码如下:

  1. function GameScene:createLayer()
  2. local layer = cc.Layer:create()
  3. local label = cc.LabelAtlas:_create("HelloWorld",
  4. "fonts/tuffy_bold_italic-charmap.png", 48, 66, string.byte(" "))                ①
  5. label:setPosition(cc.p(size.width/2  - label:getContentSize().width / 2,
  6. size.height - label:getContentSize().height))
  7. layer:addChild(label, 1)
  8. local sprite = cc.Sprite:create("HelloWorld.png")
  9. sprite:setPosition(cc.p(size.width/2, size.height/2))
  10. layer:addChild(sprite, 0)
  11. return layer
  12. end

上述代码第①行是创建一个LabelAtlas对象,create函数的第一个参数是要显示的文字,第二个参数是图片集文件(见如图所示),第三个参数是字符高度,第四个参数是字符宽度,第五个参数是开始字符。

图片集文件

使用LabelAtlas需要注意的是图片集文件需要放置在Resources目录下。
LabelBMFont
LabelBMFont是位图字体标签,需要添加字体文件:包括一个图片集(.png)和一个字体坐标文件(.fnt)。LabelBMFont比LabelTTF快很多。LabelBMFont中的每个字符的宽度是可变的。
LabelBMFont类图如下图所示,可以LabelBMFont间接地继承了Node类,具有Node的基本特性,此外还实现了LabelProtocol接口。

LabelBMFont类图

如果我们要展示下图所示的Hello World文字,我们可以使用LabelBMFont实现。

LabelBMFont实现的Hello World文字

LabelBMFont实现的Hello World文字主要代码如下:

  1. function GameScene:createLayer()
  2. local layer = cc.Layer:create()
  3. local label = cc.LabelBMFont:create("HelloWorld", "fonts/BMFont.fnt")               ①
  4. label:setPosition(cc.p(size.width/2,
  5. size.height - label:getContentSize().height))
  6. layer:addChild(label, 1)
  7. local sprite = cc.Sprite:create("HelloWorld.png")
  8. sprite:setPosition(cc.p(size.width/2, size.height/2))
  9. layer:addChild(sprite, 0)
  10. return layer
  11. end

上述代码第①行是创建一个LabelBMFont对象,create函数的第一个参数是要显示的文字,第二个参数是图片集文件。图片集文件BMFont.fnt如下图所示,对应还有一个字体坐标文件BMFont.fnt。

图片集文件

坐标文件BMFont.fnt代码如下:

  1. info face="AmericanTypewriter" size=64 bold=0 italic=0 charset="" unicode=0 stretchH=100 smooth=1 aa=1 padding=0,0,0,0 spacing=2,2
  2. common lineHeight=73 base=58 scaleW=512 scaleH=512 pages=1 packed=0
  3. page id=0 file="BMFont.png"
  4. chars count=95
  5. char id=124 x=2 y=2 width=9 height=68 xoffset=14 yoffset=9 xadvance=32 page=0 chnl=0 letter="|"
  6. char id=41 x=13 y=2 width=28 height=63 xoffset=1 yoffset=11 xadvance=29 page=0 chnl=0 letter=")"
  7. char id=40 x=43 y=2 width=28 height=63 xoffset=4 yoffset=11 xadvance=29 page=0 chnl=0 letter="("
  8. ... ...
  9. char id=32 x=200 y=366 width=0 height=0 xoffset=16 yoffset=78 xadvance=16 page=0 chnl=0 letter="space"

使用LabelBMFont需要注意的是图片集文件和坐标文件需要放置在Resources目录下,文件命名相同。图片集合和坐标文件是可以通过位图字体工具制作而成的,由于位图字体工具的使用请参考本系列丛书的工具卷(《Cocos2d-x实战:工具卷》)。
Cocos2d-x 3.x标签类Label
Cocos2d-x 3.x后推出了新的标签类Label,这种标签通过使用FreeType[ FreeType库是一个完全免费(开源)的、高质量的且可移植的字体引擎,它提供统一的接口来访问多种字体格式文件。——引自于百度百科 http://baike.baidu.com/view/4579855.htm
]来使它在不同的平台上有相同的视觉效果。由于使用更快的缓存代理,它的渲染也将更加快速。Label提供了描边和阴影等特性。
Label类的类图如下图所示。

Label类图

创建Label类静态create函数常用的有如下几个:

  1. cc.Label:createWithSystemFont(text,                 -- 是要显示的文字
  2. font,                                                   -- 系统字体名
  3. fontSize,                                       -- 字体的大小
  4. dimensions = cc.size(0,0),                          -- 可省略,参考LabelTTF定义
  5. vAlignment= cc.TEXT_ALIGNMENT_LEFT,             -- 可省略,参考LabelTTF定义
  6. vAlignment= cc.VERTICAL_TEXT_ALIGNMENT_TOP      -- 可省略,参考LabelTTF定义
  7. )
  8. cc.Label:createWithTTF(const std::string & text,
  9. fontFile,                                       -- 字体文件
  10. fontSize,
  11. dimensions = cc.size(0,0),
  12. hAlignment= cc.TEXT_ALIGNMENT_LEFT,
  13. vAlignment= cc.VERTICAL_TEXT_ALIGNMENT_TOP
  14. )
  15. cc.Label:createWithTTF(ttfConfig,                       -- 字体配置信息
  16. text,
  17. hAlignment= cc.TEXT_ALIGNMENT_LEFT,
  18. int maxLineWidth = 0                            -- 可省略,标签的最大宽度
  19. )
  20. cc.Label:createWithBMFont(const std::string& bmfontFilePath,    -- 位图字体文件
  21. text,
  22. hAlignment= cc.TEXT_ALIGNMENT_LEFT,
  23. int maxLineWidth = 0,
  24. imageOffset = cc.p(0,0)                             -- 可省略,在位图中的偏移量
  25. )

其中createWithSystemFont是创建系统字体标签对象,createWithTTF是创建TTF字体标签对象,createWithBMFont是创建位图字体标签对象。
createWithBMFont
下面我们通过一个实例介绍一下,它们的使用。这个实例如下图所示。

Label类实例

下面我们看看HelloWorldScene.cpp中init函数如下:

  1. function GameScene:createLayer()
  2. local layer = cc.Layer:create()
  3. local label1 = cc.Label:createWithSystemFont("世界你好1 ", "Arial", 36)                 ①
  4. label1:setPosition(cc.p(size.width/2, size.height - 100))
  5. layer:addChild(label1, 1)
  6. local label2 = cc.Label:createWithTTF("世界你好2", "fonts/STLITI.ttf", 36)          ②
  7. label2:setPosition(cc.p(size.width/2, size.height - 200))
  8. layer:addChild(label2, 1)
  9. local label3 = cc.Label:createWithBMFont ("fonts/bitmapFontChinese.fnt", "中国")      ③
  10. label3:setPosition(cc.p(size.width/2, size.height - 300))
  11. layer:addChild(label3, 1)
  12. local ttfConfig  = {}                                                   ④
  13. ttfConfig.fontFilePath="fonts/Marker Felt.ttf"
  14. ttfConfig.fontSize = 32
  15. local label4 = cc.Label:createWithTTF(ttfConfig, "Hello World4")                    ⑤
  16. label4:setPosition(cc.p(size.width/2, size.height - 400))
  17. layer:addChild(label4 , 1)
  18. ttfConfig.outlineSize = 4                                               ⑥
  19. local label5 = cc.Label:createWithTTF(ttfConfig, "Hello World5")                    ⑦
  20. label5:setPosition(cc.p(size.width/2, size.height - 500))
  21. label5:enableShadow(cc.c4b(255,255,255,128), cc.size(4, -4))                    ⑧
  22. label5:setColor(cc.c3b(255, 0, 0))                                      ⑨
  23. layer:addChild(label5, 1)
  24. return layer
  25. end

在上面的代码中第①行是通过createWithSystemFont函数创建Label对象,第②行代码是通过createWithTTF是创建TTF字体标签对象,第③行代码是createWithBMFont是创建位图字体标签对象。
第④行代码local ttfConfig = {}是声明一个TTFConfig变量,TTFConfig的属性如下:

  1. fontFilePath                                        -- 字体文件路径
  2. fontSize,                                           -- 字体大小
  3. glyphs = cc.GLYPHCOLLECTION_DYNAMIC,            -- 字体库类型
  4. customGlyphs                                    -- 自定义字体库
  5. outlineSize                                         -- 字体描边
  6. distanceFieldEnabled                            -- 开启距离字段字体开关

第⑤行代码cc.Label:createWithTTF(ttfConfig, "Hello World4")是通过指定TTFConfig创建TTF字体标签。第⑥行代码ttfConfig.outlineSize = 4设置TTFConfig的描边字段。第⑦行代码cc.Label:createWithTTF(ttfConfig, "Hello World5")是重新创建TTF字体标签。

第⑧行代码label5:enableShadow(cc.c4b(255,255,255,128), cc.size(4, -4))是设置标签的阴影效果。第⑨行代码label5:setColor(cc.c3b(255, 0, 0))是设置标签的颜色。

 
更多内容请关注最新Cocos图书《Cocos2d-x实战:Lua卷——Cocos2d-lua开发》

本书交流讨论网站:http://www.cocoagame.net

欢迎加入Cocos2d-x技术讨论群:257760386

更多精彩视频课程请关注智捷课堂Cocos课程:http://v.51work6.com

《Cocos2d-x实战 Lua卷》现已上线,各大商店均已开售:

京东:http://item.jd.com/11659698.html

欢迎关注智捷iOS课堂微信公共平台,了解最新技术文章、图书、教程信息

Cocos2d-x Lua中使用标签的更多相关文章

  1. cocos2d-x 2.2.0 如何在lua中注册回调函数给C++

    cocos2d-x内部使用tolua进行lua绑定,但是引擎并没有提供一个通用的接口让我们可以把一个lua函数注册给C++层面的回调事件.翻看引擎的lua绑定代码,我们可以仿照引擎中的方法来做.值得吐 ...

  2. lua中打印所以类型功能实现table嵌套table

    lua中打印所以类型功能实现 本人測试 number.string.bool.nil.table嵌套table.userdata没问题 共享一下有什么问题请拍砖 代码例如以下 cclog = func ...

  3. Lua中的weak表——weak table(转)

    弱表(weak table)是一个很有意思的东西,像C++/Java等语言是没有的.弱表的定义是:A weak table is a table whose elements are weak ref ...

  4. cocos2dx lua中异步加载网络图片,可用于显示微信头像

    最近在做一个棋牌项目,脚本语言用的lua,登录需要使用微信登录,用户头像用微信账户的头像,微信接口返回的头像是一个url,那么遇到的一个问题就是如何在lua中异步加载这个头像,先在引擎源码里找了下可能 ...

  5. cocos2d-x 3.0 在lua中调用自定义类

    环境 windows8, cocos2d-x 3.0, 现在开始安装需要的一些其它包 1. 按README.mdown文档上面要求的, 下载在windows下要安装的东东, 主要就是python2.7 ...

  6. cocos2d-x lua 中使用protobuf并对http进行处理

    cocos2d-x lua 中使用protobuf并对http进行处理 本文介绍 cocos2d-x lua 中使用http 和 基于cocos2d-x 对lua http的封装(部分ok) 本博客链 ...

  7. 从架构层面杜绝lua中使用未定义的变量

    # 从架构层面杜绝lua中使用未定义的变量 标签(空格分隔): lua --- lua中有一个很坑的地方:1.就是如果一个变量拼写错误,会自动的认为你定义了一个值为nil的全局变量.2.如果在func ...

  8. cocos2d-x lua中实现异步加载纹理

    原文地址:  http://www.cnblogs.com/linchaolong/p/4033118.html 前言   问题:最近项目中需要做一个loading个界面,界面中间有一个角色人物走动的 ...

  9. Html中<font>标签的使用

    Html中<font>标签的使用 <!doctype html> <html lang="en"> <head> <meta ...

随机推荐

  1. MPTCP 源码分析(四) 发送和接收数据

    简述:      MPTCP在发送数据方面和TCP的区别是可以从多条路径中选择一条 路径来发送数据.MPTCP在接收数据方面与TCP的区别是子路径对无序包 进行重排后,MPTCP的mpcb需要多所有子 ...

  2. B8:中介者模式 Mediator

    用一个中介对象来封装一系列的对象交互,中介者使得各对象不需要显示地相互引用,从而使其耦合松散,而且可以独立的改变它们之间的交互. 减少了各对象之间的耦合,使得可以独立的改变或复用各个Mediator或 ...

  3. 使用Unity3D的50个技巧:Unity3D最佳实践

    转自:http://www.tuicool.com/articles/buMz63I  刚开始学习unity3d时间不长,在看各种资料.除了官方的手册以外,其他人的经验也是非常有益的.偶尔看到老外这篇 ...

  4. 用聚合数据API(苏州实时公交API)快速写出小程序

    利用聚合数据API快速写出小程序,过程简单. 1.申请小程序账号 2.进入开发 3.调用API.比如“苏州实时公交”小程序,选择的是苏州实时公交API. 苏州实时公交API文档:https://www ...

  5. selenuim-webdriver注解之@FindBy、@FindBys、@FindAll的区别

    selenium-webdriver中获取页面元素的方式有很多,使用注解获取页面元素是其中一种途径, 方式有3种:@FindBy.@FindBys.@FindAll.下文对3中类型的区别和使用场景进行 ...

  6. Vue webpack配置文件

    一.代码地址 github:https://github.com/MengFangui/VueWebpackConfig 二.配置说明 1.命令 (1)npm i 安装依赖包 (2)num run d ...

  7. C++高级进阶 第四季:const具体解释(二) 常量折叠

    一.文章来由 const具体解释之二 二.const 取代 #define const最初动机就是取代 #define. const 优于 #define: (1) #define没有类型检查,con ...

  8. 【DB2】国标行业分类存储,通过SQL查询出层级关系

    新建表 DROP TABLE Industry; CREATE TABLE Industry( IndustryCode VARCHAR(40),IndustryName VARCHAR(100),P ...

  9. Spring Sleuth和Zipkin跟踪微服务

    原文地址:http://www.cnblogs.com/skyblog/p/6213683.html 随着微服务数量不断增长,需要跟踪一个请求从一个微服务到下一个微服务的传播过程, Spring Cl ...

  10. TCP/IP ---封装与分用

    封装 当应用程序用T C P传送数据时,数据被送入协议栈中,然后逐个通过每一层直到被当作一串比特流送入网络.其中每一层对收到的数据都要增加一些首部信息(有时还要增加尾部信息),该过程如图1 - 7所示 ...