cocosCreator节点常用API及常见问题

阅读本文之前,默认你已经掌握cocosCreator的基本知识。

关于节点

节点在cocosCreator中是非常重要的,所以它的相关API至关重要。

  • 节点基本属性
    width: 节点宽度。
    height: 节点高度。
    name: 节点名称。
    color: 节点颜色。
    opacity: 节点透明度(0-255)。
    position: 节点在父节点坐标系中的位置。
    x: 节点 X 轴坐标(相当于父节点)。
    y: 节点 Y 轴坐标(相当于父节点)。
    anchorX: 节点 X 轴锚点位置(0-1之间)。
    anchorY: 节点 Y 轴锚点位置(0-1之间)。
    rotation: 该节点旋转角度。
    scale: 节点相对父节点的缩放。
    zIndex: 决定一个节点在兄弟节点之间的位置。
    active: 当前节点的自身激活状态。
    parent: 该节点的父节点。
    children: 节点的所有子节点。
    可以直接对属性赋值从而改变属性的值。
  • 节点基本方法
    getContentSize: 获取节点原始大小,不受该节点是否被缩放或者旋转的影响。
    setContentSize: 设置节点原始大小,不受该节点是否被缩放或者旋转的影响。
    getPosition: 获取节点在父节点坐标系中的位置(x, y)。
    setPosition: 设置节点在父节点坐标系中的位置。
    getScale: 获取节点的缩放。
    setScale: 设置节点的缩放比例,默认值为 1.0。
    getRotation: 获取该节点以局部坐标系 Z 轴为轴进行旋转的角度。
    setRotation: 设置该节点以局部坐标系 Z 轴为轴进行旋转的角度。
    getBoundingBox: 返回父节坐标系下的轴向对齐的包围盒。
    getBoundingBoxToWorld: 返回节点在世界坐标系下的对齐轴向的包围盒。
    convertToWorldSpace: 将一个相对于节点左下角的坐标位置转换到世界空间坐标系。
    convertToWorldSpaceAR: 将一个相对于节点锚点的坐标位置转换到世界空间坐标系。
    convertToNodeSpace: 将一个点转换到节点空间坐标系,这个坐标系以节点左下角为原点。
    convertToNodeSpaceAR: 将一个点转换到节点空间坐标系,这个坐标系以锚点为原点。
  • 节点操作查找相关方法
    getParent: 获取该节点的父节点。
    setParent: 设置该节点的父节点。
    addChild: 添加子节点。
    insertChild: 插入子节点到指定位置。
    removeChild: 移除节点中指定的子节点。
    removeAllChild: 移除节点所有的子节点。
    removeFromParent: 从父节点中删除该节点。
    getChildByName: 通过名称获取节点的子节点。
    getComponent: 获取节点上指定类型的组件。
    getComponents: 返回节点上指定类型的所有组件。
    addComponent: 向节点添加一个指定类型的组件类。
    removeComponent: 删除节点上的指定组件。
  • 节点事件相关方法
    on: 在节点上注册指定类型的回调函数。
    once: 注册节点的特定事件类型回调,回调会在第一时间被触发后删除自身。
    off: 删除之前与同类型,回调,目标注册的回调。
    targetOff: 移除目标上的所有注册事件。
    emit: 通过事件名发送自定义事件。
    dispatchEvent: 分发事件到事件流中。
    pauseSystemEvents: 暂停当前节点上注册的所有节点系统事件,节点系统事件包含触摸和鼠标事件。
    resumeSystemEvents: 恢复当前节点上注册的所有节点系统事件,节点系统事件包含触摸和鼠标事件。
  • 节点动作相关方法
    runAction: 执行并返回该执行的动作。
    stopAction: 停止并移除指定的动作。
    stopAllActions: 停止并且移除所有正在运行的动作列表。
    pauseAllActions: 暂停本节点上所有正在运行的动作。
    resumeAllActions: 恢复运行本节点上所有暂停的动作。
  • 注意点
    • 节点的width,height代表节点原始大小(与getContentSize方法的结果一样),不受节点缩放旋转的影响。
    • 节点旋转后,自身的坐标系也会一起旋转。所以一些转换坐标的方法结果会有变化。
    • 一个空节点设置颜色是无效的,可以给空节点添加Sprite渲染组件。

关于事件

Cocos Creator 支持的系统事件包含鼠标、触摸、键盘、重力传感四种。
鼠标和触摸事件被称为节点系统事件,键盘和重力传感事件被称为全局系统事件。
值得注意的是无论你的鼠标和触摸事件注册在哪个层级的节点上,获取到的位置坐标都是基于世界坐标系的
所以我们经常需要将坐标统一转换为世界坐标系进行相应的计算。

关于坐标系

Cocos Creator 的坐标系是笛卡尔右手系,即原点在左下角,x 向右,y 向上,z 向外。

关于Graphics组件的坑

Graphics组件提供了一系列绘画接口,和canvas的API差不多。但是在使用过程中还是有很多问题的,现就我遇到的问题简单描述并给出解决方案。

  • 问题一,1px划的线条在不同分辨率设备上会出现粗细不均,甚至线条丢失问题?
    原因:我们的画布会根据设备屏幕的实际分辨率并对场景中所有渲染元素进行适当的缩放,所以1px的线条在缩小到足够小的时候就会出现丢失问题。
    解决方案:确保在不同分辨率的设备上,线条宽度永远为1px。
    如果你的画布是适配高度的话,代码如下:
    lineWidth = 1 /cc.view.getScaleY()
    如果你的画布是适配宽度度的话,代码如下:
    lineWidth = 1 /cc.view.getScaleX()
    如果没有开启画布的任何适配模式,代码如下:
    lineWidth = 1 / Math.min(cc.view.getScaleX(), cc.view.getScaleY())
  • 问题二,对节点进行放大缩小会出现粗细不均,甚至线条丢失问题?
    原因:同问题一。
    解决:每次放大或缩小都进行一次重绘,确保lineWidth和原来的保持一致。
    lineWidth = 1 / Math.min(cc.view.getScaleX(), cc.view.getScaleY()) / scaleRatio
    scaleRatio为放大或缩小的比例。
    注意点:确保真实绘制的lineWidth乘以实际的缩放比例为整数,即我们‘/’号之前为整数,不然还是会出现丢失问题或粗细不均问题

资料

cocos-creator

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,736评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,167评论 1 291
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,442评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,902评论 0 204
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,302评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,573评论 1 216
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,847评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,562评论 0 197
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,260评论 1 241
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,531评论 2 245
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,021评论 1 258
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,367评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,016评论 3 235
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,068评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,827评论 0 194
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,610评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,514评论 2 269

推荐阅读更多精彩内容