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 继承关系图:


模板与底板


Cocos2d-x使用ClippingNode实现遮罩效果_第1张图片

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


        设置倒置: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)


运行效果:倒置

Cocos2d-x使用ClippingNode实现遮罩效果_第2张图片

运行效果:未倒置

Cocos2d-x使用ClippingNode实现遮罩效果_第3张图片

源码下载

你可能感兴趣的:(Cocos2d-x使用ClippingNode实现遮罩效果)