# ScreenTapGesture

属性：

* [direction](#direction)
* [position](#position)
* [pointable](#pointable)
* [class\_type](#class_type)

## ***class*** **Leap. ScreenTapGesture**

扩展自 [Gesture](https://changkun.gitbook.io/leapmotion_v2_cn/yu-yan/python/api-can-kao/leap.gesture)

ScreenTapGesture(屏幕点击手势) 类表示一根手指在竖直方向上向前移动手指并回到原始位置的手势。点击的手指必须在点击前短暂的停留一下。

![](https://3708604558-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LmAGnx6ThZjQnyNN4Sg%2F-LmAGpETZPiOMDijInN-%2F-LmAGz5kV8rK9qcIkRu_%2FLeap_Gesture_Tap2.png?generation=1565704874435744\&alt=media)

重要：要在应用中使用屏幕点击手势，你需要激活屏幕点击手势识别。你可以通过下面的代码激活这种识别：

```python
controller.enable_gesture(Leap.Gesture.TYPE_SCREEN_TAP);
```

ScreenTap 手势是离散的，ScreenTapGesture 对象总是表示一个点击的状态 STATE\_STOP。仅当识别到屏幕点击手势后才会被创建。

你可以设置手指移动范围和速度的最小值。使用下面的键值可以进行设置：

|                  键值                  |  值类型  | 默认值 |  单位  |
| :----------------------------------: | :---: | :-: | :--: |
| Gesture.ScreenTap.MinForwardVelocity | float |  50 | mm/s |
|  Gesture.screen\_tap.HistorySeconds  | float | 0.1 |  mm  |
|     Gesture.ScreenTap.MinDistance    | float | 5.0 |  mm  |

下面的代码展示了如何设置这些值：

```python
controller.config.set("Gesture.ScreenTap.MinForwardVelocity", 30.0)
controller.config.set("Gesture.ScreenTap.HistorySeconds", .5)
controller.config.set("Gesture.ScreenTap.MinDistance", 1.0)
controller.config.save()
```

*New in Version 1.0*

### 构造函数

*classmethod* **ScreenTapGesture(\[gesture])**

从 Gesture 类实例中构造一个 ScreenTapGesture 对象。

```python
for gesture in frame.gestures():
    if gesture.type is Leap.Gesture.TYPE_SCREEN_TAP:
        screen_tap = Leap.ScreenTapGesture(gesture)
```

参数：

gesture([Gesture](https://changkun.gitbook.io/leapmotion_v2_cn/yu-yan/python/api-can-kao/leap.gesture)) - Gesture 实例专用。这个 Gesture 实例必须是一个 ScreenTapGesture 对象。如果没有给出参数，那么一个无效的 ScreenTapGesture 对象会被创建。

*New in Version 1.0*

### 属性

**position**

类型：[Vector](https://changkun.gitbook.io/leapmotion_v2_cn/yu-yan/python/api-can-kao/leap.vector)

点击手势的位置。

```python
tap_point = screen_tap.position
```

*New in Version 1.0*

\--

**position**

类型：[Vector](https://changkun.gitbook.io/leapmotion_v2_cn/yu-yan/python/api-can-kao/leap.vector)

屏幕点击手势的当前位置

```python
current = screen_tap.position
```

*New in Version 1.0*

\--

**direction**

类型：[Vector](https://changkun.gitbook.io/leapmotion_v2_cn/yu-yan/python/api-can-kao/leap.vector)

手指指尖的方向。如果手指不动，那么这个手势也会被记录，并被记录为零向量。

```python
tap_direction = screen_tap.direction
```

*New in Version 1.0*

\--

**progress**

类型：float

progress 值总是 1。

*New in Version 1.0*

\--

**pointable**

类型：[Pointable](https://changkun.gitbook.io/leapmotion_v2_cn/yu-yan/python/api-can-kao/leap.pointable)

执行轻点手势的手指。

```python
tapper = screen_tap.pintable
```

*New in Version 1.0*

### 类属性

*classmethod* **class\_type()**

类型：integer

屏幕点击手势类型指示器：`Gesture.TYPE_SCREEN_TAP`
