ApplyICEOp

Introduced

v7.0

Description

Applies an ICECompoundNode as an ICETree. This command manages connecting the ICE Tree operator to the correct construction stack in the Softimage scene (based on the contruction mode specified in the compound file) and setting the ICE Tree operator to autoinspect the compound, etc.

You can also specify a ConnectionSet containing the list of elements to connect to the input ports via the Input parameter. If any of the input ports need to be picked by the user (of type reference), Softimage automatically starts a picking session, creating GetData nodes associated with the picked object or component.

Scripting Syntax

oReturn = ApplyICEOp( File, [Target], Input, ConnectType );

Return Value

ICETree

Parameters

Parameter Type Description
File String Path to the compound file
Target SelectionList or Selection Object on which to apply the terminal node

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

Input String ConnectionSet describing the elements to be connected to the input ports of the compound node.

For example, if the first port is a geometry port that supports multiple instances, you could use "cone,cube,cube2". If there was an additional port for a list of obstacles, you could use "cone,cube,cube2;myobstacle,myobstacle2".
ConnectType siBranchFlag Whether the connection will be in node or branch mode

Default Value: siUnspecified

Examples

Python Example

#

# This example demonstrates how to use the ApplyICEOp command 

# to set up a 3D Point Grid on an empty Point Cloud

#

app = Application

app.NewScene("", 0)

app.GetPrim("PointCloud")

app.ApplyICEOp("Generate 3D Point Grid")

See Also

ApplyICETemplate ApplyOp ICECompoundNode