# `sensor`_感光元件（`import sensor`） `sensor`用于摄像头配置及图像抓取等 ***** * [ ] **初始化摄像头** ``` sensor.reset() ``` > 初始化摄像头，会自动扫描并获取摄像头地址及型号 *参数：* * 无 *返回：* * `None` ***** * [ ] **设置帧格式** ``` sensor.set_pixformat(format) ``` > 设置摄像头输出格式 *参数：* * `format`: 输出帧格式 * [`sensor.GRAYSCALE`]: 8-bits per pixel 灰度图格式（每像素为8位、1字节） * [`sensor.RGB565`]: 16-bits per pixel 彩色图格式（每像素为16位、2字节。5位红色，6位绿色，5位蓝色） *返回：* * `True`: 设置成功 * `False`: 设置错误 ***** * [ ] **设置帧大小** ``` sensor.set_framesize(framesize) ``` > 设置摄像头输出帧大小 *参数：* * `framesize`: 帧大小 * `sensor.QQQQVGA`: 40x30 * `sensor.QQQVGA`: 80x60 * `sensor.QQVGA`: 160x120 * `sensor.QVGA`: 320x240（LCD屏为320*240分辨率，推荐设置为QVGA格式） * `sensor.VGA`: 640x480 *返回：* * `True`: 设置成功 * `False`: 设置错误 ***** * [ ] **启动函数** ``` sensor.run(enable) ``` > 启动/停止芯片捕获图像（可以不使用） *参数：* * `enable`: `1`表示开启，`0` 表示停止 *返回：* * `True`: 即返回`1` ***** * [ ] **设置跳帧** ``` sensor.skip_frames([n,time]) ``` > 跳过指定帧数或者跳过指定时间内的图像 *参数：* * `n`: 跳过 n 帧图像 * `time`: 跳过指定时间，单位为ms *返回：* * `None` >使用此函数为让相机图像在改变相机设置后稳定下来，应在改变相机设置后调用该函数 > 使用`n`个快照，`n`作为普通参数传输， 例如：`skip_frames(10)`跳过`10`帧 > 或使用参数`time`来跳过几毫秒的帧数，例如：`kip_frames(time = 2000)`，跳过`2000`毫秒的帧。 > 若`n`和`time` 皆未指定，该方法跳过`300`毫秒的帧。 > 若二者皆指定，该方法会跳过`n`数量的帧，但将在`time`毫秒后超时。 ***** * [ ] **获取图像** ``` sensor.snapshot() ``` > 控制摄像头捕捉图像 *参数：* * 无 *返回：* * `image`类型的对象 ***** * [ ] **关闭摄像头** ``` sensor.shutdown(enable) ``` > 启动/关闭摄像头 *参数：* * `enable`: `1` 开启摄像头 `0` 关闭摄像头 *返回：* * `None` ***** * [ ] **获取分辨率宽度** ``` sensor.width() ``` > 获取摄像头分辨率宽度 *参数：* * 无 *返回：* * `int`类型的摄像头分辨率宽度 ***** * [ ] **获取分辨率高度** ``` sensor.height() ``` > 获取摄像头分辨率高度 *参数：* * 无 *返回：* * `int`类型的摄像头分辨率高度 ***** * [ ] **获取帧缓冲** ``` sensor.get_fb() ``` > 获取当前摄像头帧缓冲区图像 *参数：* * 无 *返回：* * `image`类型的对象 ***** * [ ] **获取ID** ``` sensor.get_id() ``` > 获取当前摄像头ID *参数：* * 无 *返回：* * `int`类型的ID ***** * [ ] **设置彩条模式** ``` sensor.set_colorbar(enable) ``` > 将摄像头设置为彩条模式 *参数：* * `enable`: `1` 表示开启彩条模式 `0` 表示关闭彩条模式 *返回：* * `None` ***** * [ ] **设置对比度** ``` sensor.set_contrast(contrast) ``` > 设置摄像头对比度 *参数：* * `constrast`: 摄像头对比度，范围为`[-2,+2]` *返回：* * `True`: 设置成功 * `False`: 设置错误 ***** * [ ] **设置亮度** ``` sensor.set_brightness(brightness) ``` > 设置摄像头亮度 *参数：* * `brightness`: 摄像头亮度，范围为`[-2,+2]` *返回：* * `True`: 设置成功 * `False`: 设置错误 ***** * [ ] **设置饱和度** ``` sensor.set_saturation(saturation) ``` > 设置摄像头饱和度 *参数：* * `saturation`: 摄像头饱和度，范围为`[-2,+2]` *返回：* * `True`: 设置成功 * `False`: 设置错误 ***** * [ ] **设置自动增益** ``` sensor.set_auto_gain(enable,gain_db) ``` >设置摄像自动增益模式 *参数：* * `enable`: `1` 表示开启自动增益 `0` 表示关闭自动增益 * `gain_db`: 关闭自动增益时，设置的摄像头固定增益值，单位为db *返回：* * `None` ***** * [ ] **获取增益值** ``` sensor.get_gain_db() ``` >获取摄像头增益值 *参数：* * 无 *返回：* * `float`类型的增益值 ***** * [ ] **设置水平镜像** ``` sensor.set_hmirror(enable) ``` >设置摄像头水平镜像 *参数：* * `enable`: `1` 表示开启水平镜像 `0` 表示关闭水平镜像 *返回：* * `None` ***** * [ ] **写入寄存器** ``` sensor.__write_reg(address, value) ``` >往摄像头寄存器写入指定值 *参数：* * `address`: 寄存器地址 * `value`： 写入值 *返回：* * `None` ***** * [ ] **读取寄存器** ``` sensor.__read_reg(address) ``` >读取摄像头寄存器值 *参数：* * `address`: 寄存器地址 *返回：* * `int`类型的寄存器值 *****