lsThroughFilter

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.

Return value

Flags

Long name (short name)	Argument types	Properties
-item(-it)	string
Run the filter on specified node(s), using the fast version of this command.
-nodeArray(-na)
Fast version that runs an entire array of nodes through the filter at one time.
-reverse(-rv)	boolean
Only available in conjunction with nodeArray flag. Reverses the order of nodes in the returned arrays if true.
-selection(-sl)
Run the filter on selected nodes only, using the fast version of this command.
-sort(-so)	string
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;