OpenMV学习笔记

一、感光元件----sensor

sensor.reset()

----初始化感光元件

sensor.reset() 的功能包括：

初始化感光元件： 将摄像头感光元件初始化为默认状态，以确保其处于可用的工作状态。
恢复默认设置： 将摄像头的其他配置参数还原为默认值。这包括图像格式、帧大小等设置。

使用 sensor.reset() 可以在每次程序启动或需要重置摄像头状态时调用，以确保摄像头处于一致的状态。

sensor.reset() 被用于初始化感光元件，这是配置摄像头之前的一项重要步骤。在初始化后，可以通过其他函数来设置摄像头的像素格式、帧大小等参数，以适应应用场景。

sensor.set_pixformat()

----设置像素模式。

sensor.GRAYSCALE: 灰度，每个像素8bit。
sensor.RGB565: 彩色，每个像素16bit。

1.sensor.GRAYSCALE是一个常量，用于设置摄像头图像的像素格式为灰度模式。在这个模式下，每个像素用 8 位表示，范围从 0 到 255，其中 0 表示黑色，255 表示白色。

如果想将摄像头配置为捕获灰度图像，可以使用以下代码：

sensor.set_pixformat(sensor.GRAYSCALE)

这样设置后，摄像头将以灰度模式捕获图像，每个像素只包含亮度信息而没有颜色信息。这种模式通常用于对图像中的亮度变化进行分析，而不需要考虑颜色信息。

2.sensor.RGB565 是一个常量，用于设置摄像头图像的像素格式为 RGB565 彩色模式。在这个模式下，每个像素用 16 位表示，其中红色占用 5 位，绿色占用 6 位，蓝色占用 5 位。这样的格式提供了对颜色更细致的描述，适用于彩色图像。

如果你想将摄像头配置为以 RGB565 彩色模式捕获图像，可以使用以下代码：

sensor.set_pixformat(sensor.RGB565)

这样设置后，摄像头将以彩色模式捕获图像，每个像素包含红、绿、蓝三个颜色通道的信息。这使得你可以在图像处理和分析中考虑颜色信息。

sensor.set_framesize()

----设置图像的大小

sensor.set_framesize() 是一个函数，用于设置摄像头捕获图像的大小（帧大小）。通过调用这个函数，可以指定所需的图像分辨率。

设置图像大小对于应用程序非常重要，因为它会影响图像的清晰度、文件大小以及后续处理的计算成本。选择适当的图像大小取决于你的具体需求和系统资源。

sensor.QQCIF: 88x72
sensor.QCIF: 176x144
sensor.CIF: 352x288
sensor.QQSIF: 88x60
sensor.QSIF: 176x120
sensor.SIF: 352x240
sensor.QQQQVGA: 40x30
sensor.QQQVGA: 80x60
sensor.QQVGA: 160x120
sensor.QVGA: 320x240
sensor.VGA: 640x480
sensor.HQQQVGA: 80x40
sensor.HQQVGA: 160x80
sensor.HQVGA: 240x160
sensor.B64X32: 64x32 (用于帧差异 image.find_displacement())
sensor.B64X64: 64x64 用于帧差异 image.find_displacement())
sensor.B128X64: 128x64 (用于帧差异 image.find_displacement())
sensor.B128X128: 128x128 (用于帧差异 image.find_displacement())
sensor.LCD: 128x160 (用于LCD扩展板)
sensor.QQVGA2: 128x160 (用于LCD扩展板)
sensor.WVGA: 720x480 (用于 MT9V034)
sensor.WVGA2:752x480 (用于 MT9V034)
sensor.SVGA: 800x600 (仅用于 OV5640 感光元件)
sensor.XGA: 1024x768 (仅用于 OV5640 感光元件)
sensor.SXGA: 1280x1024 (仅用于 OV5640 感光元件)
sensor.UXGA: 1600x1200 (仅用于 OV5640 感光元件)
sensor.HD: 1280x720 (仅用于 OV5640 感光元件)
sensor.FHD: 1920x1080 (仅用于 OV5640 感光元件)
sensor.QHD: 2560x1440 (仅用于 OV5640 感光元件)
sensor.QXGA: 2048x1536 (仅用于 OV5640 感光元件)
sensor.WQXGA: 2560x1600 (仅用于 OV5640 感光元件)
sensor.WQXGA2: 2592x1944 (仅用于 OV5640 感光元件)

sensor.skip_frames(n=10)

----跳过一些帧

sensor.skip_frames(n=10) 跳过n张照片，在更改设置后，跳过一些帧，等待感光元件变稳定。这在某些情况下很有用，例如当你需要等待摄像头稳定下来或跳过起始帧以减少噪音时。

sensor.snapshot()

----获取一张图像

sensor.snapshot() 拍摄一张照片，返回一个image对象。

用于捕获当前摄像头的一帧图像并返回该图像的对象。这个函数在使用摄像头模块时非常常见，因为它允许你获取摄像头实时捕获的图像，并对其进行后续处理或分析。以下是一个简单的示例，演示了如何使用 sensor.snapshot() 函数：

import sensor# 初始化摄像头
sensor.init()# 捕获一帧图像
img = sensor.snapshot()# 对图像进行处理或分析
# 这里可以添加任何你想要的图像处理代码

在这个例子中，使用 sensor.snapshot() 捕获了摄像头的一帧图像，并将其保存在 img 变量中。然后你可以在代码中使用 img 对象进行任何后续的图像处理或分析操作。

sensor.set_auto_gain()

----自动增益

自动增益开启（True）或者关闭（False）。在使用颜色追踪时，需要关闭自动增益。

自动增益控制（Automatic Gain Control，简称 AGC）。自动增益控制是一种摄像头功能，它可以调整图像的整体亮度，以适应不同的光照条件。

启用自动增益控制时，摄像头会自动调整增益，以确保图像的整体亮度在合适的范围内。在某些场景下，禁用自动增益控制可能更有利于精确控制图像亮度。具体的使用方式可以根据实际需求来调整。

sensor.set_auto_whitebal()

----自动白平衡

自动白平衡开启（True）或者关闭（False）。在使用颜色追踪时，需要关闭自动白平衡。

动白平衡功能（Automatic White Balance，简称 AWB）。自动白平衡是摄像头功能之一，它能够自动调整图像的色彩平衡，以适应不同光照条件下的环境。

启用自动白平衡功能时，摄像头会自动调整图像的色彩平衡，以消除不同光照条件下的色彩偏差。在某些情况下，禁用自动白平衡功能可能有助于更精确地控制图像的色彩效果。具体的使用方式应根据实际需求来确定。

sensor.set_auto_exposure(enable[\, exposure_us])

自动曝光功能（Automatic Exposure，简称 AE）。自动曝光是摄像头功能之一，它能够根据环境光照情况自动调整曝光时间，以确保捕获的图像在不同光照条件下具有适当的亮度。

enable 是一个布尔值，用于启用或禁用自动曝光功能。如果为 True，则表示启用自动曝光；如果为 False，则表示禁用自动曝光。
exposure_us 是一个可选参数，表示手动设置的曝光时间，以微秒为单位。当 enable 参数为 False 时，可以提供这个参数来手动设置曝光时间。如果不提供 exposure_us 参数，则曝光时间会保持在默认值。

以下是一些示例用法：

启用自动曝光：

import sensor# 初始化摄像头
sensor.init()# 启用自动曝光功能
sensor.set_auto_exposure(True)

禁用自动曝光并手动设置曝光时间：

import sensor# 初始化摄像头
sensor.init()# 禁用自动曝光功能，并设置曝光时间为 10000 微秒（10 毫秒）
sensor.set_auto_exposure(False, exposure_us=10000)

在这些示例中，根据实际需求，可以选择启用或禁用自动曝光功能，并选择是否手动设置曝光时间。

sensor.set_windowing(roi)

----设置窗口ROI

ROI：Region Of Interest，图像处理中的术语“感兴趣区”。就是在要处理的图像中提取出的要处理的区域。

sensor.set_windowing() 是一个函数，用于设置摄像头的窗口选取（Windowing）功能。窗口选取允许你指定摄像头采集图像的感兴趣区域（Region of Interest，简称 ROI），从而可以只采集感兴趣区域内的图像，而不是整个图像。

这个函数通常接受一个参数 roi，用于指定感兴趣区域的位置和大小。roi 参数通常是一个元组或一个列表，其中包含四个值：(x, y, width, height)，分别表示感兴趣区域的左上角坐标 (x, y) 和宽度、高度。

以下是一个示例用法：

import sensor# 初始化摄像头
sensor.init()# 设置感兴趣区域为从 (100, 100) 开始，宽度为 200，高度为 150
roi = (100, 100, 200, 150)
sensor.set_windowing(roi)

在这个示例中，感兴趣区域从图像的 (100, 100) 坐标开始，宽度为 200 像素，高度为 150 像素。摄像头将仅捕获和处理这个感兴趣区域内的图像，而不是整个图像。

窗口选取功能可以用于在处理或分析摄像头图像时，仅关注特定的区域，从而提高处理效率或减少处理的数据量。

sensor.set_hmirror(True)

----水平方向翻转

sensor.set_vflip(True)

----垂直方向翻转

更多sensor设置，详见OpenMV官方中文文档：sensor — 感光元件 — MicroPython 1.9.2 文档

二、图像----image

image.get_pixel(x, y)

image.set_pixel(x, y, pixel)

----获取/设置像素点

通过image.get_pixel(x, y)方法来获取一个像素点的值。

image.get_pixel(x, y)
- 对于灰度图: 返回(x,y)坐标的灰度值.
- 对于彩色图: 返回(x,y)坐标的(r,g,b)的tuple.

通过image.set_pixel(x, y, pixel)方法，来设置一个像素点的值。

image.set_pixel(x, y, pixel)
- 对于灰度图: 设置(x,y)坐标的灰度值。
- 对于彩色图: 设置(x,y)坐标的(r,g,b)的值。

举例：

img = sensor.snapshot()
img.get_pixel(10,10)
img.set_pixcel(10,10,(255,0,0))#设置坐标(10,10)的像素点为红色(255,0,0)

image.width()

image.height()

image.format()

image.size()

----获取图像的宽度和高度

image.width()
返回图像的宽度(像素)
image.height()
返回图像的高度(像素)
image.format()
灰度图会返回 sensor.GRAYSCALE，彩色图会返回 sensor.RGB565。
image.size()
返回图像的大小(byte)

image.invert()

----图像的运算

image.invert()

取反，对于二值化的图像，0(黑)变成1(白)，1(白)变成0(黑)。

注：
图像可以是另一个image对象，或者是从 (bmp/pgm/ppm)文件读入的image对象。
两个图像都必须是相同的尺寸和类型（灰度图/彩色图）。

image.nand(image)
与另一个图片进行与非（NAND）运算。
image.nor(image)
与另一个图片进行或非（NOR）运算。
image.xor(image)
与另一个图片进行异或（XOR）运算。
image.xnor(image)
与另一个图片进行异或非（XNOR）运算。
image.difference(image)
从这张图片减去另一个图片。比如，对于每个通道的每个像素点，取相减绝对值操作。这个函数，经常用来做移动检测。

image.get_statistics(roi=Auto)

----使用图像的统计信息

image.get_statistics(roi=Auto)

其中roi是目标区域。注意，这里的roi，bins之类的参数，一定要显式地标明，例如：

img.get_statistics(roi=(0,0,10,20))

如果是 img.get_statistics((0,0,10,20))，ROI不会起作用。

statistics.mean() 返回灰度的平均数(0-255) (int)。你也可以通过statistics[0]获得。
statistics.median() 返回灰度的中位数(0-255) (int)。你也可以通过statistics[1]获得。
statistics.mode() 返回灰度的众数(0-255) (int)。你也可以通过statistics[2]获得。
statistics.stdev() 返回灰度的标准差(0-255) (int)。你也可以通过statistics[3]获得。
statistics.min() 返回灰度的最小值(0-255) (int)。你也可以通过statistics[4]获得。
statistics.max() 返回灰度的最大值(0-255) (int)。你也可以通过statistics[5]获得。
statistics.lq() 返回灰度的第一四分数(0-255) (int)。你也可以通过statistics[6]获得。
statistics.uq() 返回灰度的第三四分数(0-255) (int)。你也可以通过statistics[7]获得。

上面的是灰度的值，接下来的

l_mean，l_median，l_mode，l_stdev，l_min，l_max，l_lq，l_uq，
a_mean，a_median，a_mode，a_stdev，a_min，a_max，a_lq，a_uq，
b_mean，b_median，b_mode，b_stdev，b_min，b_max，b_lq，b_uq，

是LAB三个通道的平均数，中位数，众数，标准差，最小值，最大值，第一四分数，第三四分数。

在图像处理中，LAB色彩空间是一种颜色模型，它将颜色分解为三个通道：亮度（L），以及两个色度通道（a 和 b）。这种颜色空间是由国际照明委员会（CIE）于1976年定义的，旨在模拟人类视觉系统对颜色的感知方式。

下面是对LAB色彩空间中每个通道的简要说明：

L通道（亮度）： 代表图像的亮度信息。这个通道的取值范围通常是 0 到 100（有时是 0 到 255），表示从黑到白的亮度变化。在L通道中，较高的值对应于较亮的像素，较低的值对应于较暗的像素。
a通道（色度）： 代表图像中从绿色到红色的变化。负值表示绿色，正值表示红色。a通道的取值范围通常是 -128 到 127，其中 -128 表示最绿的颜色，而 127 表示最红的颜色。
b通道（色度）： 代表图像中从蓝色到黄色的变化。负值表示蓝色，正值表示黄色。b通道的取值范围也通常是 -128 到 127，其中 -128 表示最蓝的颜色，而 127 表示最黄的颜色。

通过将颜色分解为亮度和色度通道，LAB色彩空间能够更好地模拟人类对颜色的感知，同时也更适合进行图像处理和分析，例如颜色校正、图像分割和对象检测等任务。

举例：

检测左上方的区域中的颜色值。

import sensor, image, timesensor.reset() # 初始化摄像头
sensor.set_pixformat(sensor.RGB565) # 格式为 RGB565.
sensor.set_framesize(sensor.QVGA)
sensor.skip_frames(10) # 跳过10帧，使新设置生效
sensor.set_auto_whitebal(False)               # Create a clock object to track the FPS.ROI=(80,30,15,15)while(True):img = sensor.snapshot()         # Take a picture and return the image.statistics=img.get_statistics(roi=ROI)color_l=statistics.l_mode()color_a=statistics.a_mode()color_b=statistics.b_mode()print('L都众数：',color_l,'A的众数：',color_a,'B的众数：',color_b)img.draw_rectangle(ROI)