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

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


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

【致谢】

http://cn.cocos2d-x.org/article/index?type=cocos2d-x&url=/doc/cocos-docs-master/manual/framework/native/v3/ClippingNode/zh.md

http://www.waitingfy.com/archives/1093(“文字遮罩效果”)

【Demo下载】

http://down.51cto.com/data/1881321



【ClippingNode】

1、原理

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

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

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

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

2、举例说明

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

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

>Layer层

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

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

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

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

> 裁剪遮罩效果示意图:

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

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

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

Layer层 :有一个Sprite的cocos2dx背景图片

> 裁剪遮罩效果示意图:

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节点作为作为模板。

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)

4
//创建ClippingNode后,使用addChild()添加的节点,即为底板内容
clippingNode->addChild(content); //设置底板
3.4、倒置显示(Inverted)

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

> true :显示剩余部分。

5
//默认为false
//表示显示被裁剪下来的底板内容
clippingNode->setInverted( false );
3.5、alpha阈值(alphaThreshold)

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

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

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

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

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

//设置alpha透明度闸值
//即显示模板中,alpha像素大于0.05的内容
holesClipper->setAlphaThreshold(0.05f);
具体说明:

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

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

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

(3)结论:

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

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

【代码实战】

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

> 官方的“打洞”

“文字遮罩闪亮特效”

> ClippingNode类的用途很广泛,更多用法自行百度。

1、官方的“打洞”

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

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

先来看看效果:

1.1、素材

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

10
ClippingNode*holesClipper;
//裁剪节点
Node*holesStencil; //模板节点
Node*holes; //底板节点
//触摸回调
void onTouchesBegan( const std::vector<Touch*>&touches,Event*unused_event);
//添加小洞
pokeHoleAtPoint(Vec2point);
1.3、在HelloWorld.cpp中的init()中创建裁剪节点ClippingNode

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);
->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, );
_eventDispatcher->addEventListenerWithSceneGraphPriority(listener,monospace!important; font-size:1em!important; min-height:inherit!important; background:none!important">);
1.4、设置触摸事件回调。当触摸点在底板区域内部,则“打洞”

21
//
HelloWorld::onTouchesBegan( {
//[1].获取触点,转换为相对holesClipper节点的相对坐标
Vec2point=touches[0]->getLocation();
point=holesClipper->convertToNodeSpace(point);
//[2].获取底板区域矩形Rect
Sprite*content=(Sprite*)holesClipper->getChildByName( );
SizecontentSize=content->getContentSize();
Rectrect=Rect(-contentSize.width/2,-contentSize.height/2,contentSize.width,contentSize.height);
//[3].触摸点在底板内部,进行"打洞"
if (rect.containsPoint(point))
{
pokeHoleAtPoint(point);
}
}
1.5、实现“打洞”操作函数

21
HelloWorld::pokeHoleAtPoint(Vec2point)
{
CCLOG( "AddaHole!!!" );
//[1].添加底板内容:一个洞的痕迹
hole=Sprite::create( "hole_effect.png" );
hole->setPosition(point);
holes->addChild(hole);
//[2].添加模板内容:一个小洞
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:

(2)底板:

(3)裁剪遮罩效果图:

显示未被模板裁剪的剩余部分。

2、“文字遮罩特效”

先来看看效果:

2.1、素材

2.2、代码实现

37
//[1].背景图片
->addChild(bg,-1);
//[2].创建主题文字:gameTitle
Sprite*gameTitle=Sprite::create( "game_title.png" );
//获取尺寸大小
SizeclipSize=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);
->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,做出文字的“形状模板”,然后去裁剪底板。

而底板则是由文字、发光棒组合而成,然后移动发光棒,就可以呈现文字发光的效果。

(2)底板:

(3)剪裁遮罩效果图:

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。

相关推荐


    本文实践自 RayWenderlich、Ali Hafizji 的文章《How To Create Dynamic Textures with CCRenderTexture in Cocos2D 2.X》,文中使用Cocos2D,我在这里使用Cocos2D-x 2.1.4进行学习和移植。在这篇文章,将会学习到如何创建实时纹理、如何用Gimp创建无缝拼接纹
Cocos-code-ide使用入门学习地点:杭州滨江邮箱:appdevzw@163.com微信公众号:HopToad 欢迎转载,转载标注出处:http://blog.csdn.netotbaron/article/details/424343991.  软件准备 下载地址:http://cn.cocos2d-x.org/download 2.  简介2.1         引用C
第一次開始用手游引擎挺激动!!!进入正题。下载资源1:从Cocos2D-x官网上下载,进入网页http://www.cocos2d-x.org/download,点击Cocos2d-x以下的Download  v3.0,保存到自定义的文件夹2:从python官网上下载。进入网页https://www.python.org/downloads/,我当前下载的是3.4.0(当前最新
    Cocos2d-x是一款强大的基于OpenGLES的跨平台游戏开发引擎,易学易用,支持多种智能移动平台。官网地址:http://cocos2d-x.org/当前版本:2.0    有很多的学习资料,在这里我只做为自己的笔记记录下来,错误之处还请指出。在VisualStudio2008平台的编译:1.下载当前稳
1.  来源 QuickV3sample项目中的2048样例游戏,以及最近《最强大脑》娱乐节目。将2048改造成一款挑战玩家对数字记忆的小游戏。邮箱:appdevzw@163.com微信公众号:HopToadAPK下载地址:http://download.csdn.net/detailotbaron/8446223源码下载地址:http://download.csdn.net/
   Cocos2d-x3.x已经支持使用CMake来进行构建了,这里尝试以QtCreatorIDE来进行CMake构建。Cocos2d-x3.X地址:https://github.com/cocos2d/cocos2d-x1.打开QtCreator,菜单栏→"打开文件或项目...",打开cocos2d-x目录下的CMakeLists.txt文件;2.弹出CMake向导,如下图所示:设置
 下载地址:链接:https://pan.baidu.com/s/1IkQsMU6NoERAAQLcCUMcXQ提取码:p1pb下载完成后,解压进入build目录使用vs2013打开工程设置平台工具集,打开设置界面设置: 点击开始编译等待编译结束编译成功在build文件下会出现一个新文件夹Debug.win32,里面就是编译
分享一下我老师大神的人工智能教程吧。零基础!通俗易懂!风趣幽默!还带黄段子!希望你也加入到我们人工智能的队伍中来!http://www.captainbed.net前言上次用象棋演示了cocos2dx的基本用法,但是对cocos2dx并没有作深入的讨论,这次以超级马里奥的源代码为线索,我们一起来学习超级马里奥的实
1. 圆形音量button事实上作者的本意应该是叫做“电位计button”。可是我觉得它和我们的圆形音量button非常像,所以就这么叫它吧~先看效果:好了,不多解释,本篇到此为止。(旁白: 噗。就这样结束了?)啊才怪~我们来看看代码:[cpp] viewplaincopyprint?CCContro
原文链接:http://www.cnblogs.com/physwf/archive/2013/04/26/3043912.html为了进一步深入学习贯彻Cocos2d,我们将自己写一个场景类,但我们不会走的太远,凡是都要循序渐进,哪怕只前进一点点,那也至少是前进了,总比贪多嚼不烂一头雾水的好。在上一节中我们建
2019独角兽企业重金招聘Python工程师标准>>>cocos2d2.0之后加入了一种九宫格的实现,主要作用是用来拉伸图片,这样的好处在于保留图片四个角不变形的同时,对图片中间部分进行拉伸,来满足一些控件的自适应(PS: 比如包括按钮,对话框,最直观的形象就是ios里的短信气泡了),这就要求图
原文链接:http://www.cnblogs.com/linji/p/3599478.html1.环境和工具准备Win7VS2010/2012,至于2008v2版本之后似乎就不支持了。 2.安装pythonv.2.0版本之前是用vs模板创建工程的,到vs2.2之后就改用python创建了。到python官网下载版本2.7.5的,然后
环境:ubuntu14.04adt-bundle-linux-x86_64android-ndk-r9d-linux-x86_64cocos2d-x-3.0正式版apache-ant1.9.3python2.7(ubuntu自带)加入环境变量exportANDROID_SDK_ROOT=/home/yangming/adt-bundle-linux/sdkexportPATH=${PATH}:/$ANDROID_SDK_ROOTools/export
1开发背景游戏程序设计涉及了学科中的各个方面,鉴于目的在于学习与进步,本游戏《FlappyBird》采用了两个不同的开发方式来开发本款游戏,一类直接采用win32底层API来实现,另一类采用当前火热的cocos2d-x游戏引擎来开发本游戏。2需求分析2.1数据分析本项目要开发的是一款游
原文链接:http://www.cnblogs.com/linji/p/3599912.html//纯色色块控件(锚点默认左下角)CCLayerColor*ccc=CCLayerColor::create(ccc4(255,0,0,128),200,100);//渐变色块控件CCLayerGradient*ccc=CCLayerGradient::create(ccc4(255,0,0,
原文链接:http://www.cnblogs.com/linji/p/3599488.html//载入一张图片CCSprite*leftDoor=CCSprite::create("loading/door.png");leftDoor->setAnchorPoint(ccp(1,0.5));//设置锚点为右边中心点leftDoor->setPosition(ccp(240,160));/
为了答谢广大学员对智捷课堂以及关老师的支持,现购买51CTO学院关老师的Cocos2d-x课程之一可以送智捷课堂编写图书一本(专题可以送3本)。一、Cocos2d-x课程列表:1、Cocos2d-x入门与提高视频教程__Part22、Cocos2d-x数据持久化与网络通信__Part33、Cocos2d-x架构设计与性能优化内存优
Spawn让多个action同时执行。Spawn有多种不同的create方法,最终都调用了createWithTwoActions(FiniteTimeAction*action1,FiniteTimeAction*action2)方法。createWithTwoActions调用initWithTwoActions方法:对两个action变量初始化:_one=action1;_two=action2;如果两个a
需要环境:php,luajit.昨天在cygwin上安装php和luajit环境,这真特么是一个坑。建议不要用虚拟环境安装打包环境,否则可能会出现各种莫名问题。折腾了一下午,最终将环境转向linux。其中,luajit的安装脚本已经在quick-cocos2d-x-develop/bin/中,直接luajit_install.sh即可。我的lin
v3.0相对v2.2来说,最引人注意的。应该是对触摸层级的优化。和lambda回调函数的引入(嗯嗯,不枉我改了那么多类名。话说,每次cocos2dx大更新。总要改掉一堆类名函数名)。这些特性应该有不少人研究了,所以今天说点跟图片有关的东西。v3.0在载入图片方面也有了非常大改变,仅仅只是