屏幕图像

from ascript.android import screen

从屏幕中 获取图像数据, 图像转换 等操作

使用场景

获取屏幕截图，作为所有图色识别的基础
指定区域截图，减少不必要的处理范围
不同格式转换（Bitmap、PIL Image、OpenCV Mat），适配不同处理需求
获取/比较指定坐标的颜色值
截图保存到文件，用于调试或记录

方法

截图

获取一张当前屏幕的截图,图片格式可以为 :

Android Bitmap
Android Image 需手动close释放,否则后续截图报错!
Python PIL Image
Python Opencv Mat BGR格式

函数

screen.capture(x:int=None,y:int=None,x1:int=None,y1:int=None,pixel_format=FORMAT_BITMAP)

参数

参数	类型	是否必填	说明
x,y,x1,y1	int	否	截图的矩形范围坐标 `默认:全屏截图`
pixel_format	int	否	截图格式: screen.FORMAT_BITMAP : android bitmap(默认) screen.FORMAT_ANDROID_IMAGE : 已过时 screen.FORMAT_PIL_IMAGE : Python Pil Image screen.FORMAT_CV_MAT : Python OpenCv BGR MAT screen.FORMAT_IMAGE_DATA : 图片byte[]数据,包含data,rowStride,width,height

返回值

Bitmap 或 Pil-Image 或 OpencvMat Android图片对象

示例

# 截取屏幕截图,格式为Bitmap
from ascript.android import screen
bitmap = screen.capture()
print(bitmap)

# 截取指定范围屏幕,格式为Bitmap
from ascript.android import screen
bitmap = screen.capture( 122,358,808,979)
print(bitmap)

# 截取屏幕截图,返回值为Pil Image
from ascript.android import screen
pil_image = screen.capture(pixel_format=screen.FORMAT_PIL_IMAGE)
print(pil_image)

# 截取屏幕截图,返回值为Opencv mat
from ascript.android import screen
cv_mat = screen.capture(pixel_format=screen.FORMAT_CV_MAT)
print(cv_mat)

# 截取屏幕截图,返回值Android Image-Data
from ascript.android import screen
image_data = screen.capture(pixel_format=screen.FORMAT_IMAGE_DATA)
# image_data.data #图片byte[]数据
# image_date.rowStride 
# image_date.width
# image_data.height

截图快捷方法

capture() 每次都要写 pixel_format=，比较啰嗦。下面三个是它的语义化包装，效果完全等价，参数也一样（x, y, x1, y1）：

函数

screen.capture_bitmap(x:int=None, y:int=None, x1:int=None, y1:int=None)
screen.capture_pil(x:int=None, y:int=None, x1:int=None, y1:int=None)
screen.capture_cv(x:int=None, y:int=None, x1:int=None, y1:int=None)

对应关系

快捷方法	等价写法	返回类型
`capture_bitmap()`	`capture(pixel_format=screen.FORMAT_BITMAP)`	Android Bitmap
`capture_pil()`	`capture(pixel_format=screen.FORMAT_PIL_IMAGE)`	Python PIL Image
`capture_cv()`	`capture(pixel_format=screen.FORMAT_CV_MAT)`	OpenCV Mat（BGR）

示例

from ascript.android import screen

bitmap = screen.capture_bitmap()                    # 全屏 Bitmap
pil    = screen.capture_pil()                       # 全屏 PIL Image
mat    = screen.capture_cv()                        # 全屏 OpenCV BGR Mat

mat2   = screen.capture_cv(122, 358, 808, 979)      # 指定范围

提示

截一次、多处复用，能省下重复截屏的开销 —— 找图、找色、OCR、 AI 云识别都接受 image= 参数传入已截好的图。

shot = screen.capture_cv()
Ocr.find("确定", image=shot)
ai.find("底部的确定按钮", image=shot)

图像某坐标色值

获取图像指定坐标的颜色值

函数

screen.get_color(x:int,y:int,bitmap = screen.capture())

参数	类型	是否必填	说明
x	int	是	坐标x
y	int	是	坐标y
bitmap	int	否	指定图像,默认:全屏截图

返回值

Color 颜色值对象,点击查看其内部属性值

示例

from ascript.android import screen
color = screen.get_color(200,200)

print(color.rgb) #16进制RGB颜色值
print(color.argb) #16进制ARGB颜色值 PS:A位透明值通道
print(color.r,color.g,color.b,color.a) # 获取R通道,G通道,B通道,A通道 10进制颜色值

图像所有色值

获取整张图像所有色值

函数

screen.get_colors(bitmap = screen.capture())

参数	类型	是否必填	说明
bitmap	int	否	指定图像,默认:全屏截图

返回值

int[] 10进制颜色数组列表.可通过Color构造,获取RGB颜色值

示例

from ascript.android import screen
from ascript.android.screen import Color
colors = screen.get_colors()

print(f"共有:{len(colors)}个颜色点")

for i in range(len(colors)):
    # 打印出屏幕第一个点的颜色值
    if i == 0:
        c = Color(colors[i])
        print(c.rgb)

区域颜色点数量

在一个区域内找指定颜色点的数量

函数

screen.get_color_num(colors:str,rect:list=None,sim:float=0.9)

参数

参数	类型	是否必填	说明
colors	int	否	颜色值: `格式1: "#FFFFFF" 检索单一颜色值数量` `格式2:"#FFFFFF\|#000000" 多种颜色满足其一则算数` `格式3:"#000000-#111111" 给定颜色值在两个颜色值之间则算数`
rect	list	否	屏幕范围
sim	float	否	相似度 0~1之间,默认0.9:90%相似度

返回值

Bitmap Android图片对象

示例

# 获取屏幕中 #6989C5 和 #FF784B 颜色值数量
from ascript.android import screen
num = screen.get_color_num("#6989C5|#FF784B")

print(num)

# 获取屏幕指定范围内 #6989C5 和 #FF784B 颜色值数量
from ascript.android import screen
num = screen.get_color_num("#6989C5|#FF784B",rect =[413,358,709,578])

print(num)

# 获取屏幕指定范围内 #6989C5 和 #FF784B 相似度80% 的颜色点数量
from ascript.android import screen
num = screen.get_color_num("#6989C5|#FF784B",rect =[413,358,709,578],sim=0.8)

print(num)

横竖屏切换监听

当手机横竖屏变化后的监听

函数

screen.set_ori_change_listener(obj_listener):

参数

参数	类型	是否必填	说明
obj_listener	fun	是	一个回调函数,必须包含两个形参,来接收回传的width,height

示例

# 当横竖屏变化时,会调用该函数,并回传windth,height
def on_ori_change(w,h):
    print("横竖屏变化了")
    if w > h:
        print("横屏")
    else:
        print("竖屏")
# 设置监听函数
screen.set_ori_change_listener(on_ori_change)

图像转换

图像转文件

将 Android Bitmap 转存为文件

函数

screen.bitmap_to_file(path:str,bitmap=screen.capture(),quality=100)

参数

参数	类型	是否必填	说明
path	str	是	文件路径
bitmap	Bitmap	否	图片 `默认:全屏截图`
quality	int	否	图片清晰度,1-100之间 ,100为100%无损图片 `默认:100`

示例

# 将屏幕截图存储在SD卡下的1.png中
from ascript.android import screen
from ascript.android.system import R
screen.bitmap_to_file(R.sd("1.png"))

# 将屏幕截图存储在SD卡下的1.png中,清晰度设为80%
from ascript.android import screen
from ascript.android.system import R
screen.bitmap_to_file(R.sd("1.png"),quality=80)

文件转图片

将文件转存为Android Bitmap

函数

screen.file_to_bitmap(path:str,sampleSize:int=1)

参数

参数	类型	是否必填	说明
path	str	是	文件路径
sampleSize	int	否	采样率,如参数为2:每隔2行,2列采集1行,结果为原图的1/4大小 `默认1:无损`

示例

# 将屏幕截图存储在SD卡下的1.png中
from ascript.android import screen
from ascript.android.system import R
bitmap =  screen.file_to_bitmap(R.sd("2.png"))
print(bitmap)

图片转Base64数据

将图片转为 base64数据

函数

screen.bitmap_base64(bitmap=screen.capture())

参数

参数	类型	是否必填	说明
bitmap	Bitmap	否	图片 `默认:将当前屏幕转为 base64数据`

示例

# 将屏幕图像转换为base64
from ascript.android import screen
b64_str = screen.bitmap_base64()
print(b64_str)

# 将文件转换为base64
from ascript.android import screen
from ascript.android.system import R

bitmap =  screen.file_to_bitmap(R.sd("22222.png"))
b64_str = screen.bitmap_base64(bitmap)
print(b64_str)

Base64数据转图片

将 base64数据 转为图片

函数

screen.base64_bitmap(b64:str)

参数

参数	类型	是否必填	说明
b64	str	否	图片 `base64数据`

示例

# 将屏幕图像转换为base64
from ascript.android import screen
bitmap = screen.base64_bitmap("b64:str......")
print(bitmap)

图片最大边缩放

将图片缩放, 最大边不超过设定值,短边等比缩放.

函数

screen.bitmap_maxside(bitmap=screen.capture(),max_side_len=9999)

参数

参数	类型	是否必填	说明
bitmap	Bitmap	否	要缩放的图片 `默认:当前屏幕截图`
max_side_len	int	是	最大边长度 ,默认最大边长 9999

示例

# 将当前屏幕截图,最大边缩放到800
bitmap= screen.bitmap_maxside(screen.capture(),max_side_len=800)
print(bitmap.getWidth(),bitmap.getHeight())

Bitmap 转 Python Image

将 Android Bitmap 转换为 Python Image(PIL)

函数

screen.bitmap_to_pilimage(bitmap=capture())

参数

参数	类型	是否必填	说明
bitmap	Bitmap	否	要转换的Bitmap图像 `默认:当前屏幕截图`

返回值

Image Python PIL 图像

示例

# 将当前屏幕Bitmap 转换为 Python Image
from ascript.android import screen
img= screen.bitmap_to_pilimage()
print(img.width,img.height)

Bitmap 转 Opencv Image

将 Android Bitmap 转换为 Opencv Image

由于android图像是 ARGB通道 ,因此在转换后会丢失A通道,并且图像数据为BGR三通道格式

函数

screen.bitmap_to_cvimage(bitmap=capture())

参数

参数	类型	是否必填	说明
bitmap	Bitmap	否	要转换的Bitmap图像 `默认:当前屏幕截图`

返回值

Numpy array Python Opencv Image

示例

# 将当前屏幕Bitmap 转换为 Openv Image  = cv2.imread
import cv2
from ascript.android.ui import ImageWindow
from ascript.android import screen

image = screen.bitmap_to_cvimage()

# 展示图片
ImageWindow.show(image)

Opencv Image 转 Bitmap

将 Opencv Image 转换为 Android Bitmap

将BGR通道的CV图像转换为 Bitmap(RGB)

函数

screen.cvimage_to_bitmap(image)

参数

参数	类型	是否必填	说明
image	opencv image	否	要转换的Opencv Image

返回值

Bitmap Python PIL 图像

示例

# 将当前屏幕Bitmap 转换为 Openv Image  = cv2.imread
from ascript.android import screen
img= screen.bitmap_to_cvimage()
print(img)

图像Bitmap

from android.graphics import Bitmap

在Android 中的内存图像对象

宽度与高度

获取图像宽度

示例

from ascript.android import screen
bitmap = screen.capture()
print(bitmap.getWidth(),bitmap.getHeight())

颜色

from ascript.android.screen import Color

创建一个颜色

创建一个颜色值,用于颜色值转换,和值的获取

函数

Color(color_argb:int)

参数

参数	类型	是否必填	说明
color_argb	int	是	图像所有色值该方法返回结果中的Int值 (实际为ARGB的色值)

示例

# __init__.py 为初始化加载文件

from ascript.android import screen
from ascript.android.screen import Color
colors = screen.get_colors()

# 获取第一个int颜色值
color_int = colors[0]
# 转换为 Color对象,方便对颜色值进行转换
color = Color(color_int)

print(color.rgb)

属性

属性	返回类型	说明
r	int	R通道 10进制颜色值
g	int	G通道 10进制颜色值
b	int	B通道 10进制颜色值
a	int	A通道(透明值) 10进制颜色值
rgb	str	16进制 RGB颜色值
argb	str	16进制 ARGB颜色值

示例

from ascript.android import screen
from ascript.android.screen import Color
colors = screen.get_colors()

# 获取第一个int颜色值
color_int = colors[0]
# 转换为 Color对象,方便对颜色值进行转换
color = Color(color_int)

print(color.rgb) #16进制RGB颜色值
print(color.argb) #16进制ARGB颜色值 PS:A位透明值通道
print(color.r,color.g,color.b,color.a) # 获取R通道,G通道,B通道,A通道 10进制颜色值

从十六进制创建

从 "#RRGGBB" 或 "#AARRGGBB" 字符串创建 Color 对象。

Color.from_hex(hex_str)

from ascript.android.screen import Color

c = Color.from_hex("#FF0000")  # 红色
print(c.r, c.g, c.b)  # 255 0 0

从 RGB 分量创建

Color.make(r, g, b, a=255)

from ascript.android.screen import Color

c = Color.make(255, 128, 0)
print(c.rgb)  # #ff8000

颜色距离

计算两个颜色的欧氏距离（0~441.67）。支持传入 Color 对象、int 值或十六进制字符串。

Color.distance(c1, c2)

from ascript.android.screen import Color

d = Color.distance("#FF0000", "#00FF00")
print(d)  # 360.62

颜色相似判断

判断两个颜色是否相似（距离小于等于 threshold）。

Color.similar(c1, c2, threshold=30)

from ascript.android.screen import Color

print(Color.similar("#FF0000", "#FE0502"))  # True
print(Color.similar("#FF0000", "#00FF00"))  # False

屏幕图像

方法​

截图​

截图快捷方法​

图像某坐标色值​

图像所有色值​

区域颜色点数量​

横竖屏切换监听​

图像转换​

图像转文件​

文件转图片​

图片转Base64数据​

Base64数据转图片​

图片最大边缩放​

Bitmap 转 Python Image​

Bitmap 转 Opencv Image​

Opencv Image 转 Bitmap​

图像Bitmap​

宽度与高度​

颜色​

创建一个颜色​

属性​

从十六进制创建​

从 RGB 分量创建​

颜色距离​

颜色相似判断​

方法

截图