## UnfoldSetCut

### Introduced

v7.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

    oBoolean = UnfoldSetCut( UnfoldProperty, [EdgeList(s)] );

### Return Value

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

### Parameters

Parameter | Type | Description
--- | --- | ---
UnfoldProperty | Property | The Unfold property on which you want to set a new cutting line definition.
EdgeList(s) | List of edges or EdgeCollection | Edges to use for the cutting line definition. Default Value: If not specified, the current selection is used.

### 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