文档章节

【Cocos2d-x 3.2】裁剪节点(ClippingNode)总结

piggybear
 piggybear
发布于 2015/02/16 10:33
字数 2076
阅读 6
收藏 0
点赞 0
评论 0

有时候我们需要显示一张图片的部分区域,比如文字遮罩、图片遮罩等。

1413252078639337.gif

1413252086148431.gif

本节要讲的ClippingNode的功能效果大致就是上面所看到的遮罩效果。

Demo下载裁剪节点ClippingNode.rar


ClippingNode

1、原理

ClippingNode(裁剪节点)可以用来对节点进行裁剪。ClippingNode是Node的子类,可以像普通节点一样放入Layer,Scene,Node中。

主要是根据一个模板(Stencil)切割图片的节点,生成任何形状的节点显示。

ClippingNode是利用模板遮罩来完成对Node区域裁剪的技术。

如何理解ClippingNode的遮罩?看下图的例子吧。

1413252348614271.jpg

2、举例说明

  • 模板(Stencil):可以使用Layer、Node、Sprite等。

  • 底板:可以使用Layer、Node、Sprite等。

  • Layer层


2.1、第一组(Layer层无背景图片)

  • 模板(Stencil):模板为Node节点,放入5个Sprite的小球。

  • 底板:底板为Node节点,放入1个Sprite的ABCD图。

  • Layer层:无元素,背景颜色为黑色。

wKioL1Q2Po3BRAGQAAA0HQ88DTw552.jpgwKiom1Q2PlXB8lS9AABDigaXvj0088.jpg


裁剪遮罩效果示意图:

wKioL1Q2QaHgGl_MAAAqz_2tsso946.jpg


2.2、第二组(Layer层有背景图片)

  • 模板(Stencil):模板为Node节点,放入5个Sprite的小球。

  • 底板:底板为Node节点,放入1个Sprite的ABCD图。

  • Layer层:有一个Sprite的Cocos2d-x背景图片。

wKioL1Q2QFjTWjVzAAA0HQ88DTw670.jpgwKioL1Q3cdTioMMRAABDigaXvj0272.jpg

1413252507335700.jpg

裁剪遮罩效果示意图:

1413252536137528.jpg

2.3、分析总结

通过ClippingNode进行裁剪遮罩,其实是这样的:

  • 将模板(Stencil)上所有元素的形状集合作为“形状模板”,其元素本身不渲染。

  • 使用“形状模板”对底板进行裁剪。

  • 显示从底板上裁剪下来的图片区域。

总的来说:

  • 模板(Stencil)相当于是一个样板,上面有很多不同形状的"洞洞"。

  • 然后根据样板,对底板进行裁剪,"挖洞"。

  • 然后将剪下来的那些碎片,按照原来的位置进行摆放。

其中:模板(Stencil)只是一个“形状模板”,本身的图片是不进行绘制的。


3、主要函数

ClippingNode继承于Node类,用于节点的裁剪与遮罩


3.1、创建ClippingNode

两种方式:是否使用模板(stencil)来创建。

1
2
3
4
5
6
7
//
     //创建,不含模板(stencil)
     ClippingNode* clippingNode = ClippingNode::create();
  
     //创建,使用模板(stencil)
     ClippingNode* clippingNode = ClippingNode::create(stencil);
//

    

3.2、设置模板(Stencil)

模板节点是Node的子类,一般常常使用DrawNode,因为它可以绘制不同形状的图形。当然也可以直接使用Node节点作为作为模板。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
//
/**
  *     用来做裁剪的模板(stencil)节点(Node)
  *     模板(stencil)对象,默认为空(nullptr)
  **/
     Node* stencil = Node::create();     //模板stencil节点Node
      
     stencil->addChild(spriteBall1);     //添加小球1
     stencil->addChild(spriteBall2);     //添加小球2
     stencil->addChild(spriteBall3);     //添加小球3
     stencil->addChild(spriteBall4);     //添加小球4
     stencil->addChild(spriteBall5);     //添加小球5
      
     clippingNode->setStencil(stencil);  //设置模板Stencil
//


3.3、设置底板(Content)

1
2
3
4
//
     //创建ClippingNode后,使用addChild()添加的节点,即为底板内容
     clippingNode->addChild(content);  //设置底板
//


3.4、倒置显示(Inverted)

  • false :显示被模板裁剪下来的底板内容。默认为false。

  • true  :显示剩余部分。

1
2
3
4
5
//
     //默认为false
     //表示显示被裁剪下来的底板内容
     clippingNode->setInverted( false );
//


3.5、alpha阈值(alphaThreshold)

alpha:表示像素的透明度值。

  • 只有模板(stencil)中像素的alpha值大于alpha阈值时,内容才会被绘制。

  • alpha阈值(alphaThreshold):取值范围[0,1]。

  • 默认为1,表示alpha测试默认关闭,即全部绘制。

  • 若不是1,表示只绘制模板中,alpha像素大于alphaThreshold的内容。

1
2
3
4
5
//
     //设置alpha透明度闸值
     //即显示模板中,alpha像素大于0.05的内容
     holesClipper->setAlphaThreshold(0.05f); 
//

具体说明:

以下是一张40*40的图片,其中小球以外的其他区域像素为透明的(即:alpha为 0 )。

wKiom1Q2UjvQHtewAAALmrZIcP4953.jpg

(1)在不设置AlphaThreshold闸值,或者setAlphaThreshold(1.0f),的情况下:

wKioL1Q2U-CyKJR5AABse9r4z7I334.jpg

(2)在设置setAlphaThreshold(0.5f),的情况下:

wKiom1Q2U6iTDl2eAABkCos2yS8384.jpg

(3)结论:

  • 可以发现在不设置alpha闸值时,模板绘制的区域为一个40*40的矩形。

  • 设置了alpha闸值为0.5时,透明度alpha为0的像素不被绘制,只绘制了一个小圆。


代码实战

这里讲几个有意思的例子。

  • 官方的“打洞”

  • “文字遮罩闪亮特效”

  • ClippingNode类的用途很广泛。


1、官方的“打洞”

官方cpp-test项目里有一个使用ClippingNode完成“打洞”效果的例子,我觉得挺有意思的。

更多的用法参见官方的cpp-test项目。

先来看看效果:

1413252819231280.gif

1.1、素材

wKioL1Q2ZxrB-Y6YAAAU9Ay8-xY568.jpgwKiom1Q2ZuPjBw-BAAApSSSykEk483.jpgwKiom1Q2ZuOjlIbYAAAgsovXLTM984.jpgwKioL1Q2Zxrhphj7AAAS3dBHhR8807.jpgwKioL1Q2ZxvwTfHMAAARDo45uo8587.jpg


1.2、在HelloWorld.h中添加如下变量与函数

1
2
3
4
5
6
7
8
9
10
//
     ClippingNode* holesClipper;  //裁剪节点
     Node* holesStencil;          //模板节点
     Node* holes;                 //底板节点
       
     //触摸回调
     void  onTouchesBegan( const  std::vector<Touch*>& touches, Event *unused_event);
     //添加小洞
     void  pokeHoleAtPoint(Vec2 point);
//


1.3、在HelloWorld.cpp中的init()中创建裁剪节点ClippingNode

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
//
//[1].背景图片(Layer层中)
     Sprite* bg = Sprite::create( "HelloWorld.png" );
     bg->setPosition(visibleSize / 2);
     this ->addChild(bg);
  
  
//[2].创建裁剪节点 : holesClipper
     holesClipper = ClippingNode::create();
     holesClipper->setPosition(visibleSize / 2);
     this ->addChild(holesClipper);
  
     //属性设置
     holesClipper->setInverted( true );         //倒置显示,未被裁剪下来的剩余部分
     holesClipper->setAlphaThreshold(0.5f);   //设置alpha透明度闸值
     holesClipper->runAction(RepeatForever::create(RotateBy::create(1, 45)));  //旋转动作
  
  
//[3].创建模板 : holesStencil
     holesStencil = Node::create();
     holesClipper->setStencil(holesStencil);  //设置模板节点
  
     //添加一个模板遮罩 ball
     holesStencil->addChild(Sprite::create( "ball.png" ), -1);
  
  
//[4].创建底板 : holes
     holes = Node::create();
     holesClipper->addChild(holes);  //设置底板
  
     //添加另一个底板内容 blocks
     Sprite* content = Sprite::create( "blocks.png" );
     holesClipper->addChild(content, -1,  "content" );
  
  
//[5].触摸事件
     auto listener = EventListenerTouchAllAtOnce::create();
     listener->onTouchesBegan = CC_CALLBACK_2(HelloWorld::onTouchesBegan,  this );
     _eventDispatcher->addEventListenerWithSceneGraphPriority(listener,  this );
//


1.4、设置触摸事件回调。当触摸点在底板区域内部,则“打洞”

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
//
void  HelloWorld::onTouchesBegan( const  std::vector<Touch*>& touches, Event *unused_event)
{
//[1].获取触点, 转换为相对holesClipper节点的 相对坐标
     Vec2 point = touches[0]->getLocation();
     point = holesClipper->convertToNodeSpace(point);
  
      
//[2].获取底板区域矩形Rect
     Sprite* content = (Sprite*)holesClipper->getChildByName( "content" );
     Size contentSize = content->getContentSize();
     Rect rect = Rect(-contentSize.width / 2, -contentSize.height / 2, contentSize.width, contentSize.height);
  
      
//[3].触摸点在底板内部, 进行"打洞"
     if  (rect.containsPoint(point))
     {
         pokeHoleAtPoint(point);
     }
}
//


1.5、实现“打洞”操作函数

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
//
void  HelloWorld::pokeHoleAtPoint(Vec2 point)
{
     CCLOG( "Add a Hole!!!" );
  
//[1].添加底板内容 : 一个洞的痕迹
     auto hole = Sprite::create( "hole_effect.png" );
     hole->setPosition(point);
     holes->addChild(hole);
  
  
//[2].添加模板内容 : 一个小洞
     auto holeStencil = Sprite::create( "hole_stencil.png" );
     holeStencil->setPosition(point);
     holesStencil->addChild(holeStencil);
  
  
//[3].动作效果 : 放大缩小
     holesClipper->runAction(Sequence::create(ScaleTo::create(0.05f, 1.05f), ScaleTo::create(0.05f, 1.0f), NULL));
}
//

    

1.6、分析与总结

这里设置了倒置显示(Inverted),即使用模板对底板进行裁剪后,显示未被剪下的剩余部分。

(1)模板Stencil:

wKiom1Q22CSBCmjdAAA-J6wfj8A949.jpg

(2)底板:

wKioL1Q22HmR_4EdAABMwf6hmrw107.jpg

(3)裁剪遮罩效果图:显示未被模板裁剪的剩余部分。

wKiom1Q22IyhiKtBAABO8mMA7jE713.jpg

2、“文字遮罩特效”

先来看看效果:

1413253059497294.gif

1413253074419641.gif

2.1、素材

1413253091926737.jpg   1413253098571627.jpg

1413253135661732.jpg

2.2、代码实现

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
//
//[1].背景图片
     Sprite* bg = Sprite::create( "HelloWorld.png" );
     bg->setPosition(visibleSize / 2);
     this ->addChild(bg, -1);
  
//[2].创建主题文字 : gameTitle
     Sprite* gameTitle = Sprite::create( "game_title.png" );
  
     //获取尺寸大小
     Size clipSize = gameTitle->getContentSize();
  
//[3].创建底板的发光图片 : spark
     Sprite* spark = Sprite::create( "spark.png" );
     spark->setPosition(-clipSize.width, 0);
  
//[4].创建裁剪节点 : clippingNode
     ClippingNode* clippingNode = ClippingNode::create();
     clippingNode->setPosition(visibleSize / 2);
     this ->addChild(clippingNode);
  
     clippingNode->setAlphaThreshold(0.05f);  //设置alpha闸值
     clippingNode->setContentSize(clipSize);  //设置尺寸大小
  
     clippingNode->setStencil(gameTitle);    //设置模板stencil
     clippingNode->addChild(gameTitle, 1);   //先添加标题,会完全显示出来,因为跟模板一样大小
     clippingNode->addChild(spark,2);        //会被裁减
  
//[5].左右移动spark
     MoveTo* moveAction = MoveTo::create(2.0f, Vec2(clipSize.width, 0));
     MoveTo* moveBackAction = MoveTo::create(2.0f, Vec2(-clipSize.width, 0));
     spark->runAction(RepeatForever::create(Sequence::create(moveAction, moveBackAction, NULL)));
//


2.3、分析与总结

实际上就是将文字作为模板Stencil,做出文字的“形状模板”,然后去裁剪底板。而底板则是由文字、发光棒组合而成,然后移动发光棒,就可以呈现文字发光的效果。

(1)模板Stencil:

1413253208448602.jpg

(2)底板:

1413253221970228.jpg

(3)剪裁遮罩效果图:

1413253234454630.jpg


推荐阅读:

【官方文档】ClippingNode的使用

Cocos2d-JS ClippingNode制作标题闪亮特效(“文字遮罩效果”)


来源网址:http://shahdza.blog.51cto.com/2410787/1561937

© 著作权归作者所有

共有 人打赏支持
piggybear
粉丝 3
博文 237
码字总数 37552
作品 0
西安
技术主管
Cocos2d-x v3.3-RC0 发布说明!

我们很高兴地宣布Cocos2d-x v3.3-RC0发布了! Cocos2d-x v3.3-RC0下载地址:http://cn.cocos2d-x.org/download 关于v3.3各个版本的特性和改动的话,可以参考这篇文档。 注意事项 lua 在新建工...

oschina ⋅ 2014/10/22 ⋅ 2

Cocos学习笔记

说明: (1)基于cocos2dx2.2.3,使用C++语言,在Visual Studio 2010进行开发的。 (2)基于cocos2dx3.x ,使用C++语言,在Visual Studio 2013 与 Xcode进行开发的。 (3)基于Cocos Code ID...

shahdza ⋅ 2014/08/12 ⋅ 0

Cocos2d-x 3.2.0 正式版发布,新增集成开发环境

Cocos2d-x 3.2.0 正式版发布,从该版本开始你可以使用 3D 骨架动画来创建 3D 形象,你可以让你的 Cocos2d-x 游戏适应 iOS 和 Android 系统;引入新的产品 —— Code IDE,支持 Lua 和 JavaSc...

oschina ⋅ 2014/07/20 ⋅ 23

谈一谈Cocos2d-x中的某些“大小”

[Cocos2d-x相关教程来源于红孩儿的游戏编程之路 CSDN博客地址:http://blog.csdn.net/honghaier] 红孩儿Cocos2d-X学习园地QQ群:249941957加群写:Cocos2d-x 谈一谈Cocos2d-x中的某些“大小”...

长平狐 ⋅ 2013/03/19 ⋅ 0

谈一谈Cocos2d-x中的某些“大小”

[Cocos2d-x相关教程来源于红孩儿的游戏编程之路 CSDN博客地址:http://blog.csdn.net/honghaier] 红孩儿Cocos2d-X学习园地QQ群:249941957加群写:Cocos2d-x 谈一谈Cocos2d-x中的某些“大小”...

长平狐 ⋅ 2012/11/19 ⋅ 1

Cocos移植到Android-通过命令行交叉编译打包

当我们在Windows下使用Visual Studio开发好Win32平台的游戏程序后,我们需要把它们移植到不同的平台上。Cocos2d-x支持很多个平台,然而,我们不可能介绍全部平台的移植。我们总结了目前业界流...

智捷课堂 ⋅ 2014/11/13 ⋅ 0

Cocos2d-js中使用纹理对象创建Sprite对象

本节我们会通过一个实例介绍纹理对象创建Sprite对象使用,这个实例如图5-2所示,其中地面上的草是放在背景(如下图所示)中的,场景中的两棵树是从后图所示的“树”纹理图片中截取出来的,图...

智捷课堂 ⋅ 2015/03/28 ⋅ 0

cocos2dx 3.x win7+VS2012开发环境搭建及HelloWorld

准备工作 (1)VS2012 (2)cocos2dx cn.cocos2d-x.org/download (3)python 新版本的cocos2dx 需要python编译 2. 安装软件 (1)VS2012 从官网下载并安装 (2)python 安装:下载地址: ww...

伽罗kapple ⋅ 2015/07/29 ⋅ 0

Cocos2d-x 3.x的Windows Phone 8工程

Cocos2d-x 3.x中我们使用的Cocos2d-x 3.2,它提供了Windows Phone 8平台的支持。下面我们介绍一下在Cocos2d-x 3.2中如何生成Cocos2d-x的Windows Phone 8工程,以及如何使用等问题。 生成Win...

智捷课堂 ⋅ 2014/11/25 ⋅ 0

购买李宁Cocos2d-x套餐,送最新出的《Cocos2d-x游戏实战指南》签名书一本

活动时间:2016-10-18至2016-11-30 通过本套餐,可完全了解Cocos2d-x 3.x的相关技术,以及掌握C++语言,并具有一定的项目实战经验。 Cocos2d-x游戏开发套餐:http://edu.51cto.com/pack/vie...

androidguy ⋅ 2016/10/17 ⋅ 0

没有更多内容

加载失败,请刷新页面

加载更多

下一页

对于程序员的招聘问题,作为软件人的一些吐槽和建议

作为软件人,找工作有时候似乎挺苦逼的。 说真的,让我去掉前面这句中“似乎”二字吧。就是苦逼!很多人都曾抱怨处在招聘的一方很糟糕——我们没有任何可靠的方式来甄别会写代码并且写得好的...

老道士 ⋅ 31分钟前 ⋅ 0

HDFS原理学习

一、概述 1、 Hadoop整合了众多的文件系统,首先提供了一个高层的文件系统抽象org.apache.hadoop.fs.FileSystem。然后有各个文件系统的实现类。 2、Hadoop是JAVA编写的,不同文件系统之间的交...

cjxcloud ⋅ 35分钟前 ⋅ 0

Linux下MySQL表名不区分大小写的设置方法(抄袭别人的)

Linux下MySQL表名不区分大小写的设置方法 MySQL表名不区分大小写的设置方法 在用centox安装mysql后,把项目的数据库移植了过去,发现一些表的数据查不到,排查了一下问题,最后发现是表名的大...

随风而浮沉 ⋅ 40分钟前 ⋅ 0

ubuntu下安装宋体simsun

sudo cp simsun.ttc /usr/share/fonts cd /usr/share/fonts sudo chmod 644 simsun.ttc 更新字体缓存: 代码: sudo mkfontscale 代码: sudo mkfontdir 代码: sudo fc-cache -fsv 安装chrome扩......

wangxuwei ⋅ 41分钟前 ⋅ 0

利用 ssh 传输文件

Linux 下一般可以用 scp 命令通过 ssh 传送文件: #把服务器上的 /home/user/a.txt 发送到本机的 /var/www/local_dir 目录下scp username@servername:/home/user/a.txt /var/www/local_dir...

大灰狼时间 ⋅ 51分钟前 ⋅ 0

web3j教程:android和java程序员如何使用web3j开发区块链以太坊

如何使用web3j为Java应用或Android App增加以太坊区块链支持,本教程内容即涉及以太坊中的核心概念,例如账户管理包括账户的创建、钱包创建、交易转账,交易与状态、智能合约开发与交互、过滤...

智能合约 ⋅ 今天 ⋅ 0

web3j开发java或android以太坊智能合约快速入门

web3j简介 web3j是一个轻量级、高度模块化、响应式、类型安全的Java和Android类库提供丰富API,用于处理以太坊智能合约及与以太坊网络上的客户端(节点)进行集成。 可以通过它进行以太坊区块链...

笔阁 ⋅ 今天 ⋅ 0

一起读书《深入浅出nodejs》-异步I/O

异步I/O “异步”这个名词其实很早就诞生了,但它大规模流行却是在Web 2.0浪潮中,它伴随着AJAX的第一个A(Asynchronous)席卷了Web。 为什么要异步I/O 关于异步I/O为何在Node里如此重要,这与...

小草先森 ⋅ 今天 ⋅ 0

JVM各种问题

1、如果启动什么都不设,会怎样? 先来看一个命令 [root@localhost bin]# java -XX:+PrintCommandLineFlags -version -XX:InitialHeapSize=29899008 -XX:MaxHeapSize=478384128 -XX:+PrintCo......

算法之名 ⋅ 今天 ⋅ 0

SAS笔记-宏2

宏是一种文本,一般来说其编译是在程序执行之前。 宏变量的创建 %let语句 %let macro_variables = text; %let是常见的宏变量建立方式,其编译就在执行前。如下例中,想要宏变量test等于数据集...

tonorth123 ⋅ 今天 ⋅ 0

没有更多内容

加载失败,请刷新页面

加载更多

下一页

返回顶部
顶部