cocos Creator + fairyGUI 快速入门

news2024/10/21 15:29:15

版本 Creator 3.8.x,FairyGUI 2022
大部分内容来自 https://en.fairygui.com/docs/sdk/creator

1.新建cocos项目,根目录运行 npm install --save fairygui-cc 引入 fairyGUI库
2.assets目录之外新建fairyGUI项目
3.fairyGUI中编辑UI 完成后发布到Creator的assets/resources目录或者其子目录下。注意,图片设置为RAW格式即可,不需要设置为Sprite。因为FairyGUI会自己分析Sprite。
4.加载。一种是你负责把文件加载,第二种是让FairyGUI自己去加载。第一种方式是方便你做一个混杂了其它资源的总体的加载,或者显示进度的需求等:

//这里填写的是相对于resources里的路径
    let res = [ 
        "UI/Bag",  //描述文件
        "UI/Bag_atlas0" //纹理集
    ];
    cc.loader.loadResArray(res, function(err, assets) {
        //都加载完毕后再调用addPackage
        fgui.UIPackage.addPackage("UI/Bag"); 

        //下面就可以开始创建包里的界面了。
    });
    
//这里填写的是相对于resources里的路径
    fgui.UIPackage.loadPackage("UI/Bag", function(err) {
        //这里不需要再调用addPackage了,直接可以开始创建界面了
    });

5.卸载。当一个包不再使用时,可以将其卸载。

//这里可以使用包的id,包的名称,包的路径,均可以
fgui.UIPackage.removePackage("Bag");

包卸载后,所有包里包含的贴图等资源均会被卸载,由包里创建出来的组件也无法显示正常(虽然不会报错),所以这些组件应该(或已经)被销毁。
一般不建议包进行频繁装载卸载,因为每次装载卸载必然是要消耗CPU时间(意味着耗电)和产生大量GC的。UI系统占用的内存是可以精确估算的,你可以按照包的使用频率设定哪些包是常驻内存的(建议尽量多)。
5.创建ui
每个场景 都需要有一个GRoot,这是UI的根节点。场景载入后,需要手动创建GRoot。

调用 fgui.GRoot.create();

public static create(): GRoot {
    GRoot._inst = new GRoot();
    director.getScene().getChildByName('Canvas').addChild(GRoot._inst.node);
    GRoot._inst.onWinResize();

    return GRoot._inst;
}

创建FGUI对象。

 let view:fgui.GComponent = fgui.UIPackage.createObject(“包名”, “组件名”).asCom;
    
    //以下几种方式都可以将view显示出来:
    
    //1,直接加到GRoot显示出来
    fgui.GRoot.inst.addChild(view);
    
    //2,使用窗口方式显示
    aWindow.contentPane = view;
    aWindow.show();
    
    //3,加到其他组件里
    aComponnent.addChild(view);

如果界面内容过多,创建时可能引起卡顿,FairyGUI提供了异步创建UI的方式,异步创建方式下,每帧消耗的CPU资源将受到控制,但创建时间也会比同步创建稍久一点。例如:

let handler = new AsyncOperation();
handler.createObject("包名","组件名", myCreateObjectCallback);

void myCreateObjectCallback(obj:fgui.Gobject)
{
}

关闭界面一般用隐藏即可,即:

//如果是加在GRoot或者其他父节点的
view.removeFromParent();

//如果是窗口
view.hide();

如果界面不再使用了,可以销毁它:

view.Dispose();

场景切换时,所有界面都会被销毁。如果不想被销毁,需要创建出界面后,把根节点设置为常驻,并且切换场景前,确保关闭界面。

cc.game.addPersistNode(view.node);

6.事件系统
FairyGUI直接使用了Creator的事件系统,所以GObject.on/off其实是通过GObject.node.on/off实现的,也就是可以通过GObject.node进行任何事件的操作,包括自定义的事件。在事件回调中,cc.Event中的currentTarget反映的是这个事件是由哪个node派发的,如果要获得这个node对应哪个GObject,可以用这样的方法:

aObject.on(someEventName, this.onHandle, this);

onHandle(evt:cc.Event) {
    cc.log(evt.currentTarget); //node对象
    cc.log(fgui.GObject.cast(evt.currentTarget)); //gobject对象
}

7.鼠标/触摸类事件
对于鼠标事件和触摸事件,FairyGUI里都使用自定义的事件,常量定义在fgui.Event里,这和Creator自身的cc.Node.EventType.TOUCH_BEGIN是不一样的,要注意区别。因为Creator自己的触摸逻辑很难处理穿透/不穿透,以及自定义区域点击这些情况。

鼠标/触摸事件回调函数有一个参数:evt:fgui.Event,fgui.Event继承于cc.Event。

TOUCH_BEGIN
鼠标按键按下(左、中、右键),或者手指按下。鼠标按钮可以从evt.button获得,0-左键,1-中键,2-右键。如果是触摸事件,可以从evt.touchId获得手指ID;如果是鼠标事件,evt.touchId恒定为0。

TOUCH_MOVE
鼠标指针移动或者手指在屏幕上移动。这个事件只有两种情况会触发,1、在TOUCH_BEGIN里调用了evt.captureTouch(),那么后续的移动事件都会在这个对象上触发(无论手指或指针位置是不是在该对象上方)。2、GRoot上的TOUCH_MOVE始终会触发,不需要使用captureTouch捕获。

TOUCH_END
鼠标按键释放或者手指从屏幕上离开。如果鼠标或者触摸位置已经不在GObject范围内了,那么组件的TouchEnd事件是不会触发的,如果确实需要,可以在TOUCH_BEGIN里调用evt.captureTouch()请求捕获。

CLICK
点击事件。可以从evt.isDoubleClick判断是单击还是双击。侦听点击事件有个快捷方式:GObject.onClick(callback,…),比GObject.on(fgui.Event.CLICK,…)简洁点。

ROLL_OVER 鼠标指针或者手指移入显示对象区域时触发。

ROLL_OUT 鼠标指针或者手指移出显示对象区域时触发。

MOUSE_WHEEL 鼠标滚动事件。

如果不在事件回调流程中,需要获得当前鼠标或者手指的位置,可以用:

//touchId是手指id,如果你不关心这个,不传入即可
let pos1:cc.Vec2 = fgui.GRoot.inst.getTouchPosition(touchId);

在任何时候,如果需要获得当前点击的对象,或者鼠标下的对象,都可以通过以下的方式获得:

let obj:fgui.GObject = fgui.GRoot.inst.touchTarget;

//判断是不是在某个Fgui组件内 
cc.Log(testComponent.isAncestorOf(obj));

8.字体
如果要使用ttf字体,需要这些步骤:

1、首先需要得到cc.Font对象,这个对象你是从loadRes获得,还是直接在场景中通过脚本的变量获得,可按照项目需求。

2、使用fgui.UIConfig.registerFont给这个cc.Font注册一个FairyGUI里使用的字体名称,假定aFont就是cc.Font对象:

fgui.UIConfig.registerFont('myfont', aFont);

3、如果这个是全局字体:

fgui.UIConfig.defaultFont = 'myFont';

4、如果这个是某个文字单独指定的字体,例如:

这里用到了"黑体"这个名字的字体,这是与UIConfig.defaultFont不同的字体,那么我们需要注册这种字体。即:

fgui.UIConfig.registerFont('黑体', aFont);

cocos 组件的声明周期接口:
在这里插入图片描述

注意事项:

1.fgui坐标系是以左上角为原点的。cocos则是左下角

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.coloradmin.cn/o/2220118.html

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈,一经查实,立即删除!

相关文章

细数RAG的12个痛点,英伟达高级架构师亲授解决方案

检索增强式生成(RAG)是一种使用检索提升语言模型的技术。具体来说,就是在语言模型生成答案之前,先从广泛的文档数据库中检索相关信息,然后利用这些信息来引导生成过程。这种技术能极大提升内容的准确性和相关性&#x…

野外便携定位终端|北斗三代短报文通信终端|移动通信终端

QM200B北斗三号便携终端是一款面对野外环境的北斗三代便携设备,具有低功耗、体积小、重量轻等特点。该设备不仅集成了北斗三代区域短电文通信、北斗三代定位功能、移动通信功能,同时具有语音对讲功能,配有液晶屏和功能按键,可在海…

一文彻底弄清Redis的布隆过滤器

布隆过滤器(Bloom Filter)是一种空间效率极高的数据结构,用于快速判断一个元素是否在集合中。它能够节省大量内存,但它有一个特点:可能存在误判,即可能会认为某个元素存在于集合中,但实际上不存…

说了很久的建筑转大模型,也不过是想在职场完成赎身

问:为什么从规划转行到大模型? 1、房子卖不掉了,城镇化进入存量时代,发展的蛋糕有限,规划行业式微;而且生态规划更多是保护性规划,不是发展性规划,地方政府的驱动力不足。 2、智能…

ArchLinux VSCode 1.94.2无法安装or更新解决办法

此方法参考了这篇博客https://www.debugpoint.com/failed-connect-raw-githubusercontent-com-port-443/#google_vignette 某一次paru后,一直报错503什么的,在archlinux官网看到pacman安装的是个Open VSX版本的,是Arch官方的版本,…

【记录】VSCode|自用设置项

文章目录 1 基础配置1.1 自动保存1.2 编辑区自动换行1.3 选项卡换行1.4 空格代替制表符1.5 开启滚轮缩放 2 进阶设置2.1 选项卡不自我覆盖2.2 选项卡限制宽度2.3 选项卡组限制高度2.4 字体设置2.5 字体加粗2.6 侧边栏2.7 沉浸式代码模式 Zen Mode2.8 设置 Zen 模式的选项卡组 3…

Vxe UI vue vxe-table grid 如何滚动、定位到指定行或列

Vxe UI vue vxe-table vxe-grid 在表格中有时候需要对数据会列进行操作。可以会定位到某一行或某一列,vxe-table 中提供了丰富的函数式 API,可以轻松对行与列进行各种的灵活的操作。 定位到指定行与列 通过调用 scrollColumn(columnOrField) 方法&…

【Python】图形用户界面

在Python中,开发图形用户界面(GUI)的工具包有许多种,常用的包括: Tkinter:Python的标准GUI库,作为Python内置的一部分,简单易用,适用于轻量级应用。PyQt/PySide&#xf…

探索面向对象编程的核心:类、对象与封装

探索面向对象编程的核心:类、对象与封装 在学习Java编程时,面向对象编程(OOP)是一个非常重要的核心概念。今天我们将深入探讨其中最基本、但却非常重要的组成部分:类和对象,以及它们是如何通过封装来实现数…

全网免费的文献调研方法以及获取外网最新论文、代码和翻译pdf论文的方法(适用于硕士、博士、科研)

1. 文献调研 学术搜索引擎(十分推荐前三个,超有用):使用 Google Scholar(https://scholar.google.com/)(https://scholar.google.com.tw/)(巨人学术搜索‬‬)、(三个都可以,镜像网站) arXiv(https://arxiv.org/)、&am…

企业架构系列(21)ArchiMate建模ADM阶段A:架构愿景

从本篇开始,将通过6篇文章逐一介绍如何使用 ArchiMate 的特定视角来创建与 TOGAF 架构开发方法相关的图形化模型或图表(即,ADM中的图形制品,Graphical Artifacts)。这些制品让利益相关者以可视化的方式来理解架构内容&…

vscode中每个打开的文件都显示在一个单独的标签页中

版本:1.94 实现步骤: 1、打开设置 File-》Preferences-》Settings 2、具体设置 2.1、在配置中搜索 workbench.editor.showTabs 设置为multiple。 2.2、在配置中搜索 workbench.editor.enablePreview 取消勾选。 根据这个功能的说明,在…

Java项目-基于springcloud框架的分布式架构网上商城系统项目实战(附源码+文档)

作者:计算机学长阿伟 开发技术:SpringBoot、SSM、Vue、MySQL、ElementUI等,“文末源码”。 开发运行环境 开发语言:Java数据库:MySQL技术:SpringBoot、Vue、Mybaits Plus、ELementUI工具:IDEA/…

背包九讲——完全背包问题

目录 完全背包问题 问题定义 动态规划解法 状态转移方程 初始化 遍历顺序 三种解法: 朴素版——枚举k 进阶版——dp正推(一维滚动数组) 背包问题第三讲——完全背包问题 背包问题是一类经典的组合优化问题,通常涉及在限定…

PCB走线线径与电流关系

转载自一个实验搞明白PCB走线应该画多宽_哔哩哔哩_bilibili

2011年国赛高教杯数学建模A题城市表层土壤重金属污染分析解题全过程文档及程序

2011年国赛高教杯数学建模 A题 城市表层土壤重金属污染分析 随着城市经济的快速发展和城市人口的不断增加,人类活动对城市环境质量的影响日显突出。对城市土壤地质环境异常的查证,以及如何应用查证获得的海量数据资料开展城市环境质量评价,研…

什么是智能电网?

智能电网(Smart Grid)被认为是当今电力行业发展的重要方向之一。它是传统电网与现代信息技术、通信技术和自动化技术深度融合的产物,旨在提高电力系统的效率、可靠性和可持续性。智能电网不仅仅是一个技术创新的名词,更是一个系统…

全域推广什么意思?如何搭建高效优质的全域推广服务商系统?

当前,全域推广一词的热度日渐升高,越来越多的人开始关注和计划入局这一全新项目,希望能够吃到第一波红利。不过,由于这一项目刚刚兴起,相关资料尚不完善,因此,绝大多数有意向入局的人都对该项目…

创客项目秀 | 基于使用 XIAO BLE Sense 和 Edge Impulse 的宠物活动跟踪器

今天为大家带来的是来自美国的创作者米顿-达斯的作品:宠物活动跟踪器.这个装置主要是为宠物主人提供关于宠物日常活动量的详尽数据,还能够根据宠物的独特需求,提供个性化的健康建议和活动指导。 项目背景 为了全面促进宠物的健康与活力,采用…