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

Synopsis

pluginDisplayFilter [-classification string] [-deregister] [-exists string] [-label string] [-listFilters] [-register]

pluginDisplayFilter is NOT undoable, queryable, and NOT editable.

Register, deregister or query a plugin display filter. Plug-ins can use this command to register their own display filters which will appear in the 'Show' menus on Maya's model panels.

Return value

stringstring[]

In query mode, return type is based on queried flag.

Keywords

displayfilter, modeleditor, modelpanel

Related

modelEditor

Flags

classification, deregister, exists, label, listFilters, register
Long name (short name) Argument types Properties
-exists(-ex) string create
Returns true if the specified filter exists, false otherwise. Other flags are ignored.
-register(-r) create
Register a plugin display filter. The -register is implied if both -register and -deregister flags are missing in create mode. You are responsible for deregistering any filters which you register. Filters are reference counted, meaning that if you register the same filter twice then you will have to deregister it twice as well.
-deregister(-dr) create
Deregister a plugin display filter.
-label(-l) string createquery
The string to be displayed for this filter in the UI. E.g. in the 'Show' menu of a model panel. The default value of this flag is the same as the plugin display filter name.
-classification(-cls) string createquery
The classification used to filter objects in Viewport 2.0. This classification is the same as MFnPlugin::registerNode(). If the node was registered with multiple classifications, use the one beginning with "drawdb". The default value of this flag is an empty string (""). It will not filter any objects in Viewport 2.0.
-listFilters(-lf) query
Returns an array of all plugin display filters.
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

//    Register a plugin display filter.
//
pluginDisplayFilter -register -label "My Display Filter" -classification "drawdb/geometry/myShape" myDisplayFilter;
//    Deregister a plugin display filter.
//
pluginDisplayFilter -deregister myDisplayFilter;
//    List all plugin display filters.
//
string $filters[] = `pluginDisplayFilter -q -listFilters`;
//    Query the label of a display filter
//
string $label = `pluginDisplayFilter -q -label myDisplayFilter`;