@bettergi/utils 0.1.9 → 0.1.10

package/README.md

@@ -47,13 +47,13 @@ await navigateToTab(() => {
 > 对 RecognitionObject 代码的封装，对于简单的找图、找字操作，不再需要编写复杂的代码。
 
 ```ts
-// 在整个画面内搜索图片，找不到返回 undefined
+// 在整个画面内搜索图片，相似度0.8（默认），找不到返回 undefined
 const i1 = findImage("assets/关闭.png");
 
-// 在指定方向上搜索图片，找不到返回 undefined
-const i2 = findImageInDirection("assets/关闭.png", "north-east");
+// 在指定方向上搜索图片，相似度0.9，找不到返回 undefined
+const i2 = findImageInDirection("assets/关闭.png", "north-east", 0.9);
 
-// 在指定区域内搜索图片，找不到返回 undefined
+// 在指定区域内搜索图片，相似度0.8（默认），找不到返回 undefined
 const i3 = findImageWithinBounds("assets/关闭.png", 960, 0, 960, 1080);
 
 // 在整个画面内搜索文本（不包含、忽略大小写），找不到返回 undefined
@@ -97,7 +97,7 @@ await assertRegionDisappearing(findButton, "点击购买按钮超时", () => fin
 
 ### 鼠标操作
 
-> 对常见鼠标操作的封装，如鼠标滚动、拖拽等。
+> 对常见鼠标操作的封装，如鼠标的平滑移动、鼠标滚轮滚动、鼠标拖拽等。
 
 ```ts
 // 鼠标从 (745, 610) 平滑自然地移动 (1920, 1080)

package/dist/ocr.d.ts

@@ -3,9 +3,10 @@ type MatchDirection = "north" /** 上半边 */ | "north-east" /** 右上四分
 /**
  * 在整个画面内搜索图片
  * @param path 图片路径
+ * @param similarity 相似度阈值（默认: 0.8）
  * @returns 如果找到匹配的图片区域，则返回该区域
  */
-export declare const findImage: (path: string) => Region | undefined;
+export declare const findImage: (path: string, similarity?: number) => Region | undefined;
 /**
  * 在指定区域内搜索图片
  * @param path 图片路径
@@ -13,16 +14,17 @@ export declare const findImage: (path: string) => Region | undefined;
  * @param y 垂直方向偏移量（像素）
  * @param w 宽度
  * @param h 高度
+ * @param similarity 相似度阈值（默认: 0.8）
  * @returns 如果找到匹配的图片区域，则返回该区域
  */
-export declare const findImageWithinBounds: (path: string, x: number, y: number, w: number, h: number) => Region | undefined;
+export declare const findImageWithinBounds: (path: string, x: number, y: number, w: number, h: number, similarity?: number) => Region | undefined;
 /**
  * 在指定方向上搜索图片
  * @param path 图片路径
  * @param direction 搜索方向
  * @returns 如果找到匹配的图片区域，则返回该区域
  */
-export declare const findImageInDirection: (path: string, direction: MatchDirection) => Region | undefined;
+export declare const findImageInDirection: (path: string, direction: MatchDirection, similarity?: number) => Region | undefined;
 /** 文本搜索选项 */
 type TextMatchOptions = {
     /** 是否忽略大小写（默认: 是） */

package/dist/ocr.js

@@ -24,12 +24,14 @@ const directionToBounds = (direction) => {
 /**
  * 在整个画面内搜索图片
  * @param path 图片路径
+ * @param similarity 相似度阈值（默认: 0.8）
  * @returns 如果找到匹配的图片区域，则返回该区域
  */
-export const findImage = (path) => {
+export const findImage = (path, similarity = 0.8) => {
     const ir = captureGameRegion();
     try {
         const ro = RecognitionObject.templateMatch(file.readImageMatSync(path));
+        ro.threshold = similarity;
         return findFirst(ir, ro, region => region.isExist());
     }
     catch (err) {
@@ -46,12 +48,14 @@ export const findImage = (path) => {
  * @param y 垂直方向偏移量（像素）
  * @param w 宽度
  * @param h 高度
+ * @param similarity 相似度阈值（默认: 0.8）
  * @returns 如果找到匹配的图片区域，则返回该区域
  */
-export const findImageWithinBounds = (path, x, y, w, h) => {
+export const findImageWithinBounds = (path, x, y, w, h, similarity = 0.8) => {
     const ir = captureGameRegion();
     try {
         const ro = RecognitionObject.templateMatch(file.readImageMatSync(path), x, y, w, h);
+        ro.threshold = similarity;
         return findFirst(ir, ro, region => region.isExist());
     }
     catch (err) {
@@ -67,9 +71,9 @@ export const findImageWithinBounds = (path, x, y, w, h) => {
  * @param direction 搜索方向
  * @returns 如果找到匹配的图片区域，则返回该区域
  */
-export const findImageInDirection = (path, direction) => {
+export const findImageInDirection = (path, direction, similarity = 0.8) => {
     const { x, y, w, h } = directionToBounds(direction);
-    return findImageWithinBounds(path, x, y, w, h);
+    return findImageWithinBounds(path, x, y, w, h, similarity);
 };
 /**
  * 在整个画面内搜索文本

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bettergi/utils",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "开发 BetterGI 脚本常用工具集",
   "type": "module",
   "author": "Bread Grocery<https://github.com/breadgrocery>",