我们先来介绍一下关于ClippingNode，ClippingNode是Node的子类。 使用模板（stencil）绘制它裁剪的内容（子节点）。 模板（stencil）是另一个节点（Node），它不会被绘制。 裁剪是通过使用模板的（alphaThreshold调节的）alpha部分完成的。 更多…

#include <CCClippingNode.h>

类 ClippingNode 继承关系图:

模板与底板

最终显示效果是：在底板对应位置裁剪出模板形状部分并显示，图中灰色部分为显示效果

设置倒置：clippingNode:setInverted(true)

如果设置了倒置，显示效果如下（图中灰色部分为最终显示效果）：

示例代码

lua代码（主要代码）

– 遮罩效果

– 模板

local stencil = cc.Node:create()

local dogTmp = cc.Sprite:create(“res/dog.png”)

dogTmp:setPosition(cc.p(visibleSize.width/2,visibleSize.height/2))

stencil:addChild(dogTmp)

– 初始化一个裁剪节点

local clippingNode = cc.ClippingNode:create(stencil)

– 倒置（Inverted） 如果设置为真（true），模板（stencil）会被反转，此时会绘制内容而不绘制模板（stencil）。 默认设置为假（false）

clippingNode:setInverted(true)

–alpha阈值（threshold） 只有模板（stencil）的alpha像素大于alpha阈值（alphaThreshold）时内容才会被绘制。 alpha阈值（threshold）范围应是0到1之间的浮点数。 alpha阈值（threshold）默认为1（alpha测试默认关闭）

clippingNode:setAlphaThreshold(0)

– 底板

local floor = cc.LayerColor:create(cc.c4b(0,0,0,150))

clippingNode:addChild(floor)

sceneGame:addChild(clippingNode)

运行效果：倒置

运行效果：未倒置