Editable_Poly Detach Methods

polyop.detachFaces <Poly poly> <facelist> delete:<boolean=true> \
asNode:<boolean=false> name:<string="Object01"> node:<node=unsupplied>

Detaches the specified faces.

If <delete> is true , the faces are deleted after being detached.

If <delete> is false , the faces are not deleted.

If <asNode> is true , the faces are detached as a separate node.

If <asNode> is false , the faces are detached as an element in the poly.

If <asNode> is true , <name> specifies the name of the new node.

If <asNode> is true and <poly> is an Editable Poly (not a node), <node> must be specified.

Returns true if the operation is successful.

SCRIPT

   --The following script explodes an EditablePoly object to elements,
   --each polygon becomes one element
   macroScript PolyToElements category:"Help_Examples"
   (
   on isEnabled return
   selection.count == 1 and classof selection[1].baseobject == Editable_Poly
   on execute do
   (
   obj = selection[1]
   for p = polyop.getNumFaces obj to 1 by -1 do
   polyOp.detachFaces obj #{p}
   )
   )
polyop.detachEdges <Poly poly> <edgelist> delete:<boolean=true>\
asNode:<boolean=false> name:<string="Object01"> node:<node=unsupplied>

Detaches the faces used by the specified edges.

If <delete> is true , the faces are deleted after being detached.

If <delete> is false , the faces are not deleted.

If <asNode> is true , the faces are detached as a separate node.

If <asNode> is false , the faces are detached as an element in the poly.

If <asNode> is true , <name> specifies the name of the new node.

If <asNode> is true and <poly> is an Editable Poly (not a node), <node> must be specified.

Returns true if the operation is successful.

polyop.detachVerts <Poly poly> <vertlist> delete:<boolean=true> \
asNode:<boolean=false> name:<string="Object01"> node:<node=unsupplied>

Detaches the faces used by the specified vertices.

If <delete> is true , the faces are deleted after being detached.

If <delete> is false , the faces are not deleted.

If <asNode> is true , the faces are detached as a separate node.

If <asNode> is false , the faces are detached as an element in the poly.

If <asNode> is true , <name> specifies the name of the new node.

If <asNode> is true and <poly> is an Editable Poly (not a node), <node> must be specified.

Returns true if the operation is successful.