Go to: Synopsis. Return value. Related. Flags. Python examples.

Synopsis

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.

Return value

string[]Object name and node name.

In query mode, return type is based on queried flag.

Related

intersect, projectCurve, untrim

Flags

caching, constructionHistory, locatorU, locatorV, name, nodeState, object, selected, shrink, tolerance
Long name (short name) Argument types Properties
locatorU(lu) float createqueryeditmultiuse
u parameter value to position a locator on the surface.
Default: 0.5
locatorV(lv) float createqueryeditmultiuse
v parameter value to position a locator on the surface.
Default: 0.5
selected(sl) int createqueryedit
Specify whether to keep or discard selected regions.
Default: 0
shrink(sh) boolean createqueryedit
If true, shrink underlying surface to outer boundaries of trimmed surface.
Default: false
tolerance(tol) linear createqueryedit
The tolerance with which to trim.
Default: 0.001
Common flags
constructionHistory(ch) boolean create
Turn the construction history on or off.
name(n) string create
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.
object(o) boolean create
Create the result, or just the dependency node.
Advanced flags
caching(cch) boolean createqueryedit
Modifies the node caching mode. See the node documentation for more information.
Note: For advanced users only.
nodeState(nds) int createqueryedit
Modifies the node state. See the node documentation for more information.
Note: For advanced users only.

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.

Python examples

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 )