函数:drawImage 图中贴图
函数分类:tsimg.so
函数功能:在一张图片上贴另外一张图片,成功返回贴图对象,失败返回原因
引擎版本:iOS v3.0.5,Android v3.0.1 以上
函数方法
img3,msg = image.drawImage(img1,img2,tab)
| 参数 | 类型 | 必填 | 说明 | 
|---|---|---|---|
| img1 | usedata | 是 | 需要贴图的图片对象 | 
| img2 | usedata | 是 | 需要贴的图片对象 | 
| tab | table | 是 | 贴图设置参数 | 
tab 的参数介绍
| 参数 | 类型 | 必填 | 说明 | 
|---|---|---|---|
| left | number | 否 | 需要贴图的图片距离需要操作的图片上方的距离,不写默认为 0 | 
| top | number | 否 | 需要贴图的图片对象距离需要操作的图片左边的距离,不写默认为 0 | 
| alpha | number | 否 | 需要贴图的不透明度,范围 0 ~ 255,不写默认为 0 | 
| background | table | 否 | 需要贴图的偏色值 | 
| 返回值 | 类型 | 说明 | 
|---|---|---|
| img3 | usedata/nil | 贴图后的图片对象,失败显示空 | 
| msg | nil/string | 成功返回空,失败返回失败原因 | 
函数用例
local image = require("tsimg")  
local tab = {
    left = 50, 
    top = 50, 
    alpha = 0, 
    background = {
        {0xff0000,0x010101}
    }
}
snapshot("drawImage1.png", 100, 100, 300, 300)
snapshot("drawImage2.png", 350, 300, 450, 400)
--将文件转换为图片对象
local newImage1,msg = image.loadFile(userPath() .. "/res/drawImage1.png") 
if image.is(newImage1) then
    --将文件转换为图片对象
    local newImage2,msg = image.loadFile(userPath() .. "/res/drawImage2.png") 
    if image.is(newImage2) then
        --将1个图片对象贴大另1个图片对象上
        local newImage3,msg = image.drawImage(newImage1, newImage2,tab)
        if image.is(newImage3) then
            --将图片对象转换成图片保存在 res 文件夹下
            local boo,msg = image.saveToPngFile(newImage3,userPath() .. "/res/drawImage3.png")
            dialog(boo and "保存成功" or "保存失败 : " .. msg)
        else
            dialog(msg,3)
        end
    else
        dialog(msg,3)
    end
else
    dialog(msg,3)
end
注意事项
- Android 仅支持 v3.0.1 及其以上引擎版本。 
- 安卓普通版需要登录账号、购买 VIP 并且在调用过程中账号需要保持登录状态否则会导致调用失效。 
- Android 真机与模拟器 tsimg.so 文件不同,需要按照设备类型进行下载。 
- 点击 使用方法、tsimg.so 下载 查看使用方法及下载地址。