Cocos2d-x Lua 截图功能：captureScreen 与 RenderTexture｜默然的博客

实现 Cocos2d-x 截图通常有两种方案：读取当前屏幕的 captureScreen，或把指定节点绘制到 RenderTexture。

captureScreen：截取当前屏幕

captureScreen 读取已经绘制的屏幕像素，保存过程是异步的，应在回调中判断结果并使用文件路径。

优点

1. 调用简单，适合分享当前画面。
2. 由回调返回实际保存结果和路径。

限制

1. 截取范围是当前渲染结果，不能直接指定某个节点或任意输出尺寸。
2. 读取像素会产生 CPU／GPU 同步和内存开销，不应高频调用。

使用示例

// C++ 接口
// 1. afterCaptured：截图后回调包含两个参数：
//    bool：截图是否成功
//    string：存储路径
// 2. filename：截图名字，可以是文件名，也可以是路径
void captureScreen(const std::function<void(bool, const std::string&)>& afterCaptured, const std::string& filename)

-- Lua 使用方法如下：
local fileName = "test.jpg"
cc.utils:captureScreen(function(success, filePath)
    -- todo
end, fileName)

RenderTexture：绘制指定节点

优点

• cocos2dx 所有版本都可以使用。
• 可以自定义截取的节点，保存图片可以包含alpha通道(png)。
• 可以控制离屏渲染的宽高；节点坐标和锚点仍需要按 RenderTexture 坐标系处理。

限制

• 稍稍麻烦点
• 只能保存在可读写目录下

自定义截图示例

-- 保存RenderTexture图片
-- fileName只能是文件名或相对路径(不能是绝对路径)，相对可读写目录下

function Capture(fileName, isPNG, width, height, ...)
    local nodes = {...}
    if #nodes == 0 or not fileName then return end

    -- 创建RenderTexture
    local screen
    if isPNG then
        screen = cc.RenderTexture:create(width, height, cc.TEXTURE2_D_PIXEL_FORMAT_RGB_A8888, gl.DEPTH24_STENCIL8_OES)
    else
        screen = cc.RenderTexture:create(width, height) 
    end
    
    screen:beginWithClear(0, 0, 0, 0)
    -- 遍历节点
    for _, node in pairs(nodes) do
        node:visit()
    end
    screen:endToLua()

    -- 保存文件
    screen:saveToFile(fileName, isPNG and cc.IMAGE_FORMAT_PNG or cc.IMAGE_FORMAT_JPEG, isPNG)
end

node:visit() 会按当前节点状态绘制。若节点尚未完成布局、依赖父节点裁剪，或需要精确截取区域，应先在目标机型验证坐标、缩放和透明通道。

相关阅读

• Cocos2d-x 实现 Android 与 iOS 背景透明
• Cocos2d-x 定时器