Go to: Synopsis. Return value. Flags. MEL examples.

Synopsis

lsThroughFilter [-item string] [-nodeArray] [-reverse boolean] [-selection] [-sort string] string

lsThroughFilter is undoable, NOT queryable, and NOT editable.

List all objects in the world that pass a given filter.

Return value

string[]List of nodes passing the filter

Flags

item, nodeArray, reverse, selection, sort
Long name (short name) Argument types Properties
-item(-it) string createmultiuse
Run the filter on specified node(s), using the fast version of this command.
-nodeArray(-na) create
Fast version that runs an entire array of nodes through the filter at one time.
-reverse(-rv) boolean create
Only available in conjunction with nodeArray flag. Reverses the order of nodes in the returned arrays if true.
-selection(-sl) create
Run the filter on selected nodes only, using the fast version of this command.
-sort(-so) string create
Only available in conjunction with nodeArray flag. Orders the nodes in the returned array. Current options are: "byName", "byType", and "byTime".

Flag can appear in Create mode of command Flag can appear in Edit mode of command
Flag can appear in Query mode of command Flag can be used more than once in a command.

MEL examples

// Return all objects in the model that are named bob.
// (See the command "itemFilter" for how to construct these filters.)
lsThroughFilter texturesNamedBobFilter;

// Return same objects as above, but sorted in reverse
// alphabetical order:
lsThroughFilter -na -sort "byName" -reverse 1 texturesNamedBobFilter;