函数:newTextImage 新建文本图片
函数分类:tsimg.so
函数功能:新建一个文本图片对象
引擎版本:iOS 专业版,Android v3.0.1 以上
函数方法
newImage,msg = image.newTextImage(w,h,str,tab)
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
w | number | 是 | 图片宽度 |
h | number | 是 | 图片高度 |
str | string | 是 | 文件内容 |
tab | table | 是 | 文字设置参数 |
tab 参数
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
font | string | 是 | 字体库,Windows 电脑存放位置:C:\Windows\Fonts\ |
size | number | 否 | 字体大小,不写默认为 2 |
color | number | 否 | 字体颜色,不写默认为 0xffffff(白色) |
alpha | number | 否 | 字体不透明度,不写默认为 255 |
back_color | number | 否 | 背景色,不写默认为 0x000000(黑色) |
back_alpha | number | 否 | 背景不透明度,不写默认为 255 |
x | number | 否 | 写入文字位置的横坐标,不填默认为 0, 此参数为相对于新建图片对象的位置 |
y | number | 否 | 写入文字位置的纵坐标,不填默认为 0, 此参数为相对于新建图片对象的位置 |
返回值 | 类型 | 说明 |
---|---|---|
newImage | usedata/ni | 创建成功返回图片对象,失败返回为空 |
msg | string/nil | 失败返回失败原因,成功返回为空 |
函数用例
local image = require("tsimg")
local newImage, msg = image.newTextImage(300,300,"新建一个文本图片对象",
{
font = userPath() .. "/res/simkai.ttf",
size = 20,
color = 0xFFFF00,
alpha = 255,
back_color = 0x0000ff,
back_alpha = 255,
x = 20,
y = 150,
})
if image.is(newImage) then
--将图片对象转换为图片
local boo,msg = image.saveToPngFile(newImage,userPath() .. "/res/newTextImage.png")
dialog(boo and "保存成功" or "保存失败 : " .. msg)
else
dialog("创建失败"..msg,3)
end
注意事项
Android 仅支持引擎版本 v3.0.1 及其以上,支持标准版、旗舰版、小精灵、企业版。
安卓普通版需要登录账号、购买 VIP 并且在调用过程中账号需要保持登录状态否则会导致调用失效。
iOS 支持专业版、企业版、小精灵。
Android 真机与模拟器 tsimg.so 文件不同,需要按照设备类型进行下载。
点击 使用方法、tsimg.so 下载 查看使用方法及下载地址。