Port.Target2 operator

Introduced

v3.0

Description

Returns the connected object (KinematicState, Primitive, etc.) to which this port is connected, this can be used to access the name or path of the object. It is possible to access other output ports within the context of the _Update function of a custom operator however, this is not recommended and the results cannot be guaranteed. Within the context of a custom operator's _Update function you should only access the current OutputPort object available via as an argument to the function and any InputPort object.

Port.Target2 replaces Port.Target which returns a ProjectItem and didn't allow you access to non-ProjectItem objects such as the Parameter object.

C# Syntax

// get accessor

Object rtn = Port.Target2;

Examples

VBScript Example

'

' This example demonstrates how to find the object connected to the input port for a built-in Softimage operator

'

' Add a cube to the scene and apply the edge operator

set oRoot = Application.ActiveProject.ActiveScene.Root

set oObject = oRoot.AddGeometry( "Cube", "MeshSurface" )

AddEdge oObject.FullName & ".pnt[LAST];" & oObject.FullName & ".edge[1]", 21.019

' Find the operator in the stack

set oOperator = oObject.ActivePrimitive.ConstructionHistory.Find( "addedgeop" )

if TypeName(oOperator) <> "Nothing" then

	' Find the input primitive 

	for each oInputPort in oOperator.InputPorts

		set oTarget = oInputPort.Target2

		if TypeName( oTarget ) = "Primitive" then

			Application.LogMessage "addedge operator is reading from the primitive"

		end if

	next

else

	Application.LogMessage "cannot find operator"	

end if