/
setActiveLayer
setActiveLayer
- Gisela Roberts
- Ben Stanley
Owned by Gisela Roberts
Last updated: Oct 26, 2023 by Ben Stanley
Description
Sets the active layer in the active clip using the name of the layer or a relative position.
An error is generated if there is no clip on the scene.
Functional area
NLE
Command syntax
Syntax
setActiveLayer "layerName"[-next] [-prev] |
Arguments
| Name | Type | Required | Comments |
|---|---|---|---|
layerName | string | yes | The name of layer to make active. Can be skipped if one of the flags -next or -prev is set. |
Flags
| Name | Flag arguments | Argument type | Exclusive to | Comments |
|---|---|---|---|---|
next | 0 | — | prev | Set the next layer in the active clip as an active |
prev | 0 | — | next | Set the previous layer in the active clip as an active |
Return value
void
Examples
// Print the name of the active clip string $clip = `getActiveClip`; print $clip; // Add new layers string $name = "new layer"; addLayer $name; addLayer $name; addLayer $name; setActiveLayer $name; setActiveLayer -next; setActiveLayer -prev;
Additional information
Related commands
, multiple selections available,
