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