:mod:`sensor` ---  摄像头
===============================================

.. module:: sensor
   :synopsis: 摄像头

这个模块用于控制摄像头。

.. image:: https://docs.01studio.cc/data/picture/STM32_OV2640.png
    :alt: 01Studio STM32 OV2640 Module picture
    :width: 700px

相关资料请点击下面链接:

* `01Studio STM32 OV2640摄像头模块原理图 <https://docs.01studio.cc/data/sch/STM32_OV2640.pdf>`_ (PDF)

.. _sensor.OV2640:

OV2640 对象
--------------

OV2640 类提供一个OV2640摄像头控制接口，通过构建该对象可以轻松实现OV2640摄像头的应用。 

示例::

    import sensor

    cam = sensor.OV2640() #构建摄像头对象。
    cam.set_framesize(sensor.VGA) #设置帧大小
    cam.snapshot('/flash/test.jpg')  #拍照并保存
    cam.display()  #液晶屏实时显示摄像头图像


构造函数
------------

.. class:: OV2640(None) 

    构建一个OV2640摄像头对象。
	
	
使用方法
--------------

.. method:: OV2640.reset()

   复位摄像头。

.. method:: OV2640.set_framesize(framesize)

   摄像拍摄尺寸，默认是 sensor.VGA 640*480。(ESP32-S2默认帧尺寸sensor.LCD - 240x240）

	- ``framesize`` 帧尺寸大小：
	
		- ``sensor.QQQVGA`` - 80x60；
		- ``sensor.QQVGA`` - 160x120；
		- ``sensor.LCD`` - 240x240；(ESP32-S2特有)		
		- ``sensor.QVGA`` - 320x240；
		- ``sensor.VGA`` -  640x480；
		- ``sensor.WVGA`` - 720x480；(ESP32-S2不支持)
		- ``sensor.XGA`` - 1024x768；(ESP32-S2不支持)
		- ``sensor.UXGA`` -  1600x1200；(ESP32-S2不支持)

.. method:: OV2640.set_vflip(value=0)

   设置摄像头垂直翻转：

	- ``value`` 是否开启：
	
		- ``0`` - 关闭垂直翻转；
		- ``1`` - 开启垂直翻转；

.. method:: OV2640.set_hmirror(value=0)

   设置摄像头水平镜像：

	- ``value`` 是否开启：
	
		- ``0`` - 关闭水平镜像；
		- ``1`` - 开启水平镜像；

.. method:: OV2640.snapshot(filename)

   拍摄照片并保存，支持格式 JPG：

	- ``filename`` 路径+名称，如："/flash/1.jpg"、"/sd/2.jpg"。(ESP32-S2路径格式:"/1.jpg")

.. method:: OV2640.display()

   LCD实时显示摄像头采集图像。执行该函数需要初始化LCD。

.. method:: OV2640.display_stop()

   关闭摄像头采集图像LCD实时显示。

.. method:: OV2640.stream()

   摄像头网络图传。开发板联网后在同一局域网下的PC或手机浏览器输入开发板的IP地址即可（目前只支持ESP32-S2、ESP32-S3平台）。

.. method:: OV2640.deinit()

   注销对象。