Returns a collection of Operator objects that match the specified criteria.

C# Syntax

OperatorCollection ConstructionHistory.Filter( String in_filter, Object in_famArray, String in_path );

Scripting Syntax

oReturn = ConstructionHistory.Filter( [Type], [Family], [Path] );

Return Value



Parameter Type Description
Type String Operator type e.g. twistop (see Operator Information for a list of available operators.)
Family siFamily Name of family to filter by (for example, use "siDeformOperatorFamily" for the deform operator family).
Path String Name of object(s) as an Object List string expression (for example, "twist*" to return all twist operators).


VBScript Example

' The following code illustrates how to get a ConstructionHistory, 
' filter the construction history for DeformOperators and then iterate 
' the converters using the For Each...Next statement: 
Dim oGPig
' See if there are any DeformOperators now
Set oGPig = ActiveSceneRoot.AddGeometry( "Torus", "MeshSurface" )
ShowTransforms oGPig 
' Apply a Bend Operator and then see
ApplyOp "bend", oGPig
ShowTransforms oGPig 
' Apply a Twist Operator and then see
ApplyOp "twist", oGPig
ShowTransforms oGPig 
Function ShowTransforms( in_object )
	Dim oStack, oTransform, sMemberList 
	Set oStack = in_object.ActivePrimitive.ConstructionHistory.Filter( , siDeformOperatorFamily )
	If oStack.Count > 0 Then
		For Each oTransform In oStack
			sMemberList = sMemberList & oTransform.Name & ", "
		sMemberList = Left( sMemberList, ( Len( sMemberList ) - 2 ) )
		sMemberList = "(none found)"
	End If
	LogMessage sMemberList
	ShowConstructionHistory = sMemberList
End Function
' Output of above script:
'INFO : "(none found)"
'INFO : "Bend Op"
'INFO : "Twist Op, Bend Op"