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;