Go to: Synopsis. Return value. Related. Flags. Python examples.
trim(
objects
, [caching=boolean], [constructionHistory=boolean], [locatorU=float], [locatorV=float], [name=string], [nodeState=int], [object=boolean], [selected=int], [shrink=boolean], [tolerance=linear])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
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
|
|
|
Sets the name of the newly-created node. If it contains
namespace path, the new node will be created under the
specified namespace; if the namespace does not exist, it
will be created.
|
|
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 have multiple arguments, passed either as a tuple or a list.
|
import maya.cmds as cmds
# Keep all selected regions
cmds.trim( sl=0 )
# Discard all selected regions
cmds.trim( sl=1 )
# shrink the underlying surface to just outside the
# outermost boundary curve
cmds.trim( sh=1 )