Find (ConstructionHistory)

Description

Finds operator of a specific type in object's construction history.

Scripting Syntax

ConstructionHistory.Find( Type )

C# Syntax

Operator ConstructionHistory.Find( String in_filter );

Parameters

Parameter

Type

Description

Type

String

Operator type e.g. twistop

Return Value

Operator

Examples

VBScript Example

' The following code illustrates how to find the first envelope operator
' in the ConstructionHistory, 

Set oRoot = Application.ActiveProject.ActiveScene.Root

' Create an object to act as the skin
Set oSkin = oRoot.AddGeometry("Cylinder","MeshSurface")

' Create a chain to act as the skeleton
Set oPos1 = XSIMath.CreateVector3
oPos1.Set 0, -3, 0

' Effector for second bone
Set oPos2 = XSIMath.CreateVector3
oPos2.Set 0, 3, 0

' Construct skeleton
Set oChain = oRoot.Add3dChain(oPos1, Array(0,0,0))
Set oBone1 = oChain.AddBone(oPos2)

' Apply an envelope to the sphere using the chain as the deformer
oSkin.ApplyEnvelope oChain, siBranch

Set oEnvelope = oSkin.ActivePrimitive.ConstructionHistory.Find( "envelopop" )
Set oDeformers = oEnvelope.Deformers

LogMessage "There are " & oDeformers.Count & " deformers for the '" & oEnvelope.Name & "'."

For Each oItem In oDeformers
   If sMembers <> "" Then
       sMembers = sMembers & ", "
   End If
   sMembers = sMembers & oItem.Name 
Next

Application.LogMessage oSkin.Name & " has an envelope applied called '" & _
                     oEnvelope.Name & "'" & vbLf & "        " & _
                     "which has the following deformers: " & sMembers

' Output of the above script:
'INFO : "There are 4 deformers for the 'Envelope Operator'."
'INFO : "cylinder has an envelope applied called 'Envelope Operator'
'        which has the following deformers: root, bone, bone1, eff"


Autodesk Softimage v7.5