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.