# scan()

测量网格，为 Quick Skin 推荐 falloff 和分辨率。不会涂权重。

和窗口里的「计算推荐值」是同一次调用。没有网格时 `ok` 为 `False`，`error` 是 `no_mesh`。

想直接用推荐数字，就在 [quick_skin](quick-skin.md) 里省略 `falloff` 和 `resolution`。

### 签名
```python
skin.scan() -> result
```

| 字段 | 含义 |
|---|---|
| `ok` | 是否量到了。 |
| `height_cm` | 网格最长的边。 |
| `falloff` | 推荐的柔软度。越接近 0 越软，越接近 1 越硬。 |
| `resolution` | 推荐的格子。64、128、256、512 之一。 |
| `vert_count` | 顶点数。 |
| `bone_count` | 骨骼数。 |
| `error` | 失败原因。 |

### 示例
```python
info = api.skin().scan()
if info.ok:
    print(info.height_cm, info.falloff, info.resolution)
```