Go to: Synopsis. Return value. Related.
Flags. MEL
examples.
trim [-caching
boolean] [-constructionHistory boolean]
[-locatorU float] [-locatorV float] [-name string] [-nodeState int] [-object boolean] [-selected int] [-shrink boolean] [-tolerance linear] objects
trim is undoable, queryable, and editable.
This command trims a surface to its curves on surface by first
splitting the surface and then selecting which regions to keep or
discard.
| string[] |
Object name and node name. |
In query mode, return type is based on queried flag.
intersect, projectCurve, untrim
caching, constructionHistory, locatorU, locatorV,
name, nodeState, object,
selected, shrink, tolerance
| Long name (short name) |
Argument types |
Properties |
-locatorU(-lu) |
float |
    |
|
u parameter value to position a locator on the surface.
Default: 0.5 |
|
-locatorV(-lv) |
float |
|
|
v parameter value to position a locator on the surface.
Default: 0.5 |
|
-selected(-sl) |
int |
|
|
Specify whether to keep or discard selected regions.
Default: 0 |
|
-shrink(-sh) |
boolean |
|
|
If true, shrink underlying surface to outer boundaries of
trimmed surface.
Default: false |
|
-tolerance(-tol) |
linear |
|
|
The tolerance with which to trim.
Default: 0.001 |
|
| Advanced flags |
-caching(-cch) |
boolean |
|
|
Modifies the node caching mode. See the node documentation for
more information.
Note: For advanced users only. |
|
-nodeState(-nds) |
int |
|
|
Modifies the node state. See the node documentation for more
information.
Note: For advanced users only. |
|
| Common flags |
-name(-n) |
string |
|
|
Name the resulting object |
|
-constructionHistory(-ch) |
boolean |
|
|
Turn the construction history on or off |
|
-object(-o) |
boolean |
|
|
Create the result, or just the dependency node |
|
| 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. |
// Keep all selected regions
trim -sl 0;
// Discard all selected regions
trim -sl 1;
// shrink the underlying surface to just outside the
// outermost boundary curve
trim -sh 1;