/*

	This example demonstrates how to use DataRepository.GetConnectionStackInfo

	to find which objects read from a particular object.

*/

NewScene( null, false ) ;

CreatePrim( "Sphere", "MeshSurface" );

ApplyOp( "Twist", "sphere", 3, siPersistentOperation, null, 0 );

SetSelFilter( "Vertex" );

AddToSelection( "sphere.pnt[26,33]", null, true );

Translate( null, 1, 0.2, -1.2, siRelative, siView, siObj, siXYZ );

SelectObj( "Sphere.polymsh" ) ;

// Get the connection information

var oDR = XSIUtils.DataRepository ;

opInfo = oDR.GetConnectionStackInfo( Selection(0) )

// This line would dump the actual XML content:

//Application.LogMessage( "\n----------------\nRAW XML OUTPUT\n------------------\n" + opInfo ) ;

// Get the list of output objects

aOutputs = GetOutputObjects( opInfo ) ;

Application.LogMessage( "Objects that read from the Sphere primitive:\n" + aOutputs.join("\n") ) ;

// Helper function to load the XML data using the Microsoft

// implementation of the DOM (see msdn.microsoft.com for documentation)

function ParseXML( strXML )

{

	var oXMLParser = new ActiveXObject( "Microsoft.XMLDOM" ) 

	oXMLParser.async = false	

	oXMLParser.loadXML( opInfo ) ;

	if (oXMLParser.parseError.errorCode != 0) 

	{

		Application.LogMessage( "Invalid XML " + oXMLParser.parseError.reason , siError ) ;	

		return null ;

	}

	// the xsi_file node

	// If this is NULL we must have failed to load the XML

	var oTopNode = oXMLParser.documentElement ;

	return oTopNode ;

}

// Go through the connection information and determine which connected

// operators/objects are reading from the object

//

// opInfo is the XML string returned by calling DataRespository.GetOperatorStackInfo

function GetOutputObjects( opInfo )

{

	aOutputs = new Array() ;

	var oTopNode = ParseXML( opInfo ) ;

	if ( oTopNode == null ) 

		return aOutputs ;

	var oConnections = oTopNode.childNodes ;

	for ( var i = 0 ; i < oConnections.length ; i++ )

	{

		oConnection= oConnections.item(i) ;

		oObjNode = oConnection.selectSingleNode( "object" ) ;

		strObj = oObjNode.text ;				

		oTypeNode = oConnection.selectSingleNode( "type" ) ;

		if ( oTypeNode != null && oTypeNode.text == "out" )

			aOutputs[aOutputs.length] = strObj ;

	}						

	return aOutputs ;

}

//Example output:

//

//INFO : Objects that read from the Sphere primitive:

//sphere.polymsh.secondaryshapemarker

//sphere.polymsh.animationmarker

//sphere.polymsh.shapemarker

//sphere.polymsh.modelingmarker

//sphere.polymsh.movecomponentop

//sphere.polymsh.cls.Point_INTERNAL.AddToClsOp

//sphere.polymsh.twistop

//sphere.polymsh.cls.default_Point.SetClsOp

/*

	This example demonstrates how to use DataRepository.GetConnectionStackInfo

	to find which objects are influenced by a parameter.

*/

// Create simple scene

NewScene( null, false );

var oSphere = ActiveSceneRoot.AddGeometry( "Sphere", "MeshSurface", "sphere" ) ;

var oSphereGlobalPosx = oSphere.Kinematics.Global.posx ;

// posy parameter on light will be driven by posx parameter of the sphere.

// (This creates an Expression object between the two parameters)

CopyPaste( oSphereGlobalPosx, null, "light.kine.global.posy", 1 );

// posz parameter will also be driven by the posx parameter

CopyPaste( oSphereGlobalPosx, null, "light.kine.global.posz", 1 );

aDependentData = FindDataDrivenByParameter( oSphereGlobalPosx )

for ( var i = 0 ; i < aDependentData.length ; i++ )

{

	Application.LogMessage( aDependentData[i] ) ;

}

// Get the connection information for a particular parameter.  It returns an 

// array of strings with the full name of the expression operator or other 

// object that is reading the value of the in_Parameter argument

function FindDataDrivenByParameter( in_Parameter )

{

	var aConnections = [] ;

	// Connection information is managed at the Object level, not Parameter level

	var oObj = in_Parameter.Parent ;

	var oDR = XSIUtils.DataRepository ;

	opInfo = oDR.GetConnectionStackInfo( oObj )

	var oXMLParser = new ActiveXObject( "Microsoft.XMLDOM" ) 

	oXMLParser.async = false	

	oXMLParser.loadXML( opInfo ) ;

	var oTopNode = oXMLParser.documentElement ;

	var oConnections = oTopNode.childNodes ;

	for ( var i = 0 ; i < oConnections.length ; i++ )

	{

		var oConnection = oConnections(i) ;

		oObjNode = oConnection.selectSingleNode( "object" ) ;

		if ( oObjNode == null )

			continue ; // Not connected to anything

		// See if this is a connection to the parameter we are interested in

		oParameterNode = oConnection.selectSingleNode( "localparameter" ) ;

		if ( oParameterNode != null )

		{

			strConnectedParameter = oParameterNode.text ;

			if ( strConnectedParameter == in_Parameter.ScriptName )

			{				

				// Found a connection to this parameter 

				strType = oConnection.selectSingleNode( "type" ).text ;

				if ( strType == "out" )

				{

					aConnections[aConnections.length] =oObjNode.text

				}

				// Tip if the type was "in" then it means that the connection is controlling the

				// value of this parameter, e.g. a FCurve, expression, operator. This information

				// can also be retrieved with Parameter.Source

			}

		}	

	}	

	return aConnections ;

}

//Output of this example:

//INFO : light.kine.global.pos.posz.Expression

//INFO : light.kine.global.Expression