Cocos2d-x使用ClippingNode实现遮罩效果

关于ClippingNode

如下解析来自官方文档：http://cn.cocos2d-x.org/doc/cocos2d-x-3.0/d2/d06/classcocos2d_1_1_clipping_node.html

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)

运行效果：倒置

运行效果：未倒置

源码下载