ms-types 0.9.30 → 0.9.31

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ms-types",
-  "version": "0.9.30",
+  "version": "0.9.31",
   "type": "module",
   "license": "MIT",
   "publishConfig": {

package/types/image.d.ts

@@ -252,6 +252,9 @@ declare namespace image {
    * @param options.scaleFactors 仅 method=99 生效。模板缩放比例列表（不是屏幕 scale）。
    *   应围绕 baseScale=当前设备宽/截模板设备宽 生成，例如 baseScale 附近 ±0.05~0.1 共 3~7 档；
    *   默认 [1.0, 0.9, 1.1, 0.8, 1.2] 只适合尺寸接近时的盲扫，跨大分辨率请按设备动态计算。
+   * @param options.orz 查找方向 1-8，与 findColor 的 orz 相同。不传或非 1-8 时仍按相似度从高到低返回；
+   *   传入 1-8 时按该方向取前 limit 个达标结果。limit=1 时只返回该方向第一个，不必把其余命中都找出来。
+   *   method 0（SIFT）会先完成匹配再按方向排序截取。
    * @returns 图片数组；method=99 时结果额外含 scaleX/scaleY
    * @example
    * const points = image.findImage("screen", "template.jpg", 0, 0, 100, 100, 0.9, 1, 5, false)
@@ -272,6 +275,7 @@ declare namespace image {
     rgb?: boolean,
     options?: {
       scaleFactors?: number[];
+      orz?: number;
     },
   ): {
     index: number;

package/types/lua/image.lua

@@ -129,11 +129,12 @@ function _Image.cmpColor(id, points, threshold) return true end
 --- @param ey integer|nil 右下y
 --- @param threshold number 相似度 0.0-1.0
 --- @param limit integer|nil 限制个数
---- @param method integer|nil 匹配方法 1|3|5
+--- @param method integer|nil 匹配方法 0|1|3|5|99
 --- @param rgb boolean|nil 是否使用RGB
+--- @param options table|nil 选项。scaleFactors 仅 method=99；orz 为查找方向 1-8（与 findColor 相同）
 --- @return Rect[] 结果矩形列表
 function _Image.findImage(id, templateImageId, x, y, ex, ey, threshold, limit,
-                          method, rgb) return {} end
+                          method, rgb, options) return {} end
 
 --- 多点找色
 --- @param id string 图片ID

package/types/zh//345/233/276/347/211/207/346/250/241/345/235/227.d.ts

@@ -250,6 +250,9 @@ declare namespace $图片 {
    * @param 选项.scaleFactors 仅方法=99 生效。模板缩放比例列表（不是屏幕 scale）。
    *   应围绕 baseScale=当前设备宽/截模板设备宽 生成，例如 baseScale 附近 ±0.05~0.1 共 3~7 档；
    *   默认 [1.0, 0.9, 1.1, 0.8, 1.2] 只适合尺寸接近时的盲扫，跨大分辨率请按设备动态计算。
+   * @param 选项.orz 查找方向 1-8，与单点找色的查找方向相同。不传或非 1-8 时仍按相似度从高到低返回；
+   *   传入 1-8 时按该方向取前限制数量个达标结果。限制数量=1 时只返回该方向第一个，不必把其余命中都找出来。
+   *   方法 0（SIFT）会先完成匹配再按方向排序截取。
    * @returns 图片数组；方法=99 时结果额外含 scaleX/scaleY
    * @example
    * const 图片数组 = $图片.找图("screen", "template.jpg", 0, 0, 100, 100, 0.9, 1, 5, false)
@@ -270,6 +273,7 @@ declare namespace $图片 {
     是否使用RGB找图?: 布尔值,
     选项?: {
       scaleFactors?: 数字[];
+      orz?: 数字;
     },
   ): {
     index: 数字;