cocos2dx开发者指南：UI控件使用

最新推荐文章于 2020-12-29 07:53:38 发布
转载 最新推荐文章于 2020-12-29 07:53:38 发布 · 4.3k 阅读 · 7
标签
#cocos2d-x #ui #控件
本文详细介绍了Cocos2d-x中GUI模块的使用，包括Label、Menu、Buttons、Views等组件的创建与配置，以及如何使用BMFont、TTF、SystemFont创建文本，还涉及了菜单和菜单项的创建、布局容器的使用，以及GUI控件的容器与布局。文章旨在帮助开发者更好地理解和应用Cocos2d-x的GUI API。

综述

Cocos2d-x提供了一套易于使用的UI API来满足你的GUI需求，其中包括：Label、Menu、MenuItems、Buttons和Views。

Label（标签）

Cocos2d-x中提供了Label(标签)对象来创建TTF、BMFont和SystemFont文本。

Label BMFont（BMFont标签）

BMFont是使用位图字体的标签类型。位图字体是由点或像素矩阵所组成，这些点和像素代表了字符图形的外形和大小。位图字体的使用很方便也很容易，但它不可伸缩，其每个尺寸都需要一个单独的字体。

Label类是SpriteBatchNode的子类，所以Label的每个字符都可以看作一个Sprite（精灵），都具有旋转、缩放、着色，改变锚点以及其他继承自Node对象的属性。

创建一个BMFont文本需要两个文件：一个.fnt文件和一个显示每一个对象的.png格式的图片。利用像Glyph Designer这样的工具可以自动创建该类型的文件。 

创建一个BMFont文本：

1
auto myLabel = Label::createWithBMFont("myFont.fnt", "My Label Text");

字符串内所有的字符都要包含在MyFont.fnt文件中，否则它们将不会被渲染。假设渲染一个缺少字符的Label，那么就要确保它们都在你的MyFont.fnt文件中。

Label TTF（TTF标签）

TTF是一个 True Type Font 的标签类型。创建TTF标签你需要指定一个.ttf格式的字体文件名、文本字符串以及字体大小。与BMFont不同，TTF可以改变字体的显示大小，无需单独的字体。

创建一个TTF标签：

1
auto myLabel = Label::createWithTTF("myFont.ttf", "My Label Text", 16);

尽管TTF标签比BMFont更灵活，但它的效率是更低的，并且修改如字形和大小等属性都是一个复杂的操作。如下为使用TTF创建Label的示例：

如果你需要一些具有相同属性的TTF标签，你可以通过创建一个TTFConfig对象来管理它们。TTFConfig允许你为所有的TTF标签设置共同的属性。如下：

1
2
3
4
5
6
7
8
9
10
11
// create a TTFConfig files for labels to share
TTFConfig labelConfig;
labelConfig.fontFilePath = "myFont.ttf";
labelConfig.fontSize = 16;
labelConfig.glyphs = GlyphCollection::DYNAMIC;
labelConfig.outlineSize = 0;
labelConfig.customGlyphs = nullptr.
labelConfig.distanceFieldEnabled = false;
 
// create a TTF Label from the TTFConfig file;
auto myLabel = Label::createWithTTF(labelConfig, "My Label Text");

TTFConfig还可以用于显示中文、日文和韩文字符。

Label SystemFont（系统字体标签）

SystemFont是一个使用系统默认的字体和尺寸的标签类型。意思就是说我们不能修改字体的属性，你可以理解为是一种系统字体，系统规则。创建一个SystemFont标签：

1
auto myLabel = Label::createWithSystemFont("My Label Text", "Arial", 16);

标签效果和排版

标签效果

Label对象有一些实话它们的特效效果。当然，不是所有的标签类型都支持所有的特效。这些特效包括阴影、轮廓和光晕效果。

1
2
// shadow effect is supported by all Label types
myLabel->enableShadow();
1
2
// outline effect is TTF only, specify the outline color desired
label->enableOutline(Color4B(100, 50, 100, 100));
1
2
// glow effect is TTF only, specify the glow color desired.
label->enableGlow(Color4B(100, 50, 100, 100));

菜单和菜单项

Menu 是游戏选项的导航。菜单通常包含如播放、退出、设置和关于等选项。通常以可点击的按钮形式显示。

菜单由什么组成

Menu是一个特殊的Node对象，下列代码创建一个空Menu：

1
auto myMenu = Menu::create();

菜单选项和添加到菜单

MenuItems是Menu的核心。菜单选项通常有一个正常状态、一个被选择的状态以及一个回调。回调通常发生在MenuItems被选择的时候。

1
2
3
4
5
6
7
// creating a menu with a single item
 
// create a menu item
auto closeItem = MenuItemImage::create("CloseNormal.png", "CloseSelected.png", CC_CALLBACK_1(HelloWorld::menuCloseCallback, this));
 
auto menu = Menu::create(closeItem, NULL);
this->addChild(menu, 1);

菜单还可以使用MenuItem对象的Vector创建：

1
2
3
4
5
6
7
8
9
10
11
12
// creating a Menu from a Vector of items
Vector<MenuItem*> MenuItems;
 
auto closeItem = MenuItemImage::create("CloseNormal.png", "CloseSelected.png",
CC_CALLBACK_1(HelloWorld::menuCloseCallback, this));
 
MenuItems.pushBack(closeItem);
 
/* repeat for as many menu items as needed */
 
auto menu = Menu::createWithArray(MenuItems);
this->addChild(menu, 1);

Lambda作为菜单回调

lambda 函数是指可以在源代码中编写内联函数的函数。Cocos2d-x中可以使用 lambda 函数，你甚至可以将 lambda 函数作为回调函数。除了Menu回调， lambda 函数可用作多种函数。

一个简单的lambda函数：

1
2
auto func = [] () { cout << "Hello world"; };
func(); // now call the function

使用lambda作为Action函数：

1
2
3
auto action1 = CallFunc::create([&](){
    std::cout << "using a Lambda callback" << std::endl;
});

使用lambda创建一个std::function：

1
2
3
4
5
std::function<void()> myFunction = []()
{
    std::cout << "From myFunction()" << std::endl;
};
auto action2 = CallFunc::create(myFunction);

使用lambda作为MenuItem回调：

1
2
3
4
auto closeItem = MenuItemImage::create("CloseNormal.png", "CloseSelected.png",
[&](Ref* sender){
    // your code here
});

GUI控件和容器

综述

新的GUI模块是基于GUI控件的框架，最开始设计是用于Cocos Studio中。新的GUI模块的父类是继承自ProtectedNode的ui::Widget。当从ProtectedNode中添加或者移除子节点时，ProtectedNode用于控制内部Node列表。内部节点列表不会被触发，对于保持模块内部渲染组件很安全。我们可以将GUI分成两部分： Widget （控件）和 Containers （容器）。

Layout（布局）

Layout类是所有容器的父类，它继承自Widget。Layout类主要用于陈列子控件和剪裁。

LayoutManager、LayoutParameter和Margin类用于陈列元素。HBox、VBox和RelativeBox可以很方便地将子控件水平地、垂直地、相对地陈列子控件。

ScrolView、ListView和PageView是针对某些场景使用的指定容器。我们将在另一章节中详细讲解。

Widgets（组件）

Widgets（组件）是GUI对象，使用组件可以很容易地创建用户界面。下面我们来一起讨论下你可能会用到的一些常用组件：

Buttons（按钮）

按钮用来拦截触摸事件，点击按钮会调用一个预定义的回调函数。它继承自ui::Widget，这个类提供了设置按钮标题、图像以及其他属相的方法。每个按钮都有一个正常状态和一个被选择的状态。Button的外观根据状态而改变。创建一个Button很简单：

1
2
3
4
5
6
auto button = Button::create("animationbuttonnormal.png",
                                    "animationbuttonpressed.png");
button->setTitleText("Text Button");
button->setPosition(Vec2(0,0));
button->addTouchEventListener(CC_CALLBACK_2(UIButtonTest::touchEvent, this));
this->addChild(button);
CheckBox（复选框）

CheckBox允许用户可以做多重选择。CheckBox可以有正常、被选择、不可选三种状态。创建一个CheckBox很简单：

1
2
3
4
5
6
7
8
9
auto checkBox = CheckBox::create("check_box_normal.png",
                                        "check_box_normal_press.png",
                                        "check_box_active.png",
                                        "check_box_normal_disable.png",
                                        "check_box_active_disable.png");
checkBox->setPosition(Vec2(0,0));
 
checkBox->addEventListener(CC_CALLBACK_2(UICheckBoxTest::selectedEvent, this));
this->addChild(checkBox);
LoadingBar（进度条）

LoadingBar可用于显示操作的进程，例如下载、文件传输等，也可以称其为状态条。创建一个LaodingBar：

1
2
3
4
auto loadingBar = LoadingBar::create("sliderProgress.png");
loadingBar->setDirection(LoadingBar::Direction::RIGHT);
loadingBar->setPosition(Vec2(0,0));
this->addChild(loadingBar);
Slider（滑动条）

滑动条允许用户通过移动一个指标来设定值。创建一个Slider:

1
2
3
4
5
6
7
auto slider = Slider::create();
slider->loadBarTexture("sliderTrack.png");
slider->loadSlidBallTextures("sliderThumb.png", "sliderThumb.png", "");
slider->loadProgressBarTexture("sliderProgress.png");
slider->setPosition(Vec2(0,0));
slider->addEventListener(CC_CALLBACK_2(UISliderTest::sliderEvent, this));
this->addChild(slider);
ImageView（图像显示控件 ）

ImageView是一个展示图片的占位符。支持触摸事件、对焦、百分比定位和内容大小百分比。创建一个ImageView：

1
2
3
auto imageView = ImageView::create("ccicon.png");
imageView->setPosition(Vec2(0,0));
this->addChild(imageView);

还可以通过SpriteFrame创建一个ImageView：

1
2
3
4
auto imageView = ImageView::create("ccicon.png",
TextureResType::PLIST);
imageView->setPosition(Vec2(0,0));
this->addChild(imageView);
Text（文本）

Text控件用于展示文本。还可以将其用作一个写了字的按钮。Text支持系统默认字体和TTF字体。创建一个Text控件：

1
2
3
auto text = Text::create("Text","fonts/MyTTF.ttf",30);
text->setPosition(Vec2(0,0));
this->addChild(text);

与其他Label对象一样，你可以给文本添加阴影、光晕、轮廓等特效。

TextBMFont

TextBMFont控件用于显示BMFont文本。支持触摸事件、对焦、百分比定位和内容大小百分比。创建一个TextBMFont与创建Text控件一样：

1
2
3
auto textBMFont = TextBMFont::create("BMFont", "bitmapFontTest2.fnt");
textBMFont->setPosition(Vec2(0,0));
this->addChild(textBMFont);
TextAtlas

TextAtlas控件用于将文本显示为Atlas字体。支持触摸事件、对焦、百分比定位和内容大小百分比。

1
2
3
auto textAtlas = TextAtlas::create("1234567890", "labelatlas.png", 17, 22, "0");
textAtlas->setPosition(Vec2(0,0));
this->addChild(textAtlas);
RichText（富文本）

RichText控件用于显示文本、图像和常用节点。支持触摸事件、对焦、百分比定位和内容大小百分比。当接收到一个触摸事件时，整个RichText控件都接收这个事件。创建一个Richtext控件：

1
2
3
4
5
6
7
8
9
10
auto richText = RichText::create();
richText->ignoreContentAdaptWithSize(false);
richText->setContentSize(Size(100, 100));
 
auto re1 = RichElementText::create(1, Color3B::WHITE, 255, str1, "Marker Felt", 10);
 
richText->pushBackElement(re1);
richText->setPosition(Vec2(0,0));
richText->setLocalZOrder(10);
this->addChild(_richText);
TextField

TextField控件用于输入文本。支持触摸事件、对焦、百分比定位和内容大小百分比。创建一个TextField控件：

1
2
3
4
auto textField = TextField::create("input words here","Arial",30);
textField->setPosition(Vec2(0,0));
textField->addEventListener(CC_CALLBACK_2(UITextFieldTest::textFieldEvent, this));
this->addChild(textField);

总结Cocos2d-x 3.0 中新字体标签Label
harbinxxh的专栏
10-11 3万+
来源网址：http://cn.cocos2d-x.org/tutorial/show?id=1624
Ubuntu下配置RealSense D435i环境：从驱动安装到Python接口测试
最新发布
weixin_30466039的博客
04-17 286
本文详细介绍了在Ubuntu系统下配置Intel RealSense D435i深度相机的完整流程，包括驱动安装、Python接口（pyrealsense2）配置以及基础功能测试。通过实战代码示例展示了深度流采集、点云生成等核心功能，并提供了常见问题的解决方案，帮助开发者快速搭建3D视觉开发环境。
cocos2dx 字体外发光_《Cocos2d-x游戏开发实战精解》学习笔记2--在Cocos2d-x中显示一行文字...
weixin_34856444的博客
12-29 387
在Cocos2d-x中要显示文字就需要用到Label控件。在3.x版本的Cocos2d中，舍弃了之前版本所使用的LabelTTF、LabelAtlas、LabelBMFont 3个用于显示文字的类，而使用一个新类Label取代。可想而知，Label实际上就是对之前3个类进行重新封装并统一渲染。提示：实际上老版本的内容在3.x版本中依然是可以使用的。下面是在Cocos2d-x中显示文字的一个例子，具...
Cocos2dx之UI组件
weixin_40763897的博客
02-24 2726
Cocos2d-x提供了一套UI组件。包括 Label Menu Buttons Checkbox Loading Bar Slider TextField Label Cocos2d-x提供Label对象，可以用真值类型、bitmap（位图）或内置系统字体来创建。 Label BMFont BMFont是一种Label类型，它使用bitmap（位图）字体。位图中的字符由点的矩阵组...
COCOS2D-X字体描边
guoyalon的博客
11-01 1399
cocos2d-x3.16版本，原有的描边函数enableOutline会在渐出时出错，文字消失了描边停留在那里。 所以自己在网上找了个描边的函数，另外修改了一部分，做成了一个COCOS2D的工具类。 LabelWithStroke.h #ifndef __LabelWithStroke_H__ #define __LabelWithStroke_H__ #i
Cocos2d-x 3.0心得（03）－CocosBuilder扩展自定义参数
SingleWizard的专栏
05-22 1491
cocosbuilder是比较方便的工具，不过功能未免有点落后了，今天就碰到个问题。cocos2dx 3.0的LabelTTF是可以设置阴影、轮廓效果的，但是builder里没有相应的设置。不过还好builder扩展性还不错，所以就自己动手加吧。 首先是定义一个新的loader，就叫MyLabelTTFLoader吧： class MyLabelTTFLoader : public Label
Cocos2dx UI系列控件其一
GladiolusLai的博客
09-21 3110
游戏开发中，经常会使用到很多有关界面的控件，这些都属于UI控件。 所有UI控件的基类都继承Widget类，这个类是节点类的一种，若要自定义UI控件，继承这个类是必须的。 Widget类里包含了： FocusDirection 控件焦点方向 PositionType 布局系统中的控件位置类型 SizeType 布局系统中的控件尺寸类型 TouchEventType 触摸事件类型 Tex
cocos2dx3.10-lua_使用官方示例的方式获取UI控件
haibo19981的专栏
08-05 7043
以下是在cocos2dx-3.10-lua中 1.概述 cocosstudio的MainScene.csb中 Scene --bg --Btn_1 --Check_1 2.实例 (1)传统的获取UI控件的方法如下： MainScene.lua-------------- local MainScene = class("MainScene", cc.lo
cocos2dX UI控件之CCLabelTTF
hushuai1992
05-18 1338
这个， 由于群里问的朋友比较多，
Cocos2dx UI系列控件其二
GladiolusLai的博客
09-21 1696
接上篇文章 8、复选框-CheckBox 该控件如名字，就是一个复选框。 static CheckBox* create() //创建一个对象 void loadTextures(const std::string& backGround,const std::string& backGroundSelected,const std::string& cross,const std::st
Cocos2dx之使用UI库结合cocostudio
yky138495的专栏
08-20 503
分类： cocos2d-x2014-08-05 12:19 7人阅读 评论(0) 收藏 举报 目录(?)[+]    Cocos2dx之使用UI库结合cocostudio 分类： cocos2dx2014-03-21 16:10 735人阅读 评论(0) 收藏 举报 cocos2dxcocostudioui 目录(?)[+
cocos2dx 3.0 简单使用 CocoStudio UI Editor
shun_fzll的专栏
05-17 5201
想一想如今大三快结束了，面试笔试的经验几乎为零点零零好几（等等，为什么不是零），好吧，其实有过那么一两次，不过可气人的是公司竟然打着培训的幌子坑我们这种小年轻，太可恶了，要不是当初接待我们的那个小前台还是蛮不错的，长相甜美温柔可人，我就....（能怎样！） 好吧，昨天菊花（菊花是谁？）说有公司来我们这学校招聘，一听就好激动的样子，做的是c++底层相关的一些东西，不管如何都要先去试试这水深不深啊，
cocos2dX UI控件之CCLabelBMFont与CCLabelAtlas
hushuai1992
05-20 1302
嘿嘿, 我又回来了, 今天我们来看看
cocos2dX UI控件之CCProgress
hushuai1992
05-31 1321
cocos2dX UI控件之CCProgress, 技能冷却与进度条
Cocos2d-x 3.9教程：10.使用CocosStudio的UI编辑器从UI文件中加载布局和控件
热门推荐
tiancao222的博客
04-09 1万+
Cocos2d-x 3.9教程 10. 使用CocosStudio的UI编辑器从UI文件中加载布局和控件 1.1. 使用CocosStudio的UI编辑器 1.1.1. 安装和启动 从官网上下载2015年11月18日版本，Cocos studio 2.3.3。   安装完毕后，桌面出现两个图标。 Cocos Studio是我们的UI、动画等编辑器。Cocos是项目管理器，且它
cocos2dX UI控件之CCMenu
hushuai1992
05-21 1254
说道游戏, 有个我们不等bushu
cocos2dx ui编辑器生成界面的管理
后大学时代学习笔记
03-18 4124
说这个问题之前，先说不用各种UI编辑器的时候，开发一个界面的样子。         比如我们要做这样一个界面（图片素材来自百度图片，侵权不怪我。。。）         我们应该肿么处理这个界面，为了代码好看，可以复用等原因，显然是应该分层分组件，就像这样。         然后我们开始编辑代码，分3个layer，每个layer里面加各种按钮，写上各种触发函数。然后其他地方要用，只需要
cocos2dX UI控件之CCEditBox
hushuai1992
05-23 1605
刚刚看了看以前写的博客, 我们已经学了CCLabelTT
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值