@bettergi/utils 0.1.14 → 0.1.15

package/dist/ocr.d.ts

@@ -5,17 +5,18 @@ export type ROInstance = InstanceType<typeof RecognitionObject>;
 export type ROConfig = Partial<{
     [K in keyof ROInstance as ROInstance[K] extends Function ? never : K]: ROInstance[K];
 }>;
+export type ImageMat = ReturnType<typeof file.readImageMatSync>;
 export type MatchDirection = "north" /** 上半边 */ | "north-east" /** 右上四分之一 */ | "east" /** 右半边 */ | "south-east" /** 右下四分之一 */ | "south" /** 下半边 */ | "south-west" /** 左下四分之一 */ | "west" /** 左半边 */ | "north-west"; /** 左上四分之一 */
 /**
  * 在整个画面内搜索图片
- * @param path 图片路径
+ * @param image 图片路径 或 图片矩阵
  * @param config 识别对象配置
  * @returns 如果找到匹配的图片区域，则返回该区域
  */
-export declare const findImage: (path: string, config?: ROConfig) => Region | undefined;
+export declare const findImage: (image: string | ImageMat, config?: ROConfig) => Region | undefined;
 /**
  * 在指定区域内搜索图片
- * @param path 图片路径
+ * @param image 图片路径 或 图片矩阵
  * @param x 水平方向偏移量（像素）
  * @param y 垂直方向偏移量（像素）
  * @param w 宽度
@@ -23,10 +24,10 @@ export declare const findImage: (path: string, config?: ROConfig) => Region | un
  * @param config 识别对象配置
  * @returns 如果找到匹配的图片区域，则返回该区域
  */
-export declare const findImageWithinBounds: (path: string, x: number, y: number, w: number, h: number, config?: ROConfig) => Region | undefined;
+export declare const findImageWithinBounds: (image: string | ImageMat, x: number, y: number, w: number, h: number, config?: ROConfig) => Region | undefined;
 /**
  * 在指定坐标范围内搜索图片
- * @param path 图片路径
+ * @param image 图片路径 或 图片矩阵
  * @param left 左边界偏移量（像素）
  * @param top 上边界偏移量（像素）
  * @param right 右边界偏移量（像素）
@@ -34,15 +35,15 @@ export declare const findImageWithinBounds: (path: string, x: number, y: number,
  * @param config 识别对象配置
  * @returns 如果找到匹配的图片区域，则返回该区域
  */
-export declare const findImageBetweenCoordinates: (path: string, left: number, top: number, right: number, bottom: number, config?: ROConfig) => Region | undefined;
+export declare const findImageBetweenCoordinates: (image: string | ImageMat, left: number, top: number, right: number, bottom: number, config?: ROConfig) => Region | undefined;
 /**
  * 在指定方向上搜索图片
- * @param path 图片路径
+ * @param image 图片路径 或 图片矩阵
  * @param direction 搜索方向
  * @param config 识别对象配置
  * @returns 如果找到匹配的图片区域，则返回该区域
  */
-export declare const findImageInDirection: (path: string, direction: MatchDirection, config?: ROConfig) => Region | undefined;
+export declare const findImageInDirection: (image: string | ImageMat, direction: MatchDirection, config?: ROConfig) => Region | undefined;
 /** 文本搜索选项 */
 export type TextMatchOptions = {
     /** 是否忽略大小写（默认: 是） */

package/dist/ocr.js

@@ -23,14 +23,15 @@ const directionToBounds = (direction) => {
 };
 /**
  * 在整个画面内搜索图片
- * @param path 图片路径
+ * @param image 图片路径 或 图片矩阵
  * @param config 识别对象配置
  * @returns 如果找到匹配的图片区域，则返回该区域
  */
-export const findImage = (path, config = {}) => {
+export const findImage = (image, config = {}) => {
     const ir = captureGameRegion();
     try {
-        const ro = RecognitionObject.templateMatch(file.readImageMatSync(path));
+        const mat = typeof image === "string" ? file.readImageMatSync(image) : image;
+        const ro = RecognitionObject.templateMatch(mat);
         Object.assign(ro, config);
         return findFirst(ir, ro, region => region.isExist());
     }
@@ -43,7 +44,7 @@ export const findImage = (path, config = {}) => {
 };
 /**
  * 在指定区域内搜索图片
- * @param path 图片路径
+ * @param image 图片路径 或 图片矩阵
  * @param x 水平方向偏移量（像素）
  * @param y 垂直方向偏移量（像素）
  * @param w 宽度
@@ -51,10 +52,11 @@ export const findImage = (path, config = {}) => {
  * @param config 识别对象配置
  * @returns 如果找到匹配的图片区域，则返回该区域
  */
-export const findImageWithinBounds = (path, x, y, w, h, config = {}) => {
+export const findImageWithinBounds = (image, x, y, w, h, config = {}) => {
     const ir = captureGameRegion();
     try {
-        const ro = RecognitionObject.templateMatch(file.readImageMatSync(path), x, y, w, h);
+        const mat = typeof image === "string" ? file.readImageMatSync(image) : image;
+        const ro = RecognitionObject.templateMatch(mat, x, y, w, h);
         Object.assign(ro, config);
         return findFirst(ir, ro, region => region.isExist());
     }
@@ -67,7 +69,7 @@ export const findImageWithinBounds = (path, x, y, w, h, config = {}) => {
 };
 /**
  * 在指定坐标范围内搜索图片
- * @param path 图片路径
+ * @param image 图片路径 或 图片矩阵
  * @param left 左边界偏移量（像素）
  * @param top 上边界偏移量（像素）
  * @param right 右边界偏移量（像素）
@@ -75,19 +77,19 @@ export const findImageWithinBounds = (path, x, y, w, h, config = {}) => {
  * @param config 识别对象配置
  * @returns 如果找到匹配的图片区域，则返回该区域
  */
-export const findImageBetweenCoordinates = (path, left, top, right, bottom, config = {}) => {
-    return findImageWithinBounds(path, left, top, right - left, bottom - top, config);
+export const findImageBetweenCoordinates = (image, left, top, right, bottom, config = {}) => {
+    return findImageWithinBounds(image, left, top, right - left, bottom - top, config);
 };
 /**
  * 在指定方向上搜索图片
- * @param path 图片路径
+ * @param image 图片路径 或 图片矩阵
  * @param direction 搜索方向
  * @param config 识别对象配置
  * @returns 如果找到匹配的图片区域，则返回该区域
  */
-export const findImageInDirection = (path, direction, config = {}) => {
+export const findImageInDirection = (image, direction, config = {}) => {
     const { x, y, w, h } = directionToBounds(direction);
-    return findImageWithinBounds(path, x, y, w, h, config);
+    return findImageWithinBounds(image, x, y, w, h, config);
 };
 /**
  * 在整个画面内搜索文本

package/package.json

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