ConnectRefToArrayCore

Synopsis

Takes an array of group references (ArrayOfIDs) and an integer value to select the index which is connected to the output group reference (RefToConnect).


	module ConnectRefToArrayCore <src_file="con_ref.cxx">
	{
		group &ArrayOfIDs<NEportLevels={2,0}>[];
		int SelectedIndex<NEportLevels={2,0}>;
		cxxmethod+notify_inst+req connect(
			ArrayOfIDs+read+notify+req,
			SelectedIndex+read+notify+req,
			RefToConnect+write);
		group &RefToConnect<NEportLevels={2,0}>;
	};

Description

Takes an array of group references (ArrayOfIDs) and an integer value to select the index which is connected to the output group reference (RefToConnect). This can be used to generate a dynamic linking mechanism between various input/output ports in a network.

Inputs

&ArrayOfIDs[]

Takes an array of group references.

SelectedIndex

The array index of the group to connect to the output.

Outputs

&RefToConnect

Outputs a reference to the selected object in the array.

Utility Macros

The low-level module ConnectRefToArrayCore is used in the Connect_func macro. Additionally, these macros also use the Params parameter block group object, as does the ConnectRefUI UI Macro.

Example

An example application ConnectRefToArrayEg is provided.

Files

iac_proj/con_ref/con_mods.v contains the Params group and the ConnectRefToArrayMemberset module V definitions.

Other Notes

The low-level library ConnectRefToArray containing the module ConnectRefToArrayCore does not specify a process. By default the express process will be used.

Authors

Brian Selle, Leon Thrane
Advanced Visual Systems, Inc.

Modifications

Ian Guthrie
Manchester Visualization Centre

Contact

International AVS Centre
Manchester Visualization Centre
Manchester Computing
University of Manchester
Oxford Road
Manchester
UK
M13 9PL

See Also