UnfoldSetCut

Introduced

7.5

Description

Sets the specified edge list as the cutting line definition for the Unfold Property. This is the equivalent to calling UnfoldClearCut and then UnfoldAddToCut.

Scripting Syntax

UnfoldSetCut( Unfold Property, [Edges seam] )

Parameters

Parameter

Type

Description

Unfold Property

Property

The Unfold property on which you want to set a new cutting line definition.

Edges seam

List of edges or EdgeCollection

Edges to use for the cutting line definition.

Default Value: If not specified, the current selection is used.

Return Value

Returns a Boolean reporting whether or not the command was successful.

Examples

Python Example

#
# This example demonstrates how to set and reset the
# current cutting definition of an Unfold property
# 
a = Application
a.NewScene("", 0)

def LogCuts( in_prop ) :
   x = Application
   x.UnfoldSelectCut(in_prop)
   if (x.Selection.Count) :
       x.LogMessage(in_prop.Parent3DObject.Name + " cutting line: " + x.Selection(0).Value)
   else :
       x.LogMessage(in_prop.Parent3DObject.Name + " cutting line: [empty]")
   
g = a.CreatePrim("Grid", "MeshSurface")

# Set up an Unfold property on the grid with a cutting line
a.UnfoldApply("grid")
up = g.Properties("Unfold")
a.UnfoldSetCut(up, "grid.edge[14,34,51,68,71,73,75]")
LogCuts(up)

# Now modify the cutting line definition
a.UnfoldAddToCut(up, "grid.edge[2,3]")
LogCuts(up)

# Now set a completely different definition
a.UnfoldSetCut(up, "grid.edge[5,28,45,48,50,66,83,100,103,105,121]")
LogCuts(up)


# -------------------------
# Expected results
# INFO : grid cutting line: grid.edge[14,34,51,68,71,73,75]
# INFO : grid cutting line: grid.edge[2,3,14,34,51,68,71,73,75]
# INFO : grid cutting line: grid.edge[5,28,45,48,50,66,83,100,103,105,121]

See Also

UnfoldAddToCut

UnfoldAdjustUpdate

UnfoldApply

UnfoldApplySel

UnfoldClearCut

UnfoldPackUpdate

UnfoldRemoveFromCut

UnfoldSelectCut

UnfoldUpdate

Unfold Property Editor reference

 

 



Autodesk Softimage v7.5