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