函数:snapshot 截图
函数名称:截图
函数功能:截取屏幕中指定区域的图像并生成指定格式的图片文件
函数方法
snapshot(picname,x1,y1,x2,y2,quality)
必填
参数 | 类型 | 说明 |
---|---|---|
picname | string | 截图保存的文件名 不写默认保存到 screenshot 文件夹下(具体介绍详见下方注意事项) 自建目录请填写绝对路径 |
x1 | number | 截图区域左上角顶点屏幕横坐标 |
y1 | number | 截图区域左上角顶点屏幕纵坐标 |
x2 | number | 截图区域右下角顶点屏幕横坐标 |
y2 | number | 截图区域右下角顶点屏幕纵坐标 |
选填
参数 | 类型 | 说明 |
---|---|---|
quality | number | 仅支持 iOS, 当截图格式选为 jpg 时, 可用此参数控制图片质量,此参数值为大于 0 且小于等于 1 的值 |
返回值
无
函数用例
for i=1,5 do
--默认保存到 screenshot 文件夹下
snapshot(i..".png", 0, 0, 639, 1135);
--snapshot(i..".png", 0, 0, 639, 1135);
end
--全屏截图(iPhone 5, 5S),并以当前日期为文件名保存
--请输入真实存在的路径,路径不存在将截图失效
current_time = os.date("%Y-%m-%d", os.time());
snapshot("C:\\Users\\cce\\Desktop\\1112\\"..current_time..".png", 0, 0, 639, 1135)
--snapshot("C:/Users/cce/Desktop/1112/"..current_time..".png", 0, 0, 639, 1135)
注意事项
只写文件名称默认保存到 screenshot 文件夹下(触动智控客户端右上角头像 - 设置中心中可以打开 screenshot 文件夹)
绝对路径需要输入正确的文件夹路径,并且用 \\ 或者 / 代替文件夹路径。
Android 系统保存图片支持 png 及 jpg 格式,不可以设置质量;iOS 系统保存图片的格式可为 bmp, jpg, png,因为 png 是 iOS 中最常见的格式,所以推荐选择 png。
本文 iOS 实例中 os.date 与 os.time 为 Lua 基本库函数,请查阅附录 Lua 操作系统函数库
".." 为字符串连接操作符,可以将字符串变量、常量连接在一起。
本文 iOS 实例中 640*1136 为 iPhone 5,5S 等设备的分辨率,实际使用中请根据运行设备替换为对应值。