08.插件命令zm 紫猫插件zm 图色处理
,

zm.SnapShot 无限截图

文章目录
  1. 1. 功能
  2. 2. 语法
  3. 3. 参数
  4. 4. 返回值
  5. 5. 示例
  6. 6. 备注

功能

通过每次截图自动生成不同文件名实现不覆盖文件的无限截图功能, 支持自定义图片名规则.

语法

结果 = zm.SnapShot(截图目录[, 文件名规则][, x1, y1, x2, y2][, 压缩比率])

参数

参数 数据类型 解释
截图目录 字符串 要存放文件的目录路径, 例如 "/sdcard/Pictures/"
文件名规则 字符串 可选, 自定义文件名规则, $n表示内置递增序号, $d表示当前日期, $t表示当前时间, 省略默认为”$d$t-$n.png”或”$d$t-$n.jpg”
x1 数值型 可选, 截取范围的左上角x坐标, 省略默认为0, 范围0,0,0,0表示全屏截图
y1 数值型 可选, 截取范围的左上角y坐标, 省略默认为0, 范围0,0,0,0表示全屏截图
x2 数值型 可选, 截取范围的右下角x坐标, 省略默认为0, 范围0,0,0,0表示全屏截图
y2 数值型 可选, 截取范围的右下角y坐标, 省略默认为0, 范围0,0,0,0表示全屏截图
压缩比率 数值型 可选, 0到100, 数值越大, 文件越小, 省略默认为0, 通过降低画质实现减少文件体积, 本参数仅支持按键IOS或按键安卓3.3.8以上版本

返回值

字符串, 返回保存图片文件的完整路径

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
Import "zm.luae" //导入插件,只需执行一次
zm.Init  //初始化插件,只需执行一次

Dim 图片文件夹 = "/sdcard/Pictures/"
Dim 图片路径, 图片名规则

//使用默认规则$d$t-$n.png截图, 产生图片文件名类似于 210311014843-1.png
//如果你无法理解文件名规则参数, 建议省略该参数
For 3
	图片路径 = zm.SnapShot(图片文件夹)
	TracePrint "默认规则", 图片路径
Next

//$n: 会根据文件夹与文件名自动把$n替换成序号, 需注意, 每次启动脚本都是从1开始计数的
图片名规则 = "QQ345911220-$n.png"
For 2
	图片路径 = zm.SnapShot(图片文件夹, 图片名规则)
	TracePrint "$n规则", 图片路径
Next

//$n: 根据文件夹与文件名自动生成序号, 需注意, 每次启动脚本都是从1开始计数的
//$d: 根据当前日期自动提取年月日, 需注意, 年份为缩写两位数, 例如210311表示2021年03月11日
//$t: 根据当前时间自动提取时分秒, 例如205515表示20点55分15秒
//建议根据自己实际情况设置规则, 如果你是1秒内要截图好几次的, 强烈建议带上$n规则
图片名规则 = "紫猫学院-$d-$t-$n.jpg"
For 3
	图片路径 = zm.SnapShot(图片文件夹, 图片名规则, 50) //压缩比50
	TracePrint "复合规则", 图片路径
Next

备注

  • 序号会根据图片的完整路径自动安排编号, 例如例子中两个图片名规则不同, 序号各自从1开始.
  • V4.2111: 初次加入