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 |
-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. |
|
-commandName(-cn) |
|
|
|
return as a string the name of the command previously
installed |
|
-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 |
|
-uninstallConstraint(-uc) |
|
|
|
uninstall internal constraints previously installed |
|
-uninstallDisplay(-ud) |
|
|
|
uninstall display attributes previously installed |
|
-keepInstances(-ki) |
|
|
|
Convert components for all selected instances rather than only
the first selected instance. |
|
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;