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

Synopsis

polyInstallAction [-commandName] [-convertSelection] [-installConstraint] [-installDisplay] [-keepInstances] [-uninstallConstraint] [-uninstallDisplay] name

polyInstallAction is undoable, queryable, and NOT editable.

Installs/uninstalls several things to help the user to perform the specified action :

Return value

string[]When installing constraint, returns as an array of strings the items on which the installed command will act on. otherwise, returns nothing

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

Related

polyListComponentConversion, polySelectConstraint, polySelectConstraintMonitor

Flags

commandName, convertSelection, installConstraint, installDisplay, keepInstances, uninstallConstraint, uninstallDisplay
Long name (short name) Argument types Properties
-commandName(-cn) query
return as a string the name of the command previously installed
-convertSelection(-cs) create
convert all polys selected in object mode into their full matching component selection. For example : if a polyMesh is selected,
polyInstallAction -cs polyCloseBorder
will select all border edges.
-installConstraint(-ic) createquery

C: install selection pickmask and internal constraints for actionname
Q: returns 1 if any internal constraint is set for current action
-installDisplay(-id) createquery

C: install display attributes for actionname
Q: returns 1 if any display is set for current action
-keepInstances(-ki) create
Convert components for all selected instances rather than only the first selected instance.
-uninstallConstraint(-uc) create
uninstall internal constraints previously installed
-uninstallDisplay(-ud) create
uninstall display attributes previously installed

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

// Will set pickmask to edges, install internal constraint
// so that only border edges may be selected.
polyInstallAction -ic polyCloseBorder;

// Same as previous, plus force the display of borders if the
// user didn't asked explicitely for it before.
polyInstallAction -ic -id polyCloseBorder;

// Shortcut for polyInstallAction -ic -id polyCloseBorder;
polyInstallAction polyCloseBorder;

// Assuming the previous install was for closeBorder,
// will release internal border constraint, but go on displaying
// borders if the user didn't asked explicitely for it before.
polyInstallAction -uc;

// Assuming the previous install was for closeBorder,
// will release internal border constraint, stop displaying
// borders if the user didn't asked explicitely for it before.
polyInstallAction -uc -ud;

// Shortcut for polyInstallAction -uc -ud;
polyInstallAction;