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;