# add_layer()

新建一个用户图层。和图层面板上的添加一样。

省略名字时用和画面一样的 `Layer N`。[layer](layer.md) 只取已经存在的图层，没有就不会新建。

没有场景是 `no_scene`。Trial 达到上限是 `trial_locked`。

### 签名
```python
api.add_layer(name=None) -> result
```

| 字段 | 含义 |
|---|---|
| `ok` | 成功时为 True。 |
| `error` | 失败代码。成功时为空。不含路径。 |
| `no_scene` | 没有可以放图层的场景。 |
| `trial_locked` | 到了 Trial 的图层上限。 |

### 示例
```python
api.add_layer("Cloth")
layer = api.layer("Cloth")
``