# ` touchscreen`_觸摸屏幕（`import touchscreen as ts`） `touchscreen`模塊包含了基本的讀取觸摸屏幕操作 ***** * [ ] **初始化觸摸屏** ``` ts.init(i2c=None, cal=None) ``` > 初始化觸摸屏 *參數：* * `i2c`： 支持`I2C`通信的觸摸屏， 傳入`I2C`實例對象， 后期這個參數可能會被重命名或者取消 * `cal`： 校準數據， 是一個`7`個整型值的元組， 可以通過`touchscreen.calibrate()`函數得到 *返回：* * `None` ***** * [ ] **校準屏幕** ``` ts.calibrate() ``` >校準屏幕，使屏幕顯示和觸摸屏像素能夠對應 *參數：* * 無 *返回：* * 返回一個`7`個整型值的元組， 可以保存到文件系統或者`flash`，在初始化的時候傳入，這樣就不用每次都校準了 ***** * [ ] **獲取觸摸數據** ``` ts.read() ``` >讀取當前屏幕的狀態以及按下的點的坐標值 *參數：* * 無 *返回： * 一個由`3`個整型值組成的元組`(status, x, y)`， 注意這個值會一直保持上一個狀態 * `status`： 狀態， 取值有`touchscreen.STATUS_PRESS`，`touchscreen.STATUS_MOVE`，`touchscreen.STATUS_RELEASE` * `x`：`x`軸坐標 * `y`：`y`軸坐標 ***** * [ ] **系統默認`touchscreen`常量:** > `touchscreen.STATUS\_PRESS` 屏幕被按下，`read()`函數返回的元組的第一個值 >` touchscreen.STATUS\_MOVE` 屏幕被按住并移動，即按住移動，`read()`函數返回的元組的第一個值 > `touchscreen.STATUS\_RELEASE` 屏幕不再被按住，即沒有點擊，`read()`函數返回的元組的第一個值 *****