图色设置

`Capture(self, x1, y1, x2, y2, file)`

抓取指定区域(x1, y1, x2, y2)的图像,保存为 file(24 位位图)

Parameters:

x1 (int) – 区域的左上 X 坐标
y1 (int) – 区域的左上 Y 坐标
x2 (int) – 区域的右下 X 坐标
y2 (int) – 区域的右下 Y 坐标
file (str) – 保存的文件名,保存的地方一般为 SetPath 中设置的目录,当然这里也可以指定全路径名.

Returns:

int – 0 代表失败，1 代表成功

`CmpColor(self, x, y, color, sim)`

比较指定坐标点(x,y)的颜色

Parameters:

x (int) – X 坐标
y (int) – Y 坐标
color (str) – 颜色字符串,可以支持偏色,多色,例如 "ffffff-202020|000000-000000" 这个表示白色偏色为 202020,和黑色偏色为 000000.颜色最多支持 10 种颜色组合. 注意，这里只支持 RGB 颜色.
sim (float) – 相似度(0.1-1.0)

Returns:

0 – 颜色匹配 1: 颜色不匹配

`FindColor(self, x1, y1, x2, y2, color, sim, dir)`

查找指定区域内的颜色,颜色格式"RRGGBB-DRDGDB",注意,和按键的颜色格式相反

Parameters:

x1 (int) – 区域的左上 X 坐标
y1 (int) – 区域的左上 Y 坐标
x2 (int) – 区域的右下 X 坐标
y2 (int) – 区域的右下 Y 坐标
color (str) – 颜色格式为"RRGGBB-DRDGDB",比如"123456-000000|aabbcc-202020".注意，这里只支持 RGB 颜色.
sim (float) – 相似度,取值范围 0.1-1.0
dir (int) – 查找方向 0: 从左到右,从上到下 1: 从左到右,从下到上 2: 从右到左,从上到下 3: 从右到左,从下到上 4：从中心往外查找 5: 从上到下,从左到右 6: 从上到下,从右到左 7: 从下到上,从左到右 8: 从下到上,从右到左

Returns:

tuple – (x1, y1, x2, y2, color, sim, dir,返回 X 坐标,返回 Y 坐标)

`FindColorEx(self, x1, y1, x2, y2, color, sim, dir)`

查找指定区域内的所有颜色,颜色格式"RRGGBB-DRDGDB",注意,和按键的颜色格式相反

Parameters:

x1 (int) – 区域的左上 X 坐标
y1 (int) – 区域的左上 Y 坐标
x2 (int) – 区域的右下 X 坐标
y2 (int) – 区域的右下 Y 坐标
color (str) – 颜色格式为"RRGGBB-DRDGDB",比如"123456-000000|aabbcc-202020".注意，这里只支持 RGB 颜色.
sim (float) – 相似度,取值范围 0.1-1.0
dir (int) – 查找方向 0: 从左到右,从上到下 1: 从左到右,从下到上 2: 从右到左,从上到下 3: 从右到左,从下到上 4：从中心往外查找 5: 从上到下,从左到右 6: 从上到下,从右到左 7: 从下到上,从左到右 8: 从下到上,从右到左

Returns:

str – 返回所有颜色信息的坐标值,然后通过 GetResultCount 等接口来解析 (由于内存限制,返回的颜色数量最多为 1800 个左右)

`FindMultiColor(self, x1, y1, x2, y2, first_color, offset_color, sim, dir)`

根据指定的多点查找颜色坐标

Parameters:

x1 (int) – 区域的左上 X 坐标
y1 (int) – 区域的左上 Y 坐标
x2 (int) – 区域的右下 X 坐标
y2 (int) – 区域的右下 Y 坐标
first_color (str) – 颜色格式为"RRGGBB-DRDGDB|RRGGBB-DRDGDB|…………",比如"123456-000000"这里的含义和按键自带 Color 插件的意义相同，只不过我的可以支持偏色和多种颜色组合.所有的偏移色坐标都相对于此颜色.注意，这里只支持 RGB 颜色.
offset_color (str) – 偏移颜色可以支持任意多个点格式和按键自带的 Color 插件意义相同, 只不过我的可以支持偏色和多种颜色组合,格式为"x1|y1|RRGGBB-DRDGDB|RRGGBB-DRDGDB……,……xn|yn|RRGGBB-DRDGDB|RRGGBB-DRDGDB……" 比如"1|3|aabbcc|aaffaa-101010,-5|-3|123456-000000|454545-303030|565656"等任意组合都可以，支持偏色还可以支持反色模式，比如"1|3|-aabbcc|-334455-101010,-5|-3|-123456-000000|-353535|454545-101010","-"表示除了指定颜色之外的颜色.
sim (float) – 相似度,取值范围 0.1-1.0
dir (int) – 查找方向 0: 从左到右,从上到下 1: 从左到右,从下到上 2: 从右到左,从上到下 3: 从右到左, 从下到上

Returns:

tuple – (x1, y1, x2, y2,first_color,offset_color,sim, dir,返回的 X 坐标,返回的 Y 坐标) 坐标是 first_color 所在的坐标

`FindMultiColorEx(self, x1, y1, x2, y2, first_color, offset_color, sim, dir)`

查找指定区域内的所有颜色,颜色格式"RRGGBB-DRDGDB",注意,和按键的颜色格式相反

Parameters:

x1 (int) – 区域的左上 X 坐标
y1 (int) – 区域的左上 Y 坐标
x2 (int) – 区域的右下 X 坐标
y2 (int) – 区域的右下 Y 坐标
first_color (str) – 颜色格式为"RRGGBB-DRDGDB|RRGGBB-DRDGDB|…………",比如"123456-000000"这里的含义和按键自带 Color 插件的意义相同，只不过我的可以支持偏色和多种颜色组合.所有的偏移色坐标都相对于此颜色.注意，这里只支持 RGB 颜色.
offset_color (str) – 偏移颜色可以支持任意多个点格式和按键自带的 Color 插件意义相同, 只不过我的可以支持偏色和多种颜色组合,格式为"x1|y1|RRGGBB-DRDGDB|RRGGBB-DRDGDB……,……xn|yn|RRGGBB-DRDGDB|RRGGBB-DRDGDB……" 比如"1|3|aabbcc|aaffaa-101010,-5|-3|123456-000000|454545-303030|565656"等任意组合都可以，支持偏色还可以支持反色模式，比如"1|3|-aabbcc|-334455-101010,-5|-3|-123456-000000|-353535|454545-101010","-"表示除了指定颜色之外的颜色.
sim (float) – 相似度,取值范围 0.1-1.0
dir (int) – 查找方向 0: 从左到右,从上到下 1: 从左到右,从下到上 2: 从右到左,从上到下 3: 从右到左, 从下到上

Returns:

str – 返回所有颜色信息的坐标值,然后通过 GetResultCount 等接口来解析(由于内存限制,返回的坐标数量最多为 1800 个左右)坐标是 first_color 所在的坐标

`FindPic(self, x1, y1, x2, y2, pic_name, delta_color, sim, dir)`

查找指定区域内的图片,位图必须是 24 位色格式,支持透明色,当图像上下左右 4 个顶点的颜色一样时,则这个颜色将作为透明色处理.

Parameters:

x1 (int) – 区域的左上 X 坐标
y1 (int) – 区域的左上 Y 坐标
x2 (int) – 区域的右下 X 坐标
y2 (int) – 区域的右下 Y 坐标
pic_name (str) – 图片名,可以是多个图片,比如"test.bmp|test2.bmp|test3.bmp"
delta_color (str) – 颜色色偏比如"203040" 表示 RGB 的色偏分别是 20 30 40 (这里是 16 进制表示)
sim (float) – 相似度,取值范围 0.1-1.0
dir (int) – 查找方向 0: 从左到右,从上到下 1: 从左到右,从下到上 2: 从右到左,从上到下 3: 从右到左, 从下到上

Returns:

tuple – (x1, y1, x2, y2, pic_name, delta_color,sim, dir,图片左上角的 X 坐标, 图片左上角的 Y 坐标)

`FindPicEx(self, x1, y1, x2, y2, pic_name, delta_color, sim, dir)`

查找指定区域内的图片,位图必须是 24 位色格式,支持透明色,当图像上下左右 4 个顶点的颜色一样时,则这个颜色将作为透明色处理.这个函数可以查找多个图片,并且返回所有找到的图像的坐标.

Parameters:

x1 (int) – 区域的左上 X 坐标
y1 (int) – 区域的左上 Y 坐标
x2 (int) – 区域的右下 X 坐标
y2 (int) – 区域的右下 Y 坐标
pic_name (str) – 图片名,可以是多个图片,比如"test.bmp|test2.bmp|test3.bmp"
delta_color (str) – 颜色色偏比如"203040" 表示 RGB 的色偏分别是 20 30 40 (这里是 16 进制表示)
sim (float) – 相似度,取值范围 0.1-1.0
dir (int) – 查找方向 0: 从左到右,从上到下 1: 从左到右,从下到上 2: 从右到左,从上到下 3: 从右到左, 从下到上

Returns:

str – 返回的是所有找到的坐标格式如下"id,x,y|id,x,y..|id,x,y" (图片左上角的坐标)比如"0,100,20|2,30,40" 表示找到了两个,第一个,对应的图片是图像序号为 0 的图片,坐标是(100,20),第二个是序号为 2 的图片,坐标(30,40) (由于内存限制,返回的图片数量最多为 1500 个左右)

`GetColor(self, x, y)`

获取(x,y)的颜色,颜色返回格式"RRGGBB",注意,和按键的颜色格式相反

Parameters:

x (int) – X 坐标
y (int) – Y 坐标

Returns:

str – 颜色字符串(注意这里都是小写字符，和工具相匹配)

`CapturePre(self, file)`

抓取上次操作的图色区域，保存为 file(32 位位图)

Parameters:

file (str) – 保存的文件名,保存的地方一般为 SetPath 中设置的目录,当然这里也可以指定全路径名.

Returns:

int – 0 代表失败 1 代表成功

注意，要开启此函数，必须先调用 EnableDisplayDebug 任何图色或者文字识别函数，都可以通过这个来截取.

`EnableDisplayDebug(self, enable_debug)`

开启图色调试模式，此模式会稍许降低图色和文字识别的速度.默认不开启.

Parameters:

enable_debug (int) – 0 为关闭 1 为开启

Returns:

int – 0 代表失败 1 代表成功

`GetScreenData(self, x1, y1, x2, y2)`

获取指定区域的图像,用二进制数据的方式返回,（不适合按键使用）方便二次开发.

Parameters:

x1 (int) – 区域的左上 X 坐标
y1 (int) – 区域的左上 Y 坐标
x2 (int) – 区域的右下 X 坐标
y2 (int) – 区域的右下 Y 坐标

Returns:

int – 返回的是指定区域的二进制颜色数据地址,每个颜色是 4 个字节,表示方式为(BBGGRR00)

注意,调用完此接口后，返回的数据指针在当前 op 对象销毁时，或者再次调用 GetScreenData 时，会自动释放.

`GetScreenDataBmp(self, x1, y1, x2, y2)`

获取指定区域的图像,用 24 位位图的数据格式返回,方便二次开发.（或者可以配合 SetDisplayInput 的 mem 模式）

Parameters:

x1 (int) – 区域的左上 X 坐标
y1 (int) – 区域的左上 Y 坐标
x2 (int) – 区域的右下 X 坐标
y2 (int) – 区域的右下 Y 坐标

Returns:

tuple – (x1,y1,x2,y2,返回图片的数据,返回图片的数据长度)

`SetDisplayInput(self, mode)`

设定图色的获取方式，默认是显示器或者后台窗口(具体参考 BindWindow)

Parameters:

mode (str) – 图色输入模式取值有以下几种 "screen" 这个是默认的模式，表示使用显示器或者后台窗口 "pic:file" 指定输入模式为指定的图片,如果使用了这个模式，则所有和图色相关的函数均视为对此图片进行处理，比如文字识别查找图片颜色等等一切图色函数.需要注意的是，设定以后，此图片就已经加入了缓冲，如果更改了源图片内容，那么需要释放此缓冲，重新设置. "mem:addr" 指定输入模式为指定的图片,此图片在内存当中. addr 为图像内存地址,一般是 GetScreenDataBmp 的返回值（前 54 字节为位图信息，后面的是像素数据），注意与大漠的区别.如果使用了这个模式，则所有和图色相关的函数,均视为对此图片进行处理.比如文字识别查找图片颜色等等一切图色函数所有坐标都相对此图片，如果不想受到影响，调用 GetScreenDataBmp 时应时整个窗口的大小.

Returns:

int – 0 代表失败 1 代表成功