Your Ad Here

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

Synopsis

detachSurface [-constructionHistory boolean] [-curveOnSurface boolean] [-direction int] [-keep boolean] [-name string] [-object boolean] [-parameter float] [-polygon int] [-range boolean] [-rebuild boolean] [-replaceOriginal boolean] surface

detachSurface is undoable, queryable, and editable.

The detachSurface command detaches a surface into pieces, given a list of parameter values and a direction. You can also specify which pieces to keep and which to discard using the "-k" flag. The names of the newly detached surface(s) are returned. If history is on, the name of the resulting dependency node is also returned.

You can only detach in either U or V (not both) with a single detachSurface operation.

You can use this command to open a closed surface at a particular parameter value. You would use this command with only one "-p" flag.

If you are specifying "-k" flags, then you must specify one, none or all "-k" flags. If you are specifying all "-k" flags, there must be one more "-k" flag than "-p" flags.

Flags

constructionHistory, curveOnSurface, direction, keep, name, object, parameter, polygon, range, rebuild, replaceOriginal
Long name (short name) [argument types] Properties
-direction(-d) int queryedit
Direction in which to detach: 0 - V direction, 1 - U direction
Default: 1

In query mode, this flag needs a value.
-parameter(-p) float queryeditmultiuse
Parameter at which to detach.
Default: 0.0

In query mode, this flag needs a value.
-keep(-k) boolean queryeditmultiuse
Keep the detached pieces.
Default: true

In query mode, this flag needs a value.
-name(-n) string create
Name the resulting object
-constructionHistory(-ch) boolean create
Turn the construction history on or off (not available in all commands)
-object(-o) boolean create
Create the result, or just the dependency node (not available in all commands)
-replaceOriginal(-rpo) boolean create
Create "in place" (i.e., replace) (not available in all commands)
-curveOnSurface(-cos) boolean create
If possible, create 2D curve as a result (not available in all commands)
-polygon(-po) int create
The value of this argument controls the type of the object created by this operation (not available in all commands)
  • 0: nurbs surface
  • 1: polygon (use nurbsToPolygonsPref to set the parameters for the conversion)
  • 2: subdivision surface (use nurbsToSubdivPref to set the parameters for the conversion)
  • 3: Bezier surface
  • 4: subdivision surface solid (use nurbsToSubdivPref to set the parameters for the conversion)
-range(-rn) boolean create
Force a curve range on complete input curve (not available in all commands)
-rebuild(-rb) boolean create
Rebuild the input curve(s) before using them in the operation. Use nurbsCurveRebuildPref to set the parameters for the conversion. (not available in all commands)
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

Return value


[string[]] (object name and node name)

MEL examples

detachSurface -ch on -d 1 -p 0.3 -rpo off surface1;
detachSurface -ch on surface1.u[0.3];
// Detaches surface1 into two pieces at u = 0.3.
// The results are two surface pieces, and a detachSurface dependency node.
// Since no "-keep" flag is used, all pieces are kept.

detachSurface -ch on -k on -k off -rpo off -p 0.34 -d 0 surface1;
detachSurface -ch on -k on -k off -rpo off surface1.v[0.34];
// Detaches surface1 at v = 0.34.  Because of the "-k" flags, two
// surfaces are created but the second surface is empty.  A
// detachSurface dependency node is also returned.

detachSurface -ch on -rpo on -p 0.2 -p 0.5 -d 1 surface1;
detachSurface -ch on -rpo on surface1.u[0.2] surface1.u[0.5];
// Detaches surface1 into three pieces.  Because of the "-rpo" flag,
// the first surface piece is used to replace the original surface1.
// The results are the three surfaces (including the original surface).
// Even though the "-ch" flag is on, a dependency node is not created
// if surface1 is not a result of construction history.  If surface1
// is the result of construction history, then a dependency node is
// created and its name is returned.

detachSurface -ch on -d 0 -p 0.3 -rpo off cylinder1;
// Detaches cylinder1, which is periodic in V, where the V parameter
// ranges between 0.0 and 8.0.  The parameter, 0.3, is used to move
// the start point of the cylinder, also known as the "seam".
// The resulting surface's V parameter range is 0.0 to 0.3.

detachSurface -ch on -d 0 -p 0.3 -p 0.7 -rpo off cylinder1;
// Detaches cylinder1, which is periodic in V, where the V parameter
// ranges between 0.0 and 8.0.  The 1st parameter, 0.3, is used to move
// the start point of the cylinder, also known as the "seam".
// The second parameter, 0.7, is used to detach the cylinder again.
// The result is only TWO surfaces; the first surface's V parameter ranges
// from 0.0 to 0.3. The second surface's V parameter ranges from 0.3 to 0.7.

Return to Autodesk Index


Your Ad Here