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

Synopsis

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.

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
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.
Common flags
-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.
-constructionHistory(-ch) boolean create
Turn the construction history on or off
-object(-o) boolean create
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.

MEL examples

// 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;