layer()

Picks up one layer by name.

Use the name exactly as it appears on screen. If it has brackets, as in [Base], include the brackets. An unknown name raises LayerError. Two layers with the same name also raise LayerError, because the call cannot tell them apart. Rename one of them in the layer panel first.

Signature

api.layer(name) -> layer

Example

layer = api.layer("Layer 1")
print(layer.name, layer.visible, layer.id)
layer.set_visible(False)