Go to: Synopsis. Return value. Related. Flags. MEL examples.
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 :
- Pickmask
- Internal selection constraints
- Display attributes
| 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.
polyListComponentConversion, polySelectConstraint, polySelectConstraintMonitor
commandName, convertSelection, installConstraint, installDisplay, keepInstances, uninstallConstraint, uninstallDisplay
| Long name (short name) |
Argument types |
Properties |
|
-commandName(-cn)
|
|
|
|
return as a string the name of the command previously installed
|
|
-convertSelection(-cs)
|
|
|
|
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)
|
|
|
|
C: install selection pickmask and internal constraints for actionname
Q: returns 1 if any internal constraint is set for current action
|
|
-installDisplay(-id)
|
|
|
|
C: install display attributes for actionname
Q: returns 1 if any display is set for current action
|
|
-keepInstances(-ki)
|
|
|
|
Convert components for all selected instances rather than only the first selected instance.
|
|
-uninstallConstraint(-uc)
|
|
|
|
uninstall internal constraints previously installed
|
|
-uninstallDisplay(-ud)
|
|
|
|
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.
|
// 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;