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.
frozen / fzn		bool
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. Flag can have multiple arguments, passed either as a tuple or a list.
object / o		bool
	Create the result, or just the dependency node. Advanced flags
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.001 Common 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 )