ms-types 0.9.25 → 0.9.26

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

@@ -22,15 +22,15 @@ declare namespace $图片 {
     区域右下角X坐标?: 数字,
     区域右下角Y坐标?: 数字,
   ): 字符串 | null;
-  /**
-   * 截图
-   * @returns 截图的imageId ，如果截图失败则返回null
-   * @deprecated 请改用 截取屏幕()。
-   * @example
-   * const 图片ID = $图片.截取屏幕()
-   * if (图片ID) {
-   *   $图片.保存图片(图片ID, "screen.jpg")
-   * }
+  /**
+   * 截图
+   * @returns 截图的imageId ，如果截图失败则返回null
+   * @deprecated 请改用 截取屏幕()。
+   * @example
+   * const 图片ID = $图片.截取屏幕()
+   * if (图片ID) {
+   *   $图片.保存图片(图片ID, "screen.jpg")
+   * }
    */
   function 截取全屏(): 字符串 | null;
   /**
@@ -38,14 +38,14 @@ declare namespace $图片 {
    * @param 区域左上角X坐标
    * @param 区域左上角Y坐标
    * @param 区域右下角X坐标
-   * @param 区域右下角Y坐标
-   * @returns 截图的imageId ，如果截图失败则返回null
-   * @deprecated 请改用 截取屏幕(区域左上角X坐标, 区域左上角Y坐标, 区域右下角X坐标, 区域右下角Y坐标)。
-   * @example
-   * const 图片ID = $图片.截取屏幕(0, 0, 100, 100)
-   * if (图片ID) {
-   *   $图片.保存图片(图片ID, "screen.jpg")
-   * }
+   * @param 区域右下角Y坐标
+   * @returns 截图的imageId ，如果截图失败则返回null
+   * @deprecated 请改用 截取屏幕(区域左上角X坐标, 区域左上角Y坐标, 区域右下角X坐标, 区域右下角Y坐标)。
+   * @example
+   * const 图片ID = $图片.截取屏幕(0, 0, 100, 100)
+   * if (图片ID) {
+   *   $图片.保存图片(图片ID, "screen.jpg")
+   * }
    */
   function 截取区域(
     区域左上角X坐标: 数字,
@@ -64,11 +64,11 @@ declare namespace $图片 {
   /**
    * 图片是否已释放
    * @param imageId 图片id
-   * @returns true 已释放 false 未释放
-   * @example
-   * const 图片ID = $图片.截取屏幕()
-   * if (图片ID) {
-   *   $图片.保存图片(图片ID, "screen.jpg")
+   * @returns true 已释放 false 未释放
+   * @example
+   * const 图片ID = $图片.截取屏幕()
+   * if (图片ID) {
+   *   $图片.保存图片(图片ID, "screen.jpg")
    *   $图片.图片是否被释放(图片ID) // false
    *   $图片.释放图片(图片ID)
    *   $图片.图片是否被释放(图片ID) // true
@@ -247,8 +247,10 @@ declare namespace $图片 {
    * @param 方法 方法
    * @param 是否使用RGB找图 是否使用RGB找图，默认false
    * @param 选项 选项
-   * @param 选项.scaleFactors 缩放匹配法缩放因子数组，默认[1.0, 0.9, 1.1, 0.8, 1.2]
-   * @returns 图片数组
+   * @param 选项.scaleFactors 仅方法=99 生效。模板缩放比例列表（不是屏幕 scale）。
+   *   应围绕 baseScale=当前设备宽/截模板设备宽 生成，例如 baseScale 附近 ±0.05~0.1 共 3~7 档；
+   *   默认 [1.0, 0.9, 1.1, 0.8, 1.2] 只适合尺寸接近时的盲扫，跨大分辨率请按设备动态计算。
+   * @returns 图片数组；方法=99 时结果额外含 scaleX/scaleY
    * @example
    * const 图片数组 = $图片.找图("screen", "template.jpg", 0, 0, 100, 100, 0.9, 1, 5, false)
    * if (图片数组.length > 0) {
@@ -280,6 +282,10 @@ declare namespace $图片 {
     centerY: 数字;
     ex: 数字;
     ey: 数字;
+    /** 仅方法=99 返回：命中时模板的横向缩放比例 */
+    scaleX?: 数字;
+    /** 仅方法=99 返回：命中时模板的纵向缩放比例 */
+    scaleY?: 数字;
   }[];
   /**
    * 裁剪图片