k210经典三码的识别与保存
在准备电赛的时候发现19年的赛题中有对于条形码和二维码的识别与保存这个操作，以前觉得这两个二维码没有什么实际用处，但是既然有出过涉及这方面的题目，那就全部复习一下吧
文章目录
- k210经典三码的识别与保存
- 一、QRCode类 – 二维码对象
- 二、AprilTag类 – AprilTag对象
- 三、 BarCode类 – 条形码对象
一、QRCode类 – 二维码对象
1.1创建对象
需要调用find_qrcodes() 函数来创建这个对象
补充：此函数在括号内添加参数
- 查找范围roi
- 为使这一方法成功运行，图像上二维码需比较平展。通过使用 sensor.set_windowing 函数在镜头中心放大、 image.lens_corr 函数来消解镜头的桶形畸变或通过更换视野较为狭小的镜头， 您可得到一个不受镜头畸变影响的更为平展的二维码。
1.2 方法
1.2.1 四元组qrcode.x()，qrcode.y()，qrcode.w()，qrcode.h()==qrcode.rect()
返回二维码的x,y坐标以及二维码的宽与高的长度，一般这几个参数会被用来与
img.draw_rectangle(max_qrcode.rect())搭配使用——由于比较简单就不再赘述了，与之前的line类的实现方法（点击可以跳转）是一样的含义。
1.2.2 qrcode.corners()
返回一个由该对象的四个角组成的四个元组(x,y)的列表。四个角通常是按照从左上角开始沿顺时针顺序返回的。(说实话这个函数用得非常非常少，没有特定得公式计算取值一般都不会用到)
案例1：获取四个角点的坐标，并将其打印出来
import sensor, image, time
sensor.reset()
sensor.set_pixformat(sensor.RGB565)
sensor.set_framesize(sensor.QVGA)
sensor.skip_frames(time = 2000)
while True:
img = sensor.snapshot()
qr_codes = img.find_qrcodes()
for qr_code in qr_codes:
# 输出二维码的角点坐标
corners = qr_code.corners()
print("二维码的角点坐标：")
for corner in corners:
print(corner)
time.sleep(1)
1.2.3 qrcode.payload()
返回二维码有效载荷的字符串，例如URL 。
也可以通过索引 [4] 取得这个值。
可以使用这个方法将二维码里面内容读取出来,二维码的有效载荷字符串取决于所扫描的二维码内容。例如，如果扫描的是一个包含网址的二维码，那么有效载荷字符串可能是该网址；如果扫描的是一个包含文本的二维码，那么有效载荷字符串可能是该文本内容
案例2：获取其有效载荷字符串，并将其打印出来
import sensor, image, time
sensor.reset()
sensor.set_pixformat(sensor.RGB565)
sensor.set_framesize(sensor.QVGA)
sensor.skip_frames(time = 2000)
while True:
img = sensor.snapshot()
qr_codes = img.find_qrcodes()
for qr_code in qr_codes:
# 获取二维码的有效载荷字符串
payload = qr_code.payload()
print("二维码的有效载荷：", payload)
time.sleep(1)
1.2.4 qrcode.version()
返回二维码的版本号(int)。
也可以通过索引 [5] 取得这个值
二维码的版本号通常是一个整数，表示二维码的规模和容纳数据的能力。版本号越高，二维码的尺寸越大，可以容纳更多的数据。每个版本的二维码都有一个特定的版本号范围。
案例3：获取其版本号，并将其打印出来
import sensor, image, time
sensor.reset()
sensor.set_pixformat(sensor.RGB565)
sensor.set_framesize(sensor.QVGA)
sensor.skip_frames(time = 2000)
while True:
img = sensor.snapshot()
qr_codes = img.find_qrcodes()
for qr_code in qr_codes:
# 获取二维码的版本号
version = qr_code.version()
print("二维码的版本号：", version)
time.sleep(1)
1.2.5qrcode.ecc_level()
返回二维码的ECC水平(int)。
也可以通过索引 [6] 取得这个值ECC水平是指二维码得纠错能力，用于提高二维码识别的准确性和可靠性。常见的ECC水平有四个等级：L（低）、M（中等）、Q（较高）和H（最高）。ECC水平越高，二维码的纠错能力越强，但也会导致二维码的容量减小。
案例4：获取其ECC水平，并将其打印出来
import sensor, image, time
sensor.reset()
sensor.set_pixformat(sensor.RGB565)
sensor.set_framesize(sensor.QVGA)
sensor.skip_frames(time = 2000)
while True:
img = sensor.snapshot()
qr_codes = img.find_qrcodes()
for qr_code in qr_codes:
# 获取二维码的ECC水平
ecc_level = qr_code.ecc_level()
print("二维码的ECC水平：", ecc_level)
time.sleep(1)
1.2.6 qrcode.mask()
返回二维码的掩码(int)。
也可以通过索引 [7] 取得这个值。
掩码是指在生成二维码时应用的一种算法，用于使二维码图案更加均匀和对称。用于表示二维码生成时所使用的掩码算法。掩码共有八种选择，标记为0到7，每种掩码对应一种特定的算法。这些算法用于调整二维码的黑白模块分布，以提高识别的准确性和可靠性。
案例5：获取其掩码
import sensor, image, time
sensor.reset()
sensor.set_pixformat(sensor.RGB565)
sensor.set_framesize(sensor.QVGA)
sensor.skip_frames(time = 2000)
while True:
img = sensor.snapshot()
qr_codes = img.find_qrcodes()
for qr_code in qr_codes:
# 获取二维码的掩码
mask = qr_code.mask()
print("二维码的掩码：", mask)
time.sleep(1)
1.2.7 qrcode.data_type()
返回二维码的数据类型。
也可以通过索引 [8] 取得这个值
二维码可以用来存储不同类型的数据，常见的数据类型有文本（“TEXT”）、网址（“URL”）、电话号码（“TEL”）等
案例6：获取其数据类型
import sensor, image, time
sensor.reset()
sensor.set_pixformat(sensor.RGB565)
sensor.set_framesize(sensor.QVGA)
sensor.skip_frames(time = 2000)
while True:
img = sensor.snapshot()
qr_codes = img.find_qrcodes()
for qr_code in qr_codes:
# 获取二维码的数据类型
data_type = qr_code.data_type()
print("二维码的数据类型：", data_type)
time.sleep(1)
tip:后面还有一些关于二维码的属性，如：二维码的ECI，检测数据类型是否为数字式，文字式，判断数据类型是否为二进制，是否为日本汉字，用得非常少，而且用法也与前面类似，大家可以访问官网进行查看学习https://wiki.sipeed.com/soft/maixpy/zh/api_reference/machine_vision/image/image.html#QRCode类-–-二维码对象
二、AprilTag类 – AprilTag对象
2.1 创建对象
需要调用image.find_apriltags（）函数来创建这个对象，
补充：可在括号内添加相应参数
- 查找范围roi
2.2 方法
用法与二维码的使用方法相同，下面就不在用重复的案例赘述类似的功能了
2.2.1 四元组AprilTag.x()，AprilTag.y()，AprilTag.w()，AprilTag.h()==AprilTag.rect()
返回AprilTag码的x,y坐标以及AprilTag码的宽与高的长度，一般这几个参数会被用来与
img.draw_rectangle(AprilTag.rect())搭配使用——由于比较简单就不再赘述了，与之前的line类的实现方法（点击可以跳转）是一样的含义。
2.2.2
apriltag.corners()
返回一个由该对象的四个角组成的四个元组(x,y)的列表。四个角通常是按照从左上角开始沿顺时针顺序返回的。
2.2.3 apriltag.id()
返回AprilTag的数字ID。
TAG16H5 -> 0 to 29
TAG25H7 -> 0 to 241
TAG25H9 -> 0 to 34
TAG36H10 -> 0 to 2319
TAG36H11 -> 0 to 586
ARTOOLKIT -> 0 to 511
也可以通过索引 [4] 取得这个值
2.2.4 apriltag.family()
返回AprilTag的数字家庭。
image.TAG16H5
image.TAG25H7
image.TAG25H9
image.TAG36H10
image.TAG36H11
image.ARTOOLKIT
也可以通过索引 [5] 取得这个值
案例7：指定要检测的 AprilTag 家族，并打印id以及家族
import sensor, image, time, apriltag
sensor.reset()
sensor.set_pixformat(sensor.GRAYSCALE)
sensor.set_framesize(sensor.QQVGA)
sensor.skip_frames(time = 2000)
tag_families = [apriltag.TAG16H5] # 指定要检测的 AprilTag 家族
atr = apriltag.ATApriltag() # 创建 AprilTag 检测器对象
atr.set_res(apriltag.ATM_QQVGA) # 设置检测器的图像分辨率
atr.set_families(tag_families) # 设置要检测的家族
while True:
img = sensor.snapshot()
tags = atr.find_tags(img) # 检测图像中的 AprilTag
for tag in tags:
# 获取 AprilTag 的 ID 和家族
tag_id = tag.id()
tag_family = tag.family()
print("检测到 AprilTag，ID：", tag_id)
print("家族：", tag_family)
time.sleep(1)
2.2.5 apriltag.cx()，apriltag.cy()
返回AprilTag的中心x位置(int)和中心y位置(int)
可以通过索引[6][7]取得这个值
案例8：获取中心x和y
import sensor, image, time, apriltag
sensor.reset()
sensor.set_pixformat(sensor.GRAYSCALE)
sensor.set_framesize(sensor.QQVGA)
sensor.skip_frames(time = 2000)
tag_families = [apriltag.TAG16H5] # 指定要检测的 AprilTag 家族
atr = apriltag.ATApriltag() # 创建 AprilTag 检测器对象
atr.set_res(apriltag.ATM_QQVGA) # 设置检测器的图像分辨率
atr.set_families(tag_families) # 设置要检测的家族
while True:
img = sensor.snapshot()
tags = atr.find_tags(img) # 检测图像中的 AprilTag
for tag in tags:
# 获取 AprilTag 的中心位置
cx = tag.cx()
cy = tag.cy()
print("检测到 AprilTag，中心位置：({}, {})".format(cx, cy))
time.sleep_ms(100)
2.2.6 apriltag.rotation()
返回以弧度计的AprilTag的旋度(int)。
也可以通过索引 [8] 取得这个值。
rotation = apriltag.rotation() # 获取旋转角度
rotation_index8 = apriltag.rotation()[8] # 获取索引为8的旋转角度值
2.2.7 apriltag.decision_margin()
返回AprilTag匹配的色饱和度（取值0.0 - 1.0），其中1.0为最佳。
也可以通过索引 [9] 取得这个值。
这个方法的用处在于评估 AprilTag 的匹配质量。色饱和度反映了匹配的质量，取值越接近 1.0，则表示匹配质量越好。通过调用 apriltag.decision_margin() 方法，你可以获得 AprilTag 的匹配色饱和度的值，进而判断匹配的质量，以进行后续的处理或决策
案例9：判断apriltag的质量
decision_margin = apriltag.decision_margin() # 获取色饱和度值
decision_margin_index9 = apriltag.decision_margin()[9] # 获取索引为9的色饱和度值
if decision_margin >= 0.8:
print("AprilTag匹配质量很高")
elif decision_margin >= 0.5:
print("AprilTag匹配质量一般")
else:
print("AprilTag匹配质量较低")
2.2.8 apriltag.hamming()
返回AprilTag的可接受的数位误差数值。
TAG16H5 -> 最多可接受0位错误
TAG25H7 -> 最多可接受1位错误
TAG25H9 -> 最多可接受3位错误
TAG36H10 -> 最多可接受3位错误
TAG36H11 -> 最多可接受4位错误
ARTOOLKIT -> 最多可接受0位错误
也可以通过索引 [10] 取得这个值。
三、 BarCode类 – 条形码对象
3.1 创建对象
使用image.find_barcodes()返回该对象
3.2方法
3.2.1 四元组barcode.x()，barcode.y()，barcode.w()，barcode.h()==barcode.rect()
返回barcode码的x,y坐标以及barcode码的宽与高的长度，一般这几个参数会被用来与
img.draw_rectangle(barcode.rect())搭配使用——由于比较简单就不再赘述了，与之前的line类的实现方法（点击可以跳转）是一样的含义。
3.2.2 barcode.corners()
返回一个由该对象的四个角组成的四个元组(x,y)的列表。四个角通常是按照从左上角开始沿顺时针顺序返回的。
3.2.3 barcode.payload()
返回条形码的有效载荷的字符串。例：数量。
也可以通过索引 [4] 取得这个值。
3.2.4 barcode.type()
返回条形码的列举类型 (int)。
也可以通过索引 [5] 取得这个值。
image.EAN2
image.EAN5
image.EAN8
image.UPCE
image.ISBN10
image.UPCA
image.EAN13
image.ISBN13
image.I25
image.DATABAR
image.DATABAR_EXP
image.CODABAR
image.CODE39
image.PDF417 - 未来启用 (e.g. 现在还不能正常使用).
image.CODE93
image.CODE128
3.2.5 barcode.rotation()
返回以弧度计的条形码的旋度(浮点数)。
也可以通过索引 [6] 取得这个值。
3.2.6 barcode.quality()
返回条形码在图像中被检测到的次数(int)。
扫描条形码时，每一条新的扫描线都能解码相同的条形码。每次进行这一过程，条形码的值都会随之增加。
也可以通过索引 [7] 取得这个值。
拓展：实现三码的识别，并将视野范围内的最大的二维码或QR码或是AprilTag码用红色的矩形框出来，然后保存图片至sd卡，要求每种类型不能超过三张。 写完后可以点击查看
1296
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
