/*
	This example shows how to traverse a shader tree and list the
	available shader inputs and their input types.
*/
NewScene(null,false);
// Create an object with a texture shader
var root = Application.ActiveProject.ActiveScene.Root;
var model = root.AddModel();
model.name = "MyModel";
var object = model.AddGeometry( "Sphere", "MeshSurface" );
BlendInPresets( "Image", object, 1, false );
CreateProjection( object, siTxtSpherical, siTxtDefaultSpherical, "TxtSupport", "TxtProjection" );
var filename = Application.InstallationPath( siFactoryPath ) + 
	"\\Data\\XSI_SAMPLES\\Pictures\\xsilogo.jpg";
var imageclip = CreateImageClip( filename, "XSILogo" );
// Set up the texture space on texture shader
var mat = object.Material;
var textureshader = object.Material.CurrentTexture;
// Set the texturespace parameter
SetInstanceDataValue(null, textureshader+".tspace_id", "TxtProjection");
textureshader.parameters("tex").Connect(imageclip);
// Select the texture shader
SelectObj("MyModel.sphere.Material.Image");
// Get an object from the selection list
var obj = selection(0);
// Object is a shader
if ( obj.isclassof( siShaderID ) )
{
	// Get the material from shader
	var mat = obj.Root;
	traverse_shadernode(mat);
}
// Expected results:
// INFO : Sources.Materials.DefaultLib.Material.ambient_blend.base_color is free to be connected to a shader that will match input type siColorParameterType
// INFO : Sources.Materials.DefaultLib.Material.Image.repeats is free to be connected to a shader that will match input type siVectorParameterType
// INFO : Sources.Materials.DefaultLib.Material.Image.alt_x is free to be connected to a shader that will match input type siBooleanParameterType
// INFO : Sources.Materials.DefaultLib.Material.Image.alt_y is free to be connected to a shader that will match input type siBooleanParameterType
// INFO : Sources.Materials.DefaultLib.Material.Image.alt_z is free to be connected to a shader that will match input type siBooleanParameterType
// INFO : Sources.Materials.DefaultLib.Material.Image.min is free to be connected to a shader that will match input type siVectorParameterType
// INFO : Sources.Materials.DefaultLib.Material.Image.max is free to be connected to a shader that will match input type siVectorParameterType
// etc.
// Helper functions
function traverse_shadernode( shadernode )
{
	if ( ! shadernode ) { return; }
	if (! ( shadernode.isclassof( siShaderID ) ||
		 shadernode.isclassof( siMaterialID ) || 
		 shadernode.isclassof( siLightID ) || 
		 shadernode.isclassof( siCameraID )) ) 
		{ return; }
	// Traverse the occupied shader inputs
	var eParam = new Enumerator(shadernode.parameters);
	for ( ;!eParam.atEnd(); eParam.moveNext() )
	{
		var param = eParam.item();
		if (param.capabilities & siTexturable)
		{	
			var nextnode = param.source;
			// parameter connected to shader node
			if ( nextnode != null )
				traverse_shadernode( nextnode );
			else // parameter free
			{
				var inputtype = shadernode.GetShaderInputType(param.scriptname);
				LogMessage( param.fullname + " is free to be connected to a shader that will match input type " 
					+ ShaderParameterTypeAsText(inputtype));
			}
		}		
	}
}
function ShaderParameterTypeAsText(type)
{
	switch (type)
	{
		case siUnknownParameterType : return "siUnknownParameterType";			
		case siBooleanParameterType : return "siBooleanParameterType";			
		case siColorParameterType : return "siColorParameterType";			
		case siDataParameterType : return "siDataParameterType";			
		case siIntegerParameterType : return "siIntegerParameterType";			
		case siLensParameterType : return "siLensParameterType";			
		case siLightParameterType : return "siLightParameterType";			
		case siMaterialParameterType : return "siMaterialParameterType";			
		case siMatrixParameterType : return "siMatrixParameterType";			
		case siModelParameterType : return "siModelParameterType";			
		case siRealTimeParameterType : return "siRealTimeParameterType";			
		case siReferenceParameterType : return "siReferenceParameterType";			
		case siScalarParameterType : return "siScalarParameterType";			
		case siShaderParameterType : return "siShaderParameterType";			
		case siStringParameterType : return "siStringParameterType";			
		case siStructParameterType : return "siStructParameterType";			
		case siTextureParameterType : return "siTextureParameterType";			
		case siTextureSpaceParameterType : return "siTextureSpaceParameterType";			
		case siVectorParameterType : return "siVectorParameterType";			
		default: return type;
	}
}