函数: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 下载 查看使用方法及下载地址。

Copyright 北京帮你玩科技有限公司 2023 all right reserved,powered by Gitbook该文章修订时间: 2024-03-06 17:50:18

results matching ""

    No results matching ""