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)

運行效果：倒置

運行效果：未倒置

源碼下載