v7.5
Unfold
Clears the cutting line associated with the specified Unfold
Property.
Warning: This clears the entire cutting line for the property, even
if you specify just a portion of it. For example, if a sphere's
cutting line was originally set at 'sphere.edge[0,1,2,3,4]' and you
call this command with the Objects parameter set to
'sphere.edge[3,4]', the sphere will have no cutting line at all set
for the specified Unfold property.
oBoolean = UnfoldClearCut( UnfoldProperty, [Object(s)] ); |
Returns a Boolean reporting whether or not the command was successful.
| Parameter | Type | Description |
|---|---|---|
| UnfoldProperty | Property | The Unfold property from which you want to clear the cut(s). |
| Object(s) | List of objects or X3DObject | Object(s) containing the cutting line that you want to be
removed from the Unfold property.
Default Value: If not specified, the current selection is used. |
/*
This example demonstrates how to set up, modify, and remove
a cutting line for a grid on its Unfold property.
*/
NewScene(null, false);
var g = CreatePrim("Grid", "MeshSurface");
// Apply the Unfold property to the grid and get a pointer to it
UnfoldApply(g);
var u = g.Properties("Unfold");
// Set the cutting line using 7 edges and log it
UnfoldSetCut(u, "grid.edge[14,34,51,68,71,73,75]");
LogCuts(u);
// Add edges 2 and 3 to the current cutting line and log it again
UnfoldAddToCut("grid.Unfold", "grid.edge[2,3]");
LogCuts(u);
// Reset the cutting line
UnfoldClearCut("grid.Unfold", "grid");
LogCuts(u);
// Launch Unfolding computations (since there's no cutting line
// there's nothing to do, as you can see from the Texture Editor)
UnfoldUpdate("grid.Unfold");
OpenView("Texture Editor");
// -------------------------
//
// Expected results
//
// INFO : Unfold cutting line: grid.edge[14,34,51,68,71,73,75]
// INFO : Unfold cutting line: grid.edge[2,3,14,34,51,68,71,73,75]
// INFO : Unfold cutting line: [empty]
// -------------------------
//
// Helper function
//
function LogCuts( in_prop )
{
var a = Application;
UnfoldSelectCut(in_prop);
if (a.Selection.Count) {
a.LogMessage(in_prop.Name + " cutting line: " + a.Selection(0));
} else {
a.LogMessage(in_prop.Name + " cutting line: [empty]");
}
}
|