v5.1
Returns the value of a given input port on the CustomOperator. If the connected object
is a Parameter this will return the
actual value of the Parameter value, not the Parameter object.
Otherwise it will return the object that represents the input
object, and this object can be used to retrieve information about
the state of the input object. For example if the operator is
connected to a Parameter of type
double this will return a double. And if the operator is connected
to a Primitive this will return a Primitive.
Note: This method is a convenient and fast approach that hides the
existence of InputPorts.
Object OperatorContext.GetInputValue( Object in_vPortIndexOrName, Object in_vPortGroupIndexOrName, Int32 in_lPortGroupInstance ); |
OperatorContext.GetInputValue( PortIndexOrName, [PortGroupIndex], [PortGroupInstance] ); |
Parameter | Type | Description |
---|---|---|
PortIndexOrName | Long index of the input or String name. | It is faster to retrieve an input port by its index rather than its name. If the operator was created by the AddCustomOp command or Parameter.AddCustomOp method then the index is easy to determine based on the order of the inputs in the input argument. If the operator was built manually then the index can be determined based on the order of calls to CustomOperator.AddInputPort or CustomOperator.AddIOPort. |
PortGroupIndex | Long index of the PortGroup or String name. | Use this parameter for advanced operators that have more than
one PortGroup. Otherwise it is assumed
that the input is on the first group (Group 0). Tip: It is faster to reference a PortGroup by its index rather than its name. Default Value: 0 |
PortGroupInstance | Long | Use this parameter for advanced operators that support having
more than one object connecting to a particular PortGroup. Otherwise it is assumed that the
input is on the first group instance.
Default Value: 0 |