pymel.core.modeling.trim

trim(*args, **kwargs)

This command trims a surface to its curves on surface by first splitting the surface and then selecting which regions to keep or discard.

Flags:

Long name (short name)		Argument Types	Properties
caching (cch)		bool
	Modifies the node caching mode. See the node documentation for more information.Note:For advanced users only.
constructionHistory (ch)		bool
	Turn the construction history on or off
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
name (n)		unicode
	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.
nodeState (nds)		int
	Modifies the node state. See the node documentation for more information.Note:For advanced users only.Common flags
object (o)		bool
	Create the result, or just the dependency nodeFlag can appear in Create mode of commandFlag can have multiple arguments, passed either as a tuple or a list.
replaceOriginal (rpo)		bool
selected (sl)		int
	Specify whether to keep or discard selected regions.Default:0
shrink (sh)		bool
	If true, shrink underlying surface to outer boundaries of trimmed surface.Default:false
tolerance (tol)		float
	The tolerance with which to trim.Default:0.001Advanced flags

Derived from mel command maya.cmds.trim

Example:

import pymel.core as pm

# Keep all selected regions
pm.trim( sl=0 )

# Discard all selected regions
pm.trim( sl=1 )

# shrink the underlying surface to just outside the
# outermost boundary curve
pm.trim( sh=1 )