/*
	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