Description

Returns a Boolean of whether or not a module with a name that matches the specified string value exists in the scene.

The exists command is used to query the scene for the existence of a given module or module type. For instance, you may be writing an automatic editing script and are trying to determine whether or not a certain marker, like LUPA (left upper arm) exists or not, in order to determine what method to used for filling in gaps on other arm related markers.

Functional area

Data editing

Command syntax

Syntax

exists modPath [-type string] [-priorityOnly]

Arguments

Name	Type	Required	Comments
`modPath`	string	yes	Name of module to be queried

Flags

Name	Flag arguments	Argument type	Exclusive to	Comments
`type`	1	string	—	Type of module for which to check existence
`priorityOnly`	0	—	—	Search only the priority module

Return value

boolean

Examples

// either one returns a value of True if this node exists in the scene
boolean $t = `exists "Actor_1"`; 
boolean $v = exists( "Actor_1" );

Shogun 1.9 Documentation

exists