# `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`類型的寄存器值 *****