This command creates a named itemFilter object. This object can be attached to selectionConnection objects, or to editors, in order to filter the item lists going through them. Using union, intersection and difference filters, complex composite filters can be created.
The filter will only pass items whose bin list contains the given string as a bin name.This is a multi-use flag.If more than one occurance of this flag is used in a single command, the filter will accept a node if it matches at least one of the given bins (in other words, a union or logical or of all given bins.
The filter will only pass items whose names match the given regular expression string. This string can contain the special characters * and ?. ‘?’ matches any one character, and ‘*’ matches any substring.
The filter will run a MEL script named by the given string on each item name. Items will pass the filter if the script returns a non-zero value. The script name string must be the name of a proc whose signature is:global proc int procName( string $name )Note that if -secondScript is also used, it will always take precidence.
The filter will only pass items whose typeName matches the given string. The typeName of an object can be found using the nodeTypecommand. This is a multi-use flag. If more than one occurance of this flag is used in a single command, the filter will accept a node if it matches at least one of the given types (in other words, a union or logical or of all given types.
A string for categorizing the filter.
Internal use only. Indicates whether the filter is a built-in or user filter. The string argument is one of builtIn| user| other.
This flag will clear any existing bins associated with this filter.
This flag will clear any existing typeNames associated with this filter.
The filter will consist of the set difference of two other filters, whose names are the given strings. Items will pass this filter if and only if they pass the first filter but not the second filter.
Returns true|false depending upon whether the specified object exists. Other flags are ignored.
The filter will consist of the intersection of two other filters, whose names are the given strings. Items will pass this filter if and only if they pass both of the contained filters.
Returns an array of all item filters with classification builtIn.
Returns an array of all item filters with classification other.
Returns an array of all item filters with classification user.
This flag can be used to cause the filter to invert itself, and reverse what passes and what fails.
Optional. If specified, the filter’s life-span is linked to that of the parent. When the parent goes out of scope, so does the filter. If not specified, the filter will exist until explicitly deleted.
Can be used in conjunction with the -bs flag. The second script is for filtering whole lists at once, rather than individually. Its signature must be:global proc string[] procName( string[] $name )It should take in a list of items, and return a filtered list of items.
Defines an annotation string to be stored with the filter
The filter will consist of the union of two other filters, whose names are the given strings. Items will pass this filter if they pass at least one of the contained filters.
Returns unique node names to script filters so there are no naming conflicts. Flag can have multiple arguments, passed either as a tuple or a list.
Derived from mel command maya.cmds.itemFilter