# 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)
```