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

Browser not supported